Metadata-Version: 2.4
Name: volanea
Version: 0.1.0
Summary: Python client for the Volanea Email API - agentic inboxes for AI agents
Author: Volanea Team
License: MIT
Project-URL: Homepage, https://volanea.com
Project-URL: Documentation, https://volanea.com
Keywords: email,api,ai-agents,inboxes,mcp
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications :: Email
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# volanea

Official Python client for the [Volanea](https://volanea.com) Email API — agentic inboxes for AI agents.

Volanea gives every AI agent its own real email inbox, plus a full API to send, receive, parse and verify email programmatically.

## Install

```bash
pip install volanea
```

## Quick start

```python
from volanea import VolaneaClient

client = VolaneaClient(base_url="https://api.volanea.com", api_key="YOUR_API_KEY")

# list inbound messages for a mailbox
messages = client.list_inbound(to="agent@yourdomain.com", limit=20)

# fetch one parsed email
email = client.get_email(messages[0]["emailId"])
print(email["subject"], email["body"][:200])
```

## Features

- **Agentic inboxes** — isolated mailboxes for every agent or workflow
- **Inbound API** — list and fetch parsed emails
- **Zero dependencies** — stdlib only (urllib)
- **Webhooks + MCP** — expose email operations to Claude and other MCP clients

## Links

- [Volanea homepage](https://volanea.com)
- [Docs](https://volanea.com)

## License

MIT
