SendSoon AI MCP

English | 简体中文 | 日本語

Use SendSoon email, IP lookup, and file-to-Markdown capabilities from Codex, Claude, Cursor, and other AI agents.

Configure it once, then describe tasks in natural language. You usually do not need to mention SendSoon in every prompt.

What you can do

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. To use them from Cursor, Claude, or Codex, continue with the local MCP setup below.

Install MCP

Choose npm (Node) or PyPI (Python). Tool names and environment variables are the same.

npm (Node)

Published as @sendsoon/mcp. Clients can start it with npx (downloads on first use):

npx -y @sendsoon/mcp

Optional global install:

npm install -g @sendsoon/mcp
sendsoon-mcp

Requires Node.js 20+.

Migration from @sendsoon/ai

The GitHub repository was renamed to sendsoon/mcp, and the npm package is now @sendsoon/mcp (from 0.2.0).

Update your MCP client config:

Tool names, environment variables, and the runtime server name sendsoon are unchanged. @sendsoon/ai is no longer published; pin or migrate clients to @sendsoon/mcp.

PyPI (Python)

Published as sendsoon-mcp. Prefer uvx so no global install is needed:

uvx sendsoon-mcp

Or:

pip install sendsoon-mcp
sendsoon-mcp

Requires Python 3.10+. See python/README.md for details.

Prepare the configuration

All clients use the same environment variables:

Never commit a real Key to Git or share it with anyone.

Get an API Key

1. Sign up or sign in on the SendSoon registration page.
2. Open Profile and generate a Key in the API Key section.
3. Copy the one-time ssk_live_... Key immediately and enter it as SENDSOON_API_KEY in your MCP configuration.
4. 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.

Choose your client

Cursor

Open Settings > Tools & MCP in Cursor and add an MCP server. You can also save the following configuration as .cursor/mcp.json in your project or ~/.cursor/mcp.json in your user directory.

Node (npm):

{
  "mcpServers": {
    "sendsoon": {
      "command": "npx",
      "args": ["-y", "@sendsoon/mcp"],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<YOUR_EMAIL>",
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

Python (PyPI):

{
  "mcpServers": {
    "sendsoon": {
      "command": "uvx",
      "args": ["sendsoon-mcp"],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<YOUR_EMAIL>",
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

Use only one top-level mcpServers object. Save the file, reopen Cursor, and confirm that sendsoon is enabled.

Codex

Open the user configuration file at ~/.codex/config.toml and add:

[mcp_servers.sendsoon]
command = "npx"
args = ["-y", "@sendsoon/mcp"]

[mcp_servers.sendsoon.env]
SENDSOON_EMAIL_RECIPIENT = "<YOUR_EMAIL>"
SENDSOON_API_KEY = ""

Save the file and reopen Codex. Use /mcp to confirm that sendsoon is connected. In the desktop app, you can also check Settings > MCP servers.

Claude Code

Replace the placeholder and run:

claude mcp add --transport stdio --scope user --env SENDSOON_EMAIL_RECIPIENT=<YOUR_EMAIL> sendsoon -- npx -y @sendsoon/mcp

Run /mcp in Claude Code and confirm that sendsoon is connected. To use an API Key, add --env SENDSOON_API_KEY=<SENDSOON_API_KEY> before the sendsoon server name.

Claude Desktop

Open the configuration file from Settings > Developer and add:

{
  "mcpServers": {
    "sendsoon": {
      "command": "npx",
      "args": ["-y", "@sendsoon/mcp"],
      "env": {
        "SENDSOON_EMAIL_RECIPIENT": "<YOUR_EMAIL>",
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

Save the file, fully quit and restart Claude Desktop, and confirm that sendsoon appears in the tool list.

Other MCP clients

For Windsurf, Cline, Continue, or another client that supports local stdio MCP servers, enter:

Confirm that it works

Restart the client, open a new conversation, and enter:

Look up the location and ISP for 8.8.8.8.

The MCP connection works if the agent calls ip_lookup and returns the result.

To test email, enter:

Send a test email to <YOUR_EMAIL> with the subject “SendSoon MCP test” and the body “Configuration successful.”

The address must exactly match SENDSOON_EMAIL_RECIPIENT. Your client may ask for permission the first time a tool runs; approve it to continue.

Everyday examples

Look up information about 1.1.1.1.

Convert <YOUR_FILE_PATH> to Markdown and summarize the key points.

Send an email to <YOUR_EMAIL> with the subject “Meeting reminder” and the body “The meeting starts at 3 PM today.”

If the agent does not select a tool automatically, say:

Use the sendsoon MCP to complete this task.

You usually need this explicit instruction only on the first use.

Install Agent Skills

Agent Skills teach the agent when to call each MCP tool and how to handle error codes. Install the MCP server first, then add skills.

Claude Code (plugin marketplace)

/plugin marketplace add sendsoon/mcp
/plugin install sendsoon-skills@sendsoon

Cursor / Claude (copy skills)

Copy any folder under skills/ into your agent skills directory:

Available skills: email-basics, ip-lookup, markitdown.

License

See LICENSE.