Send email, look up public IP information, and convert files to Markdown through SendSoon.
SendSoon AI MCP (io.github.sendsoon/ai)
SendSoon AI MCP is a Model Context Protocol (MCP) server that enables Codex and Claude to use SendSoon capabilities. It supports sending email, looking up public IP information, and converting local documents to Markdown through SendSoon. Configuration is done once, and tasks can be described in natural language.
🛠️ Key Features
Send email via send_email
Look up public IP information
Convert local documents to Markdown through SendSoon
MCP server: io.github.sendsoon/ai
🚀 Use Cases
“Send me a test email”
Retrieve public IP information
Convert local documents to Markdown
⚡ Developer Benefits
Exposes SendSoon functions as MCP tools for Codex and Claude
Natural-language task descriptions after one-time configuration
⚠️ Limitations
Server supports only the functions described in its capabilities: email, public IP lookup, and Markdown conversion
SendSoon MCP is a Model Context Protocol (MCP) server that lets Codex, Claude, and WorkBuddy use SendSoon capabilities: send email, look up public IPs, and convert local documents to Markdown.
Configure it once, then describe tasks in natural language. You usually do not need to mention SendSoon in every prompt.
What you can do
Tool
Purpose
Example
send_email
Send a single email
“Send me a test email”
ip_lookup
Look up public IP information
“Look up the location of 8.8.8.8”
markitdown_convert
Convert a local document to Markdown
“Convert this PDF to Markdown”
Everyday examples
text
Send an email to user@example.com with the subject “Meeting reminder” and the body “The meeting starts at 3 PM today.”
text
Look up the location and ISP for 8.8.8.8.
text
Convert /path/to/report.pdf to Markdown and summarize the key points.
If the agent does not select a tool automatically, say:
text
Use the sendsoon MCP to complete this task.
Install in your AI client
The instructions below cover Codex, Claude Desktop, and WorkBuddy.
Codex
Config file: user-level ~/.codex/config.toml (macOS / Linux) or %USERPROFILE%\.codex\config.toml (Windows).
Verify: Save the file, restart Codex, and run /mcp in a chat. You should see sendsoon connected. In the desktop app, also check Settings > MCP servers.
First use: Start a new conversation and ask for a simple task (e.g. “Look up 8.8.8.8”). Approve the tool if Codex asks for permission.
Verify: Save the file, fully quit Claude Desktop (including the system tray), then relaunch. Start a new chat and confirm sendsoon tools appear in the tools menu or settings.
First use: Claude may ask to approve tool access on the first invocation; allow it to continue.
WorkBuddy
WorkBuddy can add SendSoon by pasting the connector JSON directly in MCP Server Management.
Config file:%USERPROFILE%\.workbuddy-ai\mcp.json (Windows) or ~/.workbuddy-ai/mcp.json (macOS / Linux).
Open WorkBuddy and go to MCP Server Management.
Click Add MCP.
Paste the JSON below into the editor. Fill in SENDSOON_API_KEY if you have a Key; leave it empty for the anonymous trial.
WorkBuddy MCP Server Management with the SendSoon connector JSON
The screenshot shows the WorkBuddy connector editor: the configuration file path is at the top, and the sendsoon JSON is pasted into the editor. After saving, return to the MCP list and confirm sendsoon is connected.
Verify: Start a new conversation and ask for a simple task (e.g. “Look up 8.8.8.8”). Approve the tool if WorkBuddy asks for permission.
Prepare the configuration
Optional environment variable:
Setting
Required
What to enter
SENDSOON_API_KEY
No
Leave empty for an unregistered trial. One public IP can send up to three free test emails per day. Enter your generated Key for continued use
Never commit a real Key to Git or share it with anyone.
Open Profile and generate a Key in the API Key section.
Copy the one-time ssk_live_... Key immediately and enter it as SENDSOON_API_KEY in your MCP configuration.
Save the configuration and restart your MCP client. Requests with a valid Key do not use the anonymous IP daily quota.
If the anonymous quota is exhausted, send_email will tell you to register and configure a Key. An invalid or revoked Key is rejected and does not fall back to the anonymous quota.
Try it in Google Colab
Skip local setup and try ip_lookup, markitdown_convert, and send_email in the browser.
The notebook calls the same SendSoon HTTP APIs used by these MCP tools.
Visual local testing (MCP Inspector)
To see all three tools in a browser and click through them manually before installing into an AI client, use the MCP Inspector.
Requires Node.js 20+. Run the command below in a terminal; Inspector opens a web UI automatically: