Metadata-Version: 2.4
Name: mailagent-agent
Version: 0.1.0
Summary: Python SDK for MailAgent agent verify API
Author: MailAgent
License: MIT
Project-URL: Homepage, https://webmailagent.com/docs/agents.html
Project-URL: Repository, https://github.com/Alex0nder/MailAgent
Keywords: mailagent,agents,email,verification,otp
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# mailagent-agent (Python)

Minimal Python SDK for [MailAgent](https://webmailagent.com) agent verify flows — parity with `@mailagent/agent` core methods.

```bash
pip install mailagent-agent
```

```python
from mailagent import MailAgent

client = MailAgent("https://api.webmailagent.com", "ma_…")
result = client.verify_signup(service="github", timeout_seconds=90, delete_after=True)
print(result.get("agent", {}).get("primaryAction"))
```

## Methods

- `verify_signup(**options)` — `POST /v1/agent/verify`
- `get_profile()` — `GET /v1/me`
- `create_inbox(**options)` / `delete_inbox(id)`
- `list_messages(inbox_id, subject_contains=…)`
- `simulate_message(inbox_id, scenario="otp", …)`
- `diagnose_inbox(inbox_id, …)`
- `list_runs(run_id=…, label=…)`

Source: `packages/mailagent-agent-py` in [MailAgent](https://github.com/Alex0nder/MailAgent).
