MCP Server

SendSeven provides an MCP (Model Context Protocol) server that lets AI assistants interact with your messaging platform directly. Use it with Claude Desktop, Claude Code, Cursor, or any MCP-compatible client.

What is MCP?

The Model Context Protocol is an open standard for connecting AI assistants to external tools and data sources. SendSeven's MCP server exposes your messaging platform as a set of tools that AI assistants can use to:

• Send and receive messages across all channels
• Send approved WhatsApp templates (outside the 24h window)
• View and manage conversations (reply, close, reopen, snooze, assign)
• Add internal notes and email conversation transcripts
• Search your knowledge base
• Create and send campaigns
• Manage contacts and tags
• Monitor analytics
• Manage webhook endpoints (developer)

Quick Start

Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "sendseven": {
      "url": "https://mcp.sendseven.com/mcp"
    }
  }
}

When you first use the server, you'll be guided through OAuth login and capability selection automatically.

Claude Code

claude mcp add sendseven --transport streamable-http https://mcp.sendseven.com/mcp

Cursor

Add to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "sendseven": {
      "url": "https://mcp.sendseven.com/mcp"
    }
  }
}

Authentication

The MCP server uses OAuth 2.0 with automatic token refresh. When you connect for the first time:

1. You'll see a capability picker where you choose which tools to enable
2. You'll be redirected to SendSeven to sign in and authorize the connection
3. Once authorized, you'll see a confirmation screen and be redirected back to your AI client

No manual API token configuration is needed -- the OAuth flow handles everything.

Capability Selection

During the initial connection, you choose which capabilities to enable. Only the permissions required for your selected capabilities are requested:

Capability	What it enables	Enabled by default
Conversations	View, reply to, snooze, close, reopen, and assign conversations; internal notes; email transcripts	Yes
Messaging	Send messages and WhatsApp templates via WhatsApp, Telegram, SMS, Messenger, Instagram	Yes
Email	Send emails with subject, HTML body, CC/BCC, and mailbox selection	Yes
Contacts	Search, create, update, and manage contacts and tags	Yes
Campaigns	Create, send, and monitor messaging and email campaigns	No
Knowledge Base	AI-powered search across your content	No
Analytics	Dashboard metrics and bot performance	No
Webhooks (Developer)	List, create, test, and delete webhook endpoints	No

To change your selection, disconnect and reconnect the MCP server -- you'll see the capability picker again.

Available Tools

Conversations

Tool	Description
list_conversations	List and filter conversations by status (open/snoozed/closed), assignment, channel type, or search term
get_conversation	View a conversation with its message history
send_reply	Reply to an existing conversation (auto-detects channel, handles email threading)
close_conversation	Close a conversation with optional notes and AI summarization
reopen_conversation	Reopen a closed conversation
snooze_conversation	Snooze a conversation until a given time (or clear an active snooze)
assign_conversation	Assign a conversation to a team member
add_internal_note	Add an agent-only note with optional @mentions — never sent to the customer
email_conversation_transcript	Email the full conversation transcript as a branded HTML email

Messaging

Tool	Description
send_message_to_contact	Send a message via the best available channel (WhatsApp, Telegram, SMS, Messenger, Instagram)
send_whatsapp_template	Send an approved WhatsApp template — reach contacts outside the 24-hour window. Supports positional and named variables, dynamic URL buttons, OTP buttons, and media headers
send_email	Send an email with subject, HTML body, CC/BCC, and custom sender

Contacts & Tags

Tool	Description
search_contacts	Find contacts by name, phone, email, or tags
create_contact	Create a new contact
update_contact	Update a contact's name, phone, email, spoken languages, or birthday
list_tags	List workspace tags
create_tag	Create a new tag with optional color
tag_contact / untag_contact	Add or remove a tag on a contact
tag_conversation / untag_conversation	Add or remove a tag on a conversation

Campaigns

Tool	Description
list_contact_lists	View contact lists with subscriber counts
list_campaigns	View messaging campaigns with status and delivery counts
get_campaign_status	Delivery statistics (sent/delivered/failed) for a messaging campaign
create_and_send_campaign	Create and send multi-channel campaigns (incl. WhatsApp template campaigns and scheduling)
list_email_campaigns	View email campaigns with status and analytics
get_email_campaign_analytics	Get detailed email campaign performance data

Analytics

Tool	Description
get_dashboard_metrics	Business metrics: messages, conversations, contacts, channels
get_bot_performance	AI bot metrics: resolution rate, confidence, escalation rate

Channels

Tool	Description
list_channels	View connected channels with health status
list_whatsapp_templates	List approved WhatsApp message templates
list_email_mailboxes	View email sender identities (mailboxes)

Team

Tool	Description
list_team_members	List team members with user IDs and roles (for assignment and @mentions)

Knowledge Base

Tool	Description
query_knowledge_base	AI-powered search across FAQ, website content, uploads, and ticket summaries

Webhooks (Developer)

Tool	Description
list_webhooks	List webhook endpoints with health status and recent failures
list_webhook_events	List all subscribable event types with descriptions
create_webhook	Create a webhook endpoint (HTTPS URL + event subscriptions)
test_webhook	Send a test event to verify an endpoint
delete_webhook	Delete a webhook endpoint

Examples

Check and reply to conversations

Ask your AI assistant:

"Show me my open conversations that need a reply"

The assistant will use list_conversations with status=open and needs_reply=true, then you can ask:

"Reply to the conversation with John saying we'll process the refund today"

Send a message to a contact

"Send a WhatsApp message to +49 170 1234567: Your order has been shipped!"

The assistant finds (or creates) the contact, resolves the best channel, and sends the message.

Send a WhatsApp template

"Send the order_update template to +49 170 1234567 with order number ORD-98765"

The assistant uses list_whatsapp_templates to check the template's variables, then send_whatsapp_template — this works even outside the 24-hour messaging window.

Snooze and note

"Snooze this conversation until Monday 9am and add a note that we're waiting for the warehouse"

The assistant snoozes the conversation and attaches an internal note that is visible to your team only — never to the customer.

Email a transcript

"Send the customer a copy of this conversation by email"

The assistant uses email_conversation_transcript to deliver a branded HTML transcript from your default mailbox.

Set up a webhook

"Create a webhook that sends new incoming messages to my n8n workflow at https://n8n.example.com/webhook/abc"

The assistant checks valid event names with list_webhook_events, creates the endpoint with create_webhook, and can verify it with test_webhook. (Requires the Webhooks capability.)

Search knowledge base

"What does our refund policy say about digital products?"

The assistant queries the knowledge base and returns an AI-generated answer with source citations.

Send an email

"Email [email protected] with subject 'Meeting Tomorrow' about the project status update. CC [email protected]."

The assistant creates the contact if needed, resolves the email channel, and sends with proper HTML formatting. If your account has multiple email mailboxes configured, the assistant will ask which sender identity to use before sending.

Next Steps

• Authentication -- API token setup
• Send Messages -- messaging API guide
• Knowledge Base -- knowledge base guide
• Webhooks -- receive real-time events