MCP Integration
Model Context Protocol for AI Assistants
Model Context Protocol (MCP) is an open standard introduced by Anthropic that allows AI assistants (like Claude, Cursor, VS Code Copilot) to integrate with external tools and data sources.
How It Works
The AI assistant communicates with the MCP server via the STDIO protocol, and the MCP server performs operations on NetSendo using the REST API v1.
┌─────────────────┐ STDIO ┌─────────────────┐ HTTP/S ┌─────────────────┐ │ Claude/Cursor │ ◄──────────► │ MCP Server │ ◄───────────► │ NetSendo │ │ (AI Client) │ │ (Docker/npx) │ │ (Your inst.) │ └─────────────────┘ └─────────────────┘ └─────────────────┘
Installation
Requirements
- Node.js 18+
- API Key from NetSendo
Steps
- Generate API Key: Settings → API Keys
- Install Node.js from nodejs.org
- Configure your AI tool using the configuration below
{
"mcpServers": {
"netsendo": {
"command": "npx",
"args": [
"-y",
"@netsendo/mcp-client",
"--url",
"https://your-domain.com",
"--api-key",
"YOUR_API_KEY"
]
}
}
}Replace https://your-domain.com with your NetSendo instance URL and YOUR_API_KEY with your generated API key.
Configuration File Locations
| Client | File Location |
|---|---|
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor IDE | Settings → MCP → Add Server |
| VS Code | .vscode/mcp.json |
Supported AI Clients
Official Claude desktop app from Anthropic
IDE with built-in AI for developers
Visual Studio Code with MCP extension
Available Features
Subscribers
Manage contacts – add, edit, delete
Contact Lists
Browse and organize mailing lists
Email Messages
Send personalized email messages
SMS Messages
Send SMS messages to contacts
Tags
Categorize subscribers using tags
Statistics
Check account and deliverability statistics
Available Tools
Subscriber Management
| Tool | Description |
|---|---|
| list_subscribers | List subscribers with filtering and pagination |
| get_subscriber | Get subscriber by ID or email |
| create_subscriber | Create a new subscriber |
| update_subscriber | Update subscriber data |
| delete_subscriber | Delete a subscriber |
| sync_subscriber_tags | Sync subscriber tags |
Contact Lists & Tags
| Tool | Description |
|---|---|
| list_contact_lists | Get all contact lists |
| get_contact_list | Get list details |
| get_list_subscribers | Get subscribers from a list |
| list_tags | Get all available tags |
| list_custom_fields | Get custom field definitions |
Messages
| Tool | Description |
|---|---|
| list_mailboxes | Get available mailboxes |
| send_email | Send email to subscriber |
| get_email_status | Check email delivery status |
| list_sms_providers | Get available SMS providers |
| send_sms | Send SMS message |
| get_sms_status | Check SMS delivery status |
Account
| Tool | Description |
|---|---|
| test_connection | Test API connection |
| get_account_info | Get account information |
Example Queries
Security
Troubleshooting
- Make sure NetSendo is running and accessible
- Check if the API key is valid
- Verify the URL is correct (include https://)
Restart your AI tool after configuration changes.
Install Node.js from nodejs.org (includes npm/npx).
Multiple NetSendo Instances
You can connect to multiple NetSendo instances using different server names:
{
"mcpServers": {
"netsendo-production": {
"command": "npx",
"args": ["-y", "@netsendo/mcp-client", "--url", "https://app.company.com", "--api-key", "prod-key"]
},
"netsendo-staging": {
"command": "npx",
"args": ["-y", "@netsendo/mcp-client", "--url", "https://staging.company.com", "--api-key", "staging-key"]
}
}
}