ClickSend REST API v3 API MCP Server

⚠️ ADVANCED USE ONLY - ClickSend REST API v3 MCP Server (205 operations)

🚨 This workflow is for advanced users only!

This MCP server contains 205 operations which is significantly more than the recommended maximum of tools for most AI clients.

🔍 Recommended Alternative for basic use cases

Seek a simplified MCP server that utilizes the official n8n tool implementation for ClickSend REST API v3 if available, or an MCP server with only common operations as it will be more efficient and easier to manage.

🛠️ Advanced Usage Requirements

BEFORE adding this MCP server to your client:

Disable or delete unused nodes - Review sections and disable/delete those you don't need

AFTER adding the MCP server to your client:
1.Selective tool enabling - Instead of enabling all tools (default), manually select only the specific tools you need for that Workflow's MCP client.
2. Monitor performance - Too many tools can slow down AI responses

💡 Pro Tips

Keep maximum 40 enabled tools - Most AI clients perform better with fewer tools

• Group related operations and only enable one group at a time

• Use the overview note to understand what each operation group does

• Ping me on discord if your business needs this implemented professionally

⚡ Quick Setup

1. Import this workflow into your n8n instance
2. Credentials Add ClickSend REST API v3 credentials
3. Activate the workflow to start your MCP server
4. Copy the webhook URL from the MCP trigger node
5. Connect AI agents using the MCP URL

🔧 How it Works

This workflow converts the ClickSend REST API v3 API into an MCP-compatible interface for AI agents.

• MCP Trigger: Serves as your server endpoint for AI agent requests
• HTTP Request Nodes: Handle API calls to https://rest.clicksend.com/v3
• AI Expressions: Automatically populate parameters via $fromAI() placeholders
• Native Integration: Returns responses directly to the AI agent

📋 Available Operations (205 total)

🔧 Account (4 endpoints)

• GET /account: Update Reseller 4
• POST /account: Create a new account
• PUT /account: Update Account
• GET /account/usage/{year}/{month}/{type}: Account Usage

🔧 Account-Verify (2 endpoints)

• PUT /account-verify/send: Send account activation token
• PUT /account-verify/verify/{activation_token}: Verify new account

🔧 Automations (30 endpoints)

• GET /automations/email/receipt: Update Automation 6
• POST /automations/email/receipt: Create a New Rule
• DELETE /automations/email/receipt/{rule_id}: Delete a Rule
• GET /automations/email/receipt/{rule_id}: Get a Specific Rule
• PUT /automations/email/receipt/{rule_id}: Update a Rule
• GET /automations/fax/inbound: Update Automation 7
• POST /automations/fax/inbound: Create a new rule
• DELETE /automations/fax/inbound/{inbound_rule_id}: Delete a rule
• GET /automations/fax/inbound/{inbound_rule_id}: Get a specific rule
• PUT /automations/fax/inbound/{inbound_rule_id}: Update a rule
• GET /automations/fax/receipts: Update Automation 8
• POST /automations/fax/receipts: Create a New Rule
• DELETE /automations/fax/receipts/{rule_id}: Delete a Rule
• GET /automations/fax/receipts/{rule_id}: Get a Specific Rule
• PUT /automations/fax/receipts/{rule_id}: Update a Rule
• GET /automations/sms/inbound: Update Automation 9
• POST /automations/sms/inbound/: Create a new rule
• DELETE /automations/sms/inbound/{inbound_rule_id}: Delete a rule
• GET /automations/sms/inbound/{inbound_rule_id}: Get a specific rule
• PUT /automations/sms/inbound/{inbound_rule_id}: Update a rule
• GET /automations/sms/receipts: Update Automation 10
• POST /automations/sms/receipts: Create a new rule
• DELETE /automations/sms/receipts/{receipt_rule_id}: Delete a rule
• GET /automations/sms/receipts/{receipt_rule_id}: Get a specific rule
• PUT /automations/sms/receipts/{receipt_rule_id}: Update a rule
• GET /automations/voice/receipts: Update Automation 11
• POST /automations/voice/receipts: Create a new rule
• DELETE /automations/voice/receipts/{receipt_rule_id}: Delete a rule
• GET /automations/voice/receipts/{receipt_rule_id}: Get a specific rule
• PUT /automations/voice/receipts/{receipt_rule_id}: Update a rule

🔧 Contact-Suggestions (1 endpoints)

• GET /contact-suggestions: Get Contact-Suggestions 1

🔧 Countries (1 endpoints)

• GET /countries: Get Countries 1

🔧 Delivery-Issues (2 endpoints)

• GET /delivery-issues: Create Delivery-Issue 1
• POST /delivery-issues: Create Delivery Issue

🔧 Email-Campaigns (7 endpoints)

• GET /email-campaigns: Update Email-Campaign 3
• POST /email-campaigns/price: Calculate Price
• POST /email-campaigns/send: Create Email Campaign
• GET /email-campaigns/{campaign_id}/history: Get Specific Email Campaign History
• GET /email-campaigns/{email_campaign_id}: Get Specific Email Campaign
• PUT /email-campaigns/{email_campaign_id}: Update Email Campaign
• PUT /email-campaigns/{email_campaign_id}/cancel: Cancel Email Campaign

🔧 Email (22 endpoints)

• PUT /email/address-verify/{email_address_id}/send: Send Verification Token
• PUT /email/address-verify/{email_address_id}/verify/{activation_token}: Verify Allowed Email Address
• GET /email/addresses: Get Email 12
• POST /email/addresses: Create Allowed Email Address
• DELETE /email/addresses/{email_address_id}: Delete Allowed Email Address
• GET /email/addresses/{email_address_id}: Get Specific Allowed Email Address
• GET /email/history: Get Email 21
• GET /email/history/export?filename={filename}: Export History
• GET /email/master-templates: Get Email 17
• GET /email/master-templates-categories: Get All Master Template Categories
• GET /email/master-templates-categories/{category_id}: Get Specific Email Template Category
• GET /email/master-templates-categories/{category_id}/master-templates: Get All Templates For Category
• GET /email/master-templates/{template_id}: Get Specific Master Template
• POST /email/price: Create Email 9
• POST /email/receipts: Create Email 10
• POST /email/send: Create Email 11
• GET /email/templates: Update Email 5
• POST /email/templates: Create New Email Template from Master Template
• POST /email/templates-images/{template_id}: Upload Image to Specific Template
• DELETE /email/templates/{template_id}: Delete Email Template
• GET /email/templates/{template_id}: Get Specific Email Template
• PUT /email/templates/{template_id}: Update an Email Template

🔧 Fax (8 endpoints)

• GET /fax/history/export?filename={filename}: Export Fax History
• GET /fax/history?date_from={date_from}&date_to={date_to}&q={q}&order_by={order_by}: Get Fax History
• POST /fax/price: Create Fax 3
• GET /fax/receipts: Get Fax 7
• POST /fax/receipts: Add a Test Delivery Receipt
• PUT /fax/receipts-read: Mark Fax Delivery Receipts as read
• GET /fax/receipts/{message_id}: Get a Specific Fax Delivery Receipt
• POST /fax/send: Create Fax 5

🔧 Forgot-Password (2 endpoints)

• PUT /forgot-password: Update Forgot-Password 3
• PUT /forgot-password/verify: Verify Forgot Password

🔧 Forgot-Username (1 endpoints)

• PUT /forgot-username: Update Forgot-Username 1

🔧 Lists (17 endpoints)

• GET /lists: Update List 9
• POST /lists: Create a new contact list
• PUT /lists/{from_list_id}/contacts/{contact_id}/{to_list_id}: Transfer a Contact
• DELETE /lists/{list_id}: Delete a specific contact list
• GET /lists/{list_id}: Get a specific contact list
• PUT /lists/{list_id}: Update a specific contact list
• GET /lists/{list_id}/contacts: Get all Contacts in a List
• POST /lists/{list_id}/contacts: Create a new contact
• DELETE /lists/{list_id}/contacts/{contact_id}: Delete a specific contact
• GET /lists/{list_id}/contacts/{contact_id}: Get a specific contact
• PUT /lists/{list_id}/contacts/{contact_id}: Update a specific contact
• GET /lists/{list_id}/export?filename={filename}: Export Contacts List
• POST /lists/{list_id}/import: Import Contacts to List
• POST /lists/{list_id}/import-csv-preview: Show CSV Import File Preview
• GET /lists/{list_id}/import-fields: Get List of Acceptable Import Fields
• PUT /lists/{list_id}/remove-duplicates: Remove Duplicate Contacts
• PUT /lists/{list_id}/remove-opted-out-contacts/{opt_out_list_id}: Remove Opted Out Contacts

🔧 Mms (9 endpoints)

• PUT /mms/cancel-all: Update Mm 3
• GET /mms/history/export?filename={filename}: Export MMS History
• GET /mms/history?q={q}&order_by={order_by}&date_from={date_from}&date_to={date_to}: Get MMS History
• POST /mms/price: Create Mm 2
• GET /mms/receipts: Get Mm 5
• PUT /mms/receipts-read: Mark Receipts As Read
• GET /mms/receipts/{message_id}: Get Delivery Receipt
• POST /mms/send: Create Mm 3
• PUT /mms/{message_id}/cancel: Cancel MMS

🔧 Numbers (3 endpoints)

• GET /numbers: Get Number 1
• POST /numbers/buy/{dedicated_number}: Buy dedicated number
• GET /numbers/search/{country}?{search}=1&{search_type}=2: Search Dedicated Numbers by Country

🔧 Post (18 endpoints)

• GET /post/direct-mail/campaigns: Create Post 9
• POST /post/direct-mail/campaigns/price: Calculate Direct Mail Campaign Price
• POST /post/direct-mail/campaigns/send: Create New Campaign
• GET /post/direct-mail/locations/search/{country}/?q={query}: Search Locations
• POST /post/letters/detect-address: Create Post 10
• GET /post/letters/history: Get Post 11
• GET /post/letters/history/export?filename={filename}: Export Post Letter History
• POST /post/letters/price: Create Post 11
• POST /post/letters/send: Create Post 12
• GET /post/postcards/export?filename={filename}: Export Postcard History
• GET /post/postcards/history: Get Post 15
• POST /post/postcards/price: Create Post 14
• POST /post/postcards/send: Create Post 15
• GET /post/return-addresses: Update Post 1
• POST /post/return-addresses: Create a Post Return Address
• DELETE /post/return-addresses/{return_address_id}: Delete Post Return Address
• GET /post/return-addresses/{return_address_id}: Get Post Return Address
• PUT /post/return-addresses/{return_address_id}: Update Post Return Address

🔧 Pricing (1 endpoints)

• GET /pricing/{country}?currency={currency}: Get Country Pricing

🔧 Recharge (6 endpoints)

• GET /recharge/credit-card: Update Recharge 2
• PUT /recharge/credit-card: Update Credit Card info
• GET /recharge/packages?country={country}: List of Packages
• PUT /recharge/purchase/{package_id}: Purchase a Package
• GET /recharge/transactions: Get Recharge 7
• GET /recharge/transactions/{transaction_id}: Get a specific transaction

🔧 Referral (1 endpoints)

• GET /referral/accounts: Get List of Referral Accounts

🔧 Reseller (9 endpoints)

• GET /reseller: Update Reseller 5
• PUT /reseller: Update Reseller Setting
• GET /reseller/accounts: List of Reseller Accounts
• POST /reseller/accounts: Create Reseller Account
• POST /reseller/accounts-public: Create Reseller Account - Public
• GET /reseller/accounts/{client_user_id}: Get Reseller Account
• PUT /reseller/accounts/{client_user_id}: Update Reseller Account
• PUT /reseller/transfer-credit: Transfer Credit
• GET /reseller/{subdomain}: Reseller By Subdomain

🔧 Sdk-Download (1 endpoints)

• GET /sdk-download/{type}: SDK Download

🔧 Search (1 endpoints)

• GET /search/contacts-lists?q={q}: Search Contacts-Lists

🔧 Sms-Campaigns (9 endpoints)

• GET /sms-campaigns: Update Sms-Campaign 3
• POST /sms-campaigns/price: Calculate Price for SMS Campaign
• POST /sms-campaigns/send: Use Short URL
• GET /sms-campaigns/{campaign_id}/link-export?filename={filename}: Link Tracking Export
• GET /sms-campaigns/{campaign_id}/link-statistics: Link Statistics
• GET /sms-campaigns/{campaign_id}/link-tracking: Link Tracking
• GET /sms-campaigns/{sms_campaign_id}: Get SMS Campaign
• PUT /sms-campaigns/{sms_campaign_id}: Update an SMS Campaign
• PUT /sms-campaigns/{sms_campaign_id}/cancel: Cancel an SMS Campaign

🔧 Sms (29 endpoints)

• PUT /sms/cancel-all: Update Sm 8
• GET /sms/email-sms: Update Sm 14
• POST /sms/email-sms: Create Email to SMS Allowed Address
• GET /sms/email-sms-stripped-strings: List Stripped Strings
• POST /sms/email-sms-stripped-strings: Create Stripped String
• DELETE /sms/email-sms-stripped-strings/{rule_id}: Delete Stripped String
• GET /sms/email-sms-stripped-strings/{rule_id}: Find Specific Stripped String
• PUT /sms/email-sms-stripped-strings/{rule_id}: Update Stripped String
• DELETE /sms/email-sms/{email_address_id}: Delete Email-to-SMS Allowed Address
• GET /sms/email-sms/{email_address_id}: Get specific Email-to-SMS Allowed Address
• PUT /sms/email-sms/{email_address_id}: Update Email-to-SMS Allowed Address
• GET /sms/history/export?filename={filename}: Export SMS History
• GET /sms/history?date_from={date_from}&date_to={date_to}: Get all History
• GET /sms/inbound: Get Sm 8
• POST /sms/inbound: Add a Test Inbound SMS
• PUT /sms/inbound-read: Mark all Inbound SMS as read
• PUT /sms/inbound-read/{message_id}: Mark a specific Inbound SMS as read
• GET /sms/inbound/{outbound_message_id}: Get Specific Inbound - Pull
• POST /sms/price: Create Sm 8
• GET /sms/receipts: Get Sm 9
• POST /sms/receipts: Add a Test Delivery Receipt
• PUT /sms/receipts-read: Mark Delivery Receipts as read
• GET /sms/receipts/{message_id}: Get a Specific Delivery Receipt
• POST /sms/send: Create Sm 10
• GET /sms/templates: Update Sm 15
• POST /sms/templates: Create a Template
• DELETE /sms/templates/{template_id}: Delete a Template
• PUT /sms/templates/{template_id}: Update a Template
• PUT /sms/{message_id}/cancel: Cancel a Scheduled Message

🔧 Statistics (2 endpoints)

• GET /statistics/sms: Get Statistics 2
• GET /statistics/voice: Get Statistics 3

🔧 Subaccounts (6 endpoints)

• GET /subaccounts: Update Subaccount 3
• POST /subaccounts: Create a new subaccount
• DELETE /subaccounts/{subaccount_id}: Delete a specific subaccount
• GET /subaccounts/{subaccount_id}: Get a specific subaccount
• PUT /subaccounts/{subaccount_id}: Update a specific subaccount
• PUT /subaccounts/{subaccount_id}/regen-api-key: Regenerate API Key

🔧 Timezones (1 endpoints)

• GET /timezones: Get Timezones 1

🔧 Uploads?Convert={Convert} (1 endpoints)

• POST /uploads?convert={convert}: Upload a file

🔧 Voice (11 endpoints)

• PUT /voice/cancel-all: Update Voice 3
• GET /voice/history/export?filename={filename}: Export Voice History
• GET /voice/history?date_from={date_from}&date_to={date_to}: Get Voice History
• GET /voice/lang: Get Voice 7
• POST /voice/price: Create Voice 3
• GET /voice/receipts: Get Voice 9
• POST /voice/receipts: Add a Test Delivery Receipt
• PUT /voice/receipts-read?date_before={date_before}: Marked Voice Receipts as Read
• GET /voice/receipts/{message_id}: Get Specific Voice Receipt
• POST /voice/send: Create Voice 5
• PUT /voice/{message_id}/cancel: Cancel a Specific Voice Call

🤖 AI Integration

Parameter Handling: AI agents automatically provide values for:
• Path parameters and identifiers
• Query parameters and filters
• Request body data
• Headers and authentication

Response Format: Native ClickSend REST API v3 API responses with full data structure

Error Handling: Built-in n8n HTTP request error management

💡 Usage Examples

Connect this MCP server to any AI agent or workflow:

• Claude Desktop: Add MCP server URL to configuration
• Cursor: Add MCP server SSE URL to configuration
• Custom AI Apps: Use MCP URL as tool endpoint
• API Integration: Direct HTTP calls to MCP endpoints

✨ Benefits

• Zero Setup: No parameter mapping or configuration needed
• AI-Ready: Built-in $fromAI() expressions for all parameters
• Production Ready: Native n8n HTTP request handling and logging
• Extensible: Easily modify or add custom logic

🆓 Free for community use! Ready to deploy in under 2 minutes.