Sent MCP Server

The Sent MCP server exposes every messaging primitive — send, lookup, contacts, templates, and analytics — directly inside your AI coding agent. No API keys to paste, no context-switching to another tab. Your agent can send a real SMS, look up a contact, or check deliverability without leaving your editor.

The MCP server is available at mcp.sent.dm. It implements the Model Context Protocol over HTTP with OAuth 2.1 authentication.

What you can do

CategoryAvailable tools
MessagingSend SMS, WhatsApp, and RCS · Get message status · List message activity
ContactsList, get, create, delete contacts · Message summary per contact
TemplatesList, get, and delete templates · Look up by name
Lookup & AnalyticsPhone number lookup · Messages sent · Deliverability · Contact stats
AccountGet account info · Check balance · Onboarding status

18 tools in total, mirroring the full Sent REST API.


Setup

Add the MCP server to your agent

Pick your agent below and follow the one-time setup.

Run this command in your terminal:

claude mcp add --transport http sent https://mcp.sent.dm/mcp

That's it. Claude Code registers the server and handles authentication on first use.

Open or create ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add the sent entry:

{
  "mcpServers": {
    "sent": {
      "type": "http",
      "url": "https://mcp.sent.dm/mcp"
    }
  }
}

On Windows the config file is at %APPDATA%\Claude\claude_desktop_config.json.

Restart Claude Desktop after saving.

Open or create ~/.cursor/mcp.json and add:

{
  "mcpServers": {
    "sent": {
      "url": "https://mcp.sent.dm/mcp"
    }
  }
}

Restart Cursor after saving. The server will appear under Settings → MCP.

Add a .vscode/mcp.json file at the root of your project (or your user settings):

{
  "servers": {
    "sent": {
      "type": "http",
      "url": "https://mcp.sent.dm/mcp"
    }
  }
}

VS Code Copilot will pick up the server automatically on next activation.

Authenticate

The first time your agent calls a Sent tool, it will trigger an OAuth 2.1 authorization flow:

  1. Your agent opens a browser tab to app.sent.dm/mcp-authorization
  2. You log in with your Sent account and select the organization and sender profile to grant access to
  3. An access token is issued and stored by the agent — no copy-pasting required

The token has no expiry. To revoke access, go to Dashboard → Settings → MCP Connections and deactivate it from there.

Use it

Ask your agent anything that involves messaging:

Send a WhatsApp message to +1234567890 using the order_confirmation template
with customerName="Alex" and orderNumber="#9981"
Look up the phone number +447911123456 and tell me what channel it supports
Show me deliverability stats for the last 7 days

The agent selects the right tool, constructs the call, and shows you the result inline.


Available tools reference

Messaging

ToolDescription
messages.sendSend a message via SMS, WhatsApp, or RCS
messages.getRetrieve a single message by ID
messages.activities.listGet the full lifecycle timeline for a message

Contacts

ToolDescription
contacts.listList contacts in your account
contacts.getGet a single contact by ID
contacts.create_manyBulk-create contacts
contacts.deleteDelete a contact
contacts.message_summaryGet messaging history summary for a contact

Templates

ToolDescription
templates.listList all templates
templates.getGet a template by ID
templates.get_by_nameGet a template by name
templates.deleteDelete a template

Lookup & Analytics

ToolDescription
numbers.lookupLook up a phone number (channel support, validity)
dashboard.messages_sentMessages sent over a time range
dashboard.deliverabilityDelivery rate stats
dashboard.contactsContact growth and activity stats

Account

ToolDescription
account.getGet account details
balance.getCheck current balance
onboarding.statusCheck onboarding and KYC status

Authentication details

The Sent MCP server uses OAuth 2.1 with PKCE (RFC 7636) and Dynamic Client Registration (RFC 7591). Your agent registers itself automatically — no manual client ID setup required.

  • Token expiry: None. Tokens are long-lived.
  • Revocation: Dashboard → Settings → MCP Connections → Deactivate.
  • Scope: Tied to a specific organization and sender profile chosen during authorization. To grant access to a different profile, re-authorize.


On this page