Metadata-Version: 2.4
Name: mailrith-sdk
Version: 0.2.0
Summary: Official Python SDK for Mailrith's public API.
Author: Mailrith
License-Expression: MIT
Project-URL: Documentation, https://mailrith.com/developers/sdks
Project-URL: Homepage, https://mailrith.com
Project-URL: Issues, https://github.com/anrawool/mailrith-agent-platform/issues
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Mailrith Python SDK

Official Python SDK for Mailrith's public API.

This package is generated from Mailrith's versioned OpenAPI-derived SDK manifest and provides
resource namespaces such as `client.subscribers.list()` and `client.broadcasts.send()`.

```py
from mailrith_sdk import MailrithClient

client = MailrithClient(api_key="mrk_example_secret_key")

capabilities = client.discovery.get_capabilities()
subscribers = client.subscribers.list(query={"limit": 25})
```

Agents can discover a bounded set of operations from ordinary task language,
then load the exact generated descriptor before acting:

```py
result = client.search_operations("add the VIP tag to this subscriber", limit=3)
operation_id = result["selection"]["recommended_operation_id"]
operation = client.get_operation(operation_id)
```

Search reads the packaged operation catalog in memory, returns at most 25
matches, and does not send or store the query.

Python uses the same generated resource aliases, action vocabulary,
relationship intents, plural handling, ranking, and ambiguity rules as the
TypeScript SDK, MCP server, and CLI. Narrow a search with `resource` or with
`category="read"`, `"write"`, `"delete"`, or `"live"`.
