Metadata-Version: 2.4
Name: gork-sdk
Version: 1.0.0
Summary: Official Python SDK for gork.email programmable email infrastructure for AI agents
Author: gork.email
License: MIT
Project-URL: Homepage, https://gork.email
Project-URL: Documentation, https://gork.email/docs
Project-URL: Repository, https://github.com/shyamcxy/gork-sdk
Keywords: email,agent,ai,mcp,inbox,mail
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# gork-sdk — Python SDK for gork.email

Programmable email infrastructure for AI agents. Provision inboxes, send and receive mail, manage threads, webhooks, domains, keys, and suppressions.

## Install

```bash
pip install gork-sdk
```

## Quickstart

```python
from gork import GorkClient

gork = GorkClient()  # reads GORK_KEY / GORK_API_KEY

inbox = gork.create_inbox(username="sdr-alex", name="SDR Alex")
print(inbox["address"])  # sdr-alex@gork.email

gork.send_message(
    inbox_id=inbox["id"],
    to=["prospect@acme.com"],
    subject="Quick intro",
    text="Hi — wanted to share what we're building.",
    idempotency_key="outreach-001",  # safe retries
)
```

## Webhook verification

```python
from gork import verify_signature

ok = verify_signature(raw_body, request.headers["X-Gork-Signature"], webhook_secret)
```

## Links

- Docs: https://gork.email/docs
- API reference: https://api.gork.email/openapi.json
- Changelog: https://gork.email/changelog
