sendsoon-mcp
MCP server for SendSoon. Gives Claude, Cursor, Codex, and other MCP clients the ability to send email, look up public IP information, and convert files to Markdown.
PyPI: sendsoon-mcp
Server name: sendsoon
Transport: stdio
Tools: send_email, ip_lookup, markitdown_convert
Python package version is managed independently from the Node package @sendsoon/ai. Tool names and request/response semantics stay aligned.
Install
Recommended (no global install):
uvx sendsoon-mcp
Or install the CLI:
pip install sendsoon-mcp
sendsoon-mcp
Requirements: Python 3.10+, and a client that supports local stdio MCP servers.
Configuration
| Variable | Required | Description |
|---|---|---|
SENDSOON_EMAIL_RECIPIENT |
Yes | The only recipient address allowed for send_email. The to parameter must match this value exactly (case-insensitive). |
SENDSOON_API_KEY |
No | Leave empty for anonymous trial: one public IP may send up to 3 test emails per day. After that, register at sendsoonai.com, generate a ssk_live_... Key at Profile, and set it here. |
SENDSOON_API_BASE_URL |
No | Defaults to https://www.sendsoonai.com. HTTPS required except http://localhost. |
Never commit a real Key to Git or share it with anyone.
Invalid or revoked Keys are rejected and do not fall back to the anonymous quota.
Client configuration
Cursor / Claude Desktop
{
"mcpServers": {
"sendsoon": {
"command": "uvx",
"args": ["sendsoon-mcp"],
"env": {
"SENDSOON_EMAIL_RECIPIENT": "<YOUR_EMAIL>",
"SENDSOON_API_KEY": ""
}
}
}
}
After pip install sendsoon-mcp, you can use "command": "sendsoon-mcp" with an empty args array (or omit args).
Codex
[mcp_servers.sendsoon]
command = "uvx"
args = ["sendsoon-mcp"]
[mcp_servers.sendsoon.env]
SENDSOON_EMAIL_RECIPIENT = "<YOUR_EMAIL>"
SENDSOON_API_KEY = ""
Claude Code
claude mcp add --transport stdio --scope user --env SENDSOON_EMAIL_RECIPIENT=<YOUR_EMAIL> sendsoon -- uvx sendsoon-mcp
Tools
| Tool | Input highlights | Notes |
|---|---|---|
send_email |
to, subject, body, optional content_type, idempotency_key |
Recipient must match SENDSOON_EMAIL_RECIPIENT |
ip_lookup |
ip |
Public IPv4/IPv6 only |
markitdown_convert |
filename, content_base64 |
Remote SendSoon conversion (max 10 MB decoded); same semantics as the Node MCP |
Development
cd python
python -m pip install -e ".[dev]"
pytest
ruff check src tests
mypy
License
MIT — see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sendsoon_mcp-0.1.2.tar.gz.
File metadata
- Download URL: sendsoon_mcp-0.1.2.tar.gz
- Upload date:
- Size: 12.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20e3c14f3805521da659e4fc1d6922122361902ae17da1385e73ed3987758dd2
|
|
| MD5 |
11308fc6bf6eca6f21a5a9e047e93bcf
|
|
| BLAKE2b-256 |
e4de657235c55d68e66fefc17bf911e31898a77ad4e10ddacec6da141cdb6fc1
|
Provenance
The following attestation bundles were made for sendsoon_mcp-0.1.2.tar.gz:
Publisher:
publish-pypi.yml on sendsoon/ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sendsoon_mcp-0.1.2.tar.gz -
Subject digest:
20e3c14f3805521da659e4fc1d6922122361902ae17da1385e73ed3987758dd2 - Sigstore transparency entry: 2560568882
- Sigstore integration time:
-
Permalink:
sendsoon/ai@d52ca1cbdcc8c894cf666a6e89cb958e4576bcba -
Branch / Tag:
refs/tags/python-v0.1.2 - Owner: https://github.com/sendsoon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@d52ca1cbdcc8c894cf666a6e89cb958e4576bcba -
Trigger Event:
push
-
Statement type:
File details
Details for the file sendsoon_mcp-0.1.2-py3-none-any.whl.
File metadata
- Download URL: sendsoon_mcp-0.1.2-py3-none-any.whl
- Upload date:
- Size: 14.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ef5cbb1a6a9a85350dc4e9791faa2ac617380838e461a16c45a5a17ab9b0d38e
|
|
| MD5 |
efd7f4d29c39ec8da8febb6cd083b89d
|
|
| BLAKE2b-256 |
88078db580a8eb2d12c41880a0db56e3a51e06399de28e800589187a2a44c183
|
Provenance
The following attestation bundles were made for sendsoon_mcp-0.1.2-py3-none-any.whl:
Publisher:
publish-pypi.yml on sendsoon/ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sendsoon_mcp-0.1.2-py3-none-any.whl -
Subject digest:
ef5cbb1a6a9a85350dc4e9791faa2ac617380838e461a16c45a5a17ab9b0d38e - Sigstore transparency entry: 2560569052
- Sigstore integration time:
-
Permalink:
sendsoon/ai@d52ca1cbdcc8c894cf666a6e89cb958e4576bcba -
Branch / Tag:
refs/tags/python-v0.1.2 - Owner: https://github.com/sendsoon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@d52ca1cbdcc8c894cf666a6e89cb958e4576bcba -
Trigger Event:
push
-
Statement type:
