How to Add a Messaging MCP Server to Claude Code

What if you could send an iMessage just by telling Claude Code to do it? With the senderZ MCP server, you can. One command to install, zero code to write.

This guide covers what MCP is, how the senderZ MCP server works, how to install it, and what you can actually do with it once it’s running.

What Is MCP?

MCP stands for Model Context Protocol — an open standard created by Anthropic that defines how AI tools like Claude Code interact with external services and data sources.

Think of MCP servers as plugins for Claude Code. Each MCP server exposes a set of “tools” — named functions with defined inputs and outputs — that Claude can call on your behalf. When you tell Claude Code “send a verification code to +15551234567,” Claude figures out which tool to call (send_message), fills in the parameters, makes the call, and reports back what happened.

Without MCP, using a messaging API requires writing code: HTTP clients, JSON serialization, error handling, retry logic. With MCP, you describe what you want in plain English and Claude handles everything.

The senderZ MCP server exposes 15+ messaging tools that cover the full senderZ API surface — from sending single messages to managing campaigns, checking opt-out status, and analyzing delivery performance.

No competitor — not Twilio, not Sendblue, not Blooio — has an MCP server. senderZ is the only messaging platform you can use directly from Claude Code.

Install in One Command

If you have a senderZ API key, installing the MCP server takes one command:

claude mcp add senderz -- npx @senderz/mcp --api-key tf_live_YOUR_KEY

Replace tf_live_YOUR_KEY with your actual API key from the senderZ dashboard.

If you’re running a self-hosted senderZ instance:

claude mcp add senderz -- npx @senderz/mcp \
  --api-key tf_live_YOUR_KEY \
  --base-url https://api.yourdomain.com

After running the install command, restart Claude Code. The senderZ tools are immediately available — no additional configuration needed.

Don’t have a senderZ account yet? Sign up at senderZ.com — your 14-day free trial includes 1,000 messages, which is plenty for development and testing.

10 Things You Can Say to Claude Code

Once the MCP server is installed, you interact with senderZ through natural language. Here are ten examples that show what’s possible:

1. Send a one-off message

“Send a text to +15551234567 saying ‘Your order has shipped and will arrive Thursday.’”

2. Send an OTP verification code

“Use the otp_verify template to send a verification code of 7742 to +15559876543”

3. Check delivery status

“Did the message I just sent get delivered?”

4. Find failed messages

“Show me all messages that failed to deliver in the last 7 days”

5. Create a reusable template

“Create a template called appointment_reminder that says ‘Hi [name], this is a reminder about your appointment on [date] at [time]. Reply STOP to opt out.’”

6. Send to multiple people

“Send the summer_sale template to these five numbers: +1555123, +1555456, +1555789, +1555012, +1555345”

7. Check usage

“How many messages do I have left this month?”

8. Check if a number opted out

“Has +15551234567 ever texted STOP to us?”

9. Add a contact

“Add John Smith, phone +15558675309, to the VIP group in our contact book”

10. Detect iMessage support

“Which of these numbers can receive iMessage: +15551111, +15552222, +15553333?”

Claude Code parses your intent, calls the right senderZ tool with the right parameters, handles any errors, and gives you a plain-language response. You never write a line of code.

All Available Tools

The senderZ MCP server exposes 15 tools. Here’s the complete reference:

Tool	What It Does
send_message	Send iMessage or SMS to a single phone number
get_message	Get status and delivery details for a specific message
list_messages	List sent/received messages with filters
create_template	Create a reusable message template
list_templates	List all templates in your account
send_campaign	Send a message to multiple recipients at once
get_campaign_status	Check delivery progress of a campaign
list_contacts	List contacts with optional group/search filters
add_contact	Add a new contact to the contact book
check_optout	Check if a phone number has opted out
get_usage	Get current billing period usage and remaining quota
detect_imessage	Check which numbers support iMessage delivery
suggest_reply	Get AI-generated reply suggestions for an inbound message
get_message_analytics	Get delivery stats for a time period
list_webhooks	List registered webhook endpoints

Each tool validates your API key before executing, enforces tenant isolation (your data stays separate from other accounts), and returns structured errors that Claude can reason about and explain to you in plain language.

For example, if you ask Claude to send a message to a number that has opted out:

“Send a message to +15551234567 saying ‘Check out our sale!’”

Claude will respond:

“I can’t send that message. +15551234567 has opted out of messages from your account (they texted STOP on March 15). Would you like me to check on a different number, or would you like to see your full opt-out list?”

Claude handles the error, explains it in context, and suggests next steps — all automatically.

Why This Matters

The MCP approach changes how developers interact with external APIs. Instead of writing integration code, you describe what you want. Instead of reading API documentation, you ask Claude to figure it out. Instead of debugging HTTP errors, Claude catches them and explains them.

For developers who use Claude Code as their primary development environment, this means:

Prototyping is faster. Testing a messaging flow used to mean writing a test script, running it, and reading raw API responses. Now you can test messaging behavior in a natural language conversation with Claude.

Operations are easier. Checking delivery status, pulling failed message reports, verifying opt-out lists — these are common operational tasks that normally require either a dashboard or custom scripts. With the MCP server, you just ask.

Less context switching. If you’re building a feature in Claude Code and need to send a test message, you don’t have to open a browser, navigate to a dashboard, and switch context. You just ask Claude.

The senderZ MCP server is the most comprehensive messaging integration available for Claude Code. Blooio offers approximately 5 tools in their MCP integration. senderZ offers 15+ — covering the full lifecycle from sending to analytics to compliance.

This was a deliberate design choice. Every tool call in the MCP server is a thin proxy to the senderZ API. Business logic lives in the API layer; the MCP server just exposes it. This means the MCP server is always up to date with new API features.

FAQ

Do I need to write any code to use the MCP server?

No. After running the one-line install command, everything works through natural language in Claude Code. You never write HTTP requests, handle JSON, or touch an SDK.

If you want to integrate senderZ messaging into your own application (not through Claude Code), you’d use the REST API directly or the official TypeScript/JavaScript SDK. The MCP server is specifically for Claude Code usage.

Can I use this alongside other MCP servers?

Yes. MCP servers coexist independently. Claude Code can have any number of MCP servers installed simultaneously. If you have a GitHub MCP server, a database MCP server, and the senderZ MCP server installed, Claude has access to all their tools at once.

Common combination: use the senderZ MCP server alongside a contacts database MCP server. You can ask Claude to “look up all customers who haven’t responded in 7 days and send them a follow-up message” — Claude queries the database with one MCP server and sends messages with the other.

Is there a cost for the MCP server itself?

No. The @senderz/mcp package is free to install and use. You pay for your senderZ plan, which covers the messages you send. The MCP server is just a different way to call the same API.

The senderZ free trial includes 1,000 messages over 14 days — enough for development and light usage — at no cost. See pricing for full plan details.

---

Ready to add messaging to Claude Code? Get your API key at senderZ.com — start free with a 14-day trial — and run the install command. Within two minutes you’ll be sending iMessages and SMS from natural language in Claude Code.

For the full API documentation and SDK reference, visit /docs/quickstart.