Ai

io.github.sendsoonPublished by GitHub account sendsoonv0.1.2Updated Oct 25, 2026

Send email, look up public IP information, and convert files to Markdown through SendSoon.

VerifiedSTDIODesktop onlyLocation & LifestyleFiles & StorageCommunication & Collaboration

Overview

AI-generated overview

SendSoon MCP server that lets an assistant send email, look up public IP details, and convert local documents to Markdown.

What you can do
Send a single email with a subject and body to a recipient address through SendSoon's API. Look up public IP information such as location and ISP for an address. Convert a local document, for example a PDF, to Markdown for summarization or reuse.
When to use it
Useful when you want an assistant to fire off a quick email, check where a public IP is registered, or turn a local PDF or document into Markdown without leaving the chat. It is a small utility server rather than a full email or document platform.
Requirements
Runs locally via npx, so Node.js is needed (Node.js 20+ for the MCP Inspector test flow). SENDSOON_EMAIL_RECIPIENT is required for test sends. SENDSOON_API_KEY is optional: without it you get an anonymous trial of three sends per public IP per day; a registered key removes that quota. SENDSOON_API_BASE_URL can override the default endpoint. Network access to the SendSoon service is required.
Before you install
Email sending is an outward action: messages go to real recipients and cannot be recalled. The API key (SENDSOON_API_KEY, an ssk_live_... key) is a secret; the README warns not to commit it to Git or share it. Document conversion and IP lookups send content and queries to SendSoon's servers, a third party. The anonymous trial is capped per public IP, and an invalid or revoked key is rejected rather than falling back to the trial.

Installation

In SourceWeft

  1. Open Ai in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

SendSoon AI MCP

English | 简体中文 | 日本語

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

ToolPurposeExample
send_emailSend a single email“Send me a test email”
ip_lookupLook up public IP information“Look up the location of 8.8.8.8”
markitdown_convertConvert a local document to Markdown“Convert this PDF to Markdown”

Everyday examples

text
Send an email to [email protected] 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).

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

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.

Claude Desktop

Config file:

OSPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

You can also open Settings > Developer > Edit Config inside Claude Desktop.

json
{  "mcpServers": {    "sendsoon": {      "command": "npx",      "args": ["-y", "@sendsoon/mcp"],      "env": {        "SENDSOON_API_KEY": ""      }    }  }}

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).

  1. Open WorkBuddy and go to MCP Server Management.
  2. Click Add MCP.
  3. Paste the JSON below into the editor. Fill in SENDSOON_API_KEY if you have a Key; leave it empty for the anonymous trial.
  4. Click Save.
json
{  "mcpServers": {    "sendsoon": {      "command": "npx",      "args": [        "-y",        "@sendsoon/mcp"      ],      "env": {        "SENDSOON_API_KEY": ""      }    }  }}

[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:

SettingRequiredWhat to enter
SENDSOON_API_KEYNoLeave 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.

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.

Try it in Google Colab

Skip local setup and try ip_lookup, markitdown_convert, and send_email in the browser.

[Open in Colab]

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:

bash
npx @modelcontextprotocol/inspector npx -y @sendsoon/mcp

How to test

  1. Wait for MCP Inspector Web is up and running in the terminal. If the browser does not open, paste the http://127.0.0.1:6274?... URL from the terminal.
  2. Confirm the page header shows Connected.
  3. Open the Tools tab in the top-right area of the page.
  4. Select a tool from the list on the left, fill in the parameters, and click Execute Tool.
  5. Read the response in the Results panel on the right. On failure, inspect error.code and error.message.

License

See LICENSE.

Source: README.md at commit e8b2d06

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts