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
| Category | Available tools |
|---|---|
| Messaging | Send SMS, WhatsApp, and RCS · Get message status · List message activity |
| Contacts | List, get, create, delete contacts · Message summary per contact |
| Templates | List, get, and delete templates · Look up by name |
| Lookup & Analytics | Phone number lookup · Messages sent · Deliverability · Contact stats |
| Account | Get 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/mcpThat'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:
- Your agent opens a browser tab to
app.sent.dm/mcp-authorization - You log in with your Sent account and select the organization and sender profile to grant access to
- 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 supportsShow me deliverability stats for the last 7 daysThe agent selects the right tool, constructs the call, and shows you the result inline.
Available tools reference
Messaging
| Tool | Description |
|---|---|
messages.send | Send a message via SMS, WhatsApp, or RCS |
messages.get | Retrieve a single message by ID |
messages.activities.list | Get the full lifecycle timeline for a message |
Contacts
| Tool | Description |
|---|---|
contacts.list | List contacts in your account |
contacts.get | Get a single contact by ID |
contacts.create_many | Bulk-create contacts |
contacts.delete | Delete a contact |
contacts.message_summary | Get messaging history summary for a contact |
Templates
| Tool | Description |
|---|---|
templates.list | List all templates |
templates.get | Get a template by ID |
templates.get_by_name | Get a template by name |
templates.delete | Delete a template |
Lookup & Analytics
| Tool | Description |
|---|---|
numbers.lookup | Look up a phone number (channel support, validity) |
dashboard.messages_sent | Messages sent over a time range |
dashboard.deliverability | Delivery rate stats |
dashboard.contacts | Contact growth and activity stats |
Account
| Tool | Description |
|---|---|
account.get | Get account details |
balance.get | Check current balance |
onboarding.status | Check 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.
Related
Docs for LLMs & AI Agents
Plain-text documentation files for loading Sent API context into any AI agent
Sending Messages
REST API guide for sending SMS, WhatsApp, and RCS programmatically
Working with Templates
Create and manage message templates used by the MCP send tool