MCP Server

tinysend MCP Server

Let your AI agent send email directly — without writing API calls. Claude Code, Cursor, Windsurf, and any MCP-compatible client can use tinysend as a tool.

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI agents call external tools and services directly. Instead of your agent generating an API call that your code must execute, the agent calls the tool itself — including sending email.

tinysend ships an MCP server. Add it to your AI client config, and your agent gains a send_email tool it can call natively — with full visibility into what it's sending.

Installation

1. Install the package

npx @tinysend/mcp

Or install globally: npm install -g @tinysend/mcp

2. Add to your MCP client config

For Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "tinysend": {
      "command": "npx",
      "args": ["-y", "@tinysend/mcp"],
      "env": {
        "TINYSEND_API_KEY": "ts_live_xxxxxxxxxxxx",
        "TINYSEND_FROM": "[email protected]"
      }
    }
  }
}

For Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "tinysend": {
      "command": "npx",
      "args": ["-y", "@tinysend/mcp"],
      "env": {
        "TINYSEND_API_KEY": "ts_live_xxxxxxxxxxxx",
        "TINYSEND_FROM": "[email protected]"
      }
    }
  }
}

3. Get your API key

Create a free account and generate an API key at tinysend.co/api-keys. The TINYSEND_FROM address must be from an authenticated domain.

Available tools

Once configured, your AI agent has access to these tools:

send_emailcore

Send a transactional email to one or more recipients.

to: string | string[] — recipient(s)

subject: string — email subject

body: string — HTML or plain text content

from?: string — override default sender

idempotency_key?: string — prevent duplicates

enroll_sequencesequences

Enroll a contact in a drip email sequence (e.g. onboarding flow).

email: string — contact email

sequence_id: string — sequence to enroll in

vars?: object — template variable overrides

check_deliveryobservability

Check delivery status of a previously sent email by message ID.

message_id: string — ID returned by send_email

Example agent usage

Once the MCP server is connected, you can ask your AI agent to send emails naturally:

User prompt:

"Send a welcome email to [email protected] — introduce tinysend and include the getting started link."

Agent calls send_email:

{
  "to": "[email protected]",
  "subject": "Welcome to tinysend",
  "body": "<p>Hi Alice, welcome to tinysend! ...</p>",
  "idempotency_key": "welcome-alice-2026-03-31"
}

Bring Your Own Keys (BYOK)

tinysend supports BYOK delivery — use your own AWS SES, SendGrid, or Mailgun credentials as the sending provider, while tinysend handles the API surface, sequencing, and analytics. Your keys stay in your account and never pass through tinysend's servers.

Configure providers under Settings → Providers.

Give your agent email superpowers

Free plan, no credit card. Up and running in 5 minutes.

Start for free