Metadata-Version: 2.4
Name: mcs-driver-mailsend
Version: 0.1.0
Summary: Mail-sending driver for the Model Context Standard -- lets an LLM send e-mail.
Author-email: Danny Gerst <danny@dannygerst.de>
License-Expression: Apache-2.0
Project-URL: Homepage, https://www.modelcontextstandard.io
Project-URL: Source, https://github.com/modelcontextstandard/python-sdk
Keywords: mcs,modelcontextstandard,driver,mail,email,smtp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcs-driver-core>=0.2
Provides-Extra: smtp
Requires-Dist: mcs-adapter-smtp>=0.1; extra == "smtp"
Provides-Extra: inspector
Requires-Dist: mcs-inspector>=0.1; extra == "inspector"
Dynamic: license-file

# mcs-driver-mailsend

Mail-sending driver for the **Model Context Standard (MCS)**.

Provides tools for sending plain-text and HTML e-mail. The actual I/O is
delegated to a pluggable adapter, making the same driver work with SMTP,
Gmail API, Microsoft Graph, or any future backend.

## Installation

```bash
pip install mcs-driver-mailsend

# With SMTP adapter
pip install mcs-driver-mailsend[smtp]
```

## Quick start

```python
from mcs.driver.mailsend import MailsendToolDriver

# SMTP (default adapter)
td = MailsendToolDriver(
    adapter="smtp",
    host="smtp.example.com",
    user="alice@example.com",
    password="...",
    sender_name="Alice Smith",  # optional display name
)

tools = td.list_tools()       # 2 tools
result = td.execute_tool("send_message", {
    "to": "bob@example.com",
    "subject": "Hello",
    "body": "Hi Bob!",
})
```

## Tools

| Tool                | Description                                      |
|---------------------|--------------------------------------------------|
| `send_message`      | Send a plain-text e-mail                         |
| `send_html_message` | Send an HTML e-mail with optional text fallback  |

## Adapter protocol

The driver defines a `MailsendPort` typing protocol. Any object that implements
`send_message` and `send_html_message` satisfies the contract -- no inheritance
required.

## Links

- **Homepage:** <https://www.modelcontextstandard.io>
- **Source:** <https://github.com/modelcontextstandard/python-sdk>

## License

Apache-2.0
