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.

Project links

Data verified by PyPI on Aug 22, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for charleszhou from gravatar.com charleszhou

Credits

Author: SendSoon

GitHub Statistics

Data verified by PyPI on Aug 22, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

dev

Tags

claude codex cursor email ip-lookup markitdown mcp mcp-server model-context-protocol sendsoon

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sendsoon_mcp-0.1.0.tar.gz (12.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sendsoon_mcp-0.1.0-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

Details for the file sendsoon_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: sendsoon_mcp-0.1.0.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

Hashes for sendsoon_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 067575de82b28ad2b3f7d71b7926f7a4c08eef0c035929898d0729e49f7d5c70
MD5 cf6c91dab81ecaaf5a9b7132e48e3464
BLAKE2b-256 7c4e44c25e551f9ca10bace41c0ee253a51efebf0242774a83aa86367429e2d7

See more details on using hashes here.

Provenance

The following attestation bundles were made for sendsoon_mcp-0.1.0.tar.gz:

Publisher: publish-pypi.yml on sendsoon/ai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sendsoon_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: sendsoon_mcp-0.1.0-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

Hashes for sendsoon_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8c4f60eef095f6bca54d379b7d02b5d4cf505c18da03fd3e54fccd59b9c22f22
MD5 7560bc91bb8fc94cd36da78987ba0045
BLAKE2b-256 4af7c2ddfd5c3ea7d55b81525bc73cb2bfeb8c6e29bdc39d408809548d8c1402

See more details on using hashes here.

Provenance

The following attestation bundles were made for sendsoon_mcp-0.1.0-py3-none-any.whl:

Publisher: publish-pypi.yml on sendsoon/ai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.2

2 files

This release

0.1.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page