- \n
- n8n tools integration<\/a><\/li>\n\n\n\n
- Streamable HTTP (mcp-remote)<\/a><\/li>\n\n\n\n
- Claude Desktop<\/a><\/li>\n<\/ol>\n\n\n\n
A. n8n tools<\/h3>\n\n\n\n
The steps to add the Spoki MCP Client as a tool within your n8n workflow. This allows your n8n AI Agent to interact with the Spoki MCP server.<\/p>\n\n\n\n
Step1. Start Your Workflow and Add an AI Agent<\/strong><\/h4>\n\n\n\n
- \n
- Begin by creating a new workflow in n8n or opening an existing one.<\/li>\n\n\n\n
- Add the “AI Agent” node to your workflow. You can find this by clicking the “+” icon and searching for “AI Agent” under “AI Nodes.”<\/li>\n<\/ol>\n\n\n\n
![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-09-04-at-12.29.45-3-1024x544.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-09-04-at-12.29.52-1-1024x544.png\")
<\/figure>\n\n\n\nStep 2: Add the MCP Client Tool<\/strong><\/h4>\n\n\n\n
- \n
- Click the “+” icon next to the “Tool” section within the AI Agent node’s parameters.<\/li>\n\n\n\n
- Search for and select “MCP Client Tool” from the list of available tools. This will add a new MCP Client node to your canvas.<\/li>\n<\/ol>\n\n\n\n
![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-09-04-at-12.30.08-2-1024x544.png\")
<\/figure>\n\n\n\nStep 3: Configure the MCP Client Tool<\/strong><\/h4>\n\n\n\n
- \n
- Open the MCP Client Tool node’s parameters.<\/li>\n\n\n\n
- In the “Endpoint” field, enter the URL of the Spoki MCP server:
https:\/\/mcp.spoki.com\/v2\/mcp<\/code>.<\/li>\n\n\n\n- Set “
Server Transport<\/code>” to HTTP Streamable<\/strong>.<\/li>\n\n\n\n- For “
Authentication<\/code>,” select “Header Auth<\/code>.”<\/li>\n\n\n\n- Click on “Credential for Header Auth” and select “Create New.” This will open a new modal for your API key.\n
- \n
- In the new credential modal:\n
- \n
- Set “
Name<\/code>” toX-Spoki-Api-Key<\/code>.<\/li>\n\n\n\n- In the “
Value<\/code>” field, paste your Spoki API key (you can get one from app.spoki.it \u2192 Integrations \u2192 Spoki MCP \u2192 “Request Api Key”<\/strong>).<\/li>\n\n\n\n- Click “Save.”<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Back in the MCP Client Tool parameters, ensure that your newly created credential (“Spoki MCP Auth Header” or similar name you gave it) is selected for “Credential for Header Auth.”<\/li>\n\n\n\n
- Under “Tools to Include,” you can either select “All” to allow the AI Agent access to every Spoki MCP tool, or “Selected” to pick specific ones from the dropdown (e.g.,
get_contacts<\/code>,create_list<\/code>,trigger_automation<\/code>,create_ticket<\/code>,submit_template<\/code>). The dropdown always reflects the latest catalogue available to your account.<\/li>\n<\/ol>\n\n\n\n![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2026-05-13-at-13.20.23-950x1024.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-09-04-at-12.32.31-1024x544.png\")
<\/figure>\n\n\n\nB. Streamable HTTP (mcp-remote)<\/h3>\n\n\n\n
For MCP clients that connect through the
mcp-remote<\/code> proxy, use thehttp-only<\/code> transport with the configuration below.<\/p>\n\n\n\n\n{
\"mcpServers\": {
\"Spoki\": {
\"command\": \"npx\",
\"args\": [
\"-y\",
\"mcp-remote\",
\"https:\/\/mcp.spoki.com\/v2\/mcp\",
\"--header\",
\"X-Spoki-Api-Key: <ApiKey>\",
]
}
}
}
<\/pre>\n<\/div><\/div>\n\n\n\nC. Configuring Local MCP Servers in Claude Desktop<\/strong><\/h3>\n\n\n\n
![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-08-07-at-16.14.54-1-1024x821.png\")
<\/figure>\n\n\n\nStep 1: Navigate to Developer Settings<\/strong><\/h4>\n\n\n\n
- \n
- Open the Claude Desktop application.<\/li>\n\n\n\n
- Go to Settings<\/strong>.<\/li>\n\n\n\n
- From the sidebar menu, select the Developer<\/strong> tab.<\/li>\n<\/ol>\n\n\n\n
<\/p>\n\n\n\n
![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-08-07-at-16.15.06-1-1024x821.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-08-07-at-16.18.41-1-1024x817.png\")
<\/figure>\n\n\n\nStep 2: Open the Configuration File<\/strong><\/h4>\n\n\n\n
In the “Developer” section, you will find the “Local MCP servers” management area.<\/p>\n\n\n\n
- \n
- Click the Edit Config<\/strong> button.<\/li>\n\n\n\n
- This will open the
claude_desktop_config.json<\/code> file in your default text editor.<\/li>\n<\/ol>\n\n\n\n<\/p>\n\n\n\n
![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-08-07-at-16.18.41-2-1024x817.png\")
<\/figure>\n\n\n\nThis configuration file is typically located in the application’s data directory, as shown in the file explorer example below.<\/p>\n\n\n\n
![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-08-07-at-16.15.52-2-1024x633.png\")
<\/figure>\n\n\n\nStep 3: Add Your Server Configuration<\/strong><\/h4>\n\n\n\n
You will now add the specific command and arguments to connect to your server.<\/p>\n\n\n\n
- \n
- In the
claude_desktop_config.json<\/code> file, add your server configuration inside themcpServers<\/code> object.<\/li>\n\n\n\n- Each server is an object identified by a unique name (e.g.,
\"spoki-remote\"<\/code>).<\/li>\n\n\n\n- Provide the
command<\/code> andargs<\/code> needed to launch the localmcp-remote<\/code> proxy.<\/li>\n<\/ol>\n\n\n\n\n{
\"mcpServers\": {
\"spoki-remote\": {
\"command\": \"npx\",
\"args\": [
\"-y\",
\"mcp-remote\",
\"https:\/\/mcp.spoki.com\/v2\/mcp\",
\"--header\",
\"X-Spoki-Api-Key: <YOUR API KEY>\",
]
}
}
}
<\/pre>\n<\/div><\/div>\n\n\n\nRemember to replace
<YOUR API KEY><\/code> with your actual API key.<\/strong> You can get one from app.spoki.it \u2192 Integrations \u2192 Spoki MCP \u2192 “Request Api Key”<\/strong>.<\/p>\n\n\n\nStep 4: Save and Restart<\/strong><\/h4>\n\n\n\n
- \n
- Save the
claude_desktop_config.json<\/code> file.<\/li>\n\n\n\n- Quit and restart the Claude Desktop application for the changes to take effect.<\/li>\n<\/ol>\n\n\n\n
After restarting, your local MCP server will be configured and should appear in the “Local MCP servers” list within the Developer settings.<\/p>\n\n\n\n
<\/p>\n\n\n\n
Supported Tools & Actions<\/h2>\n\n\n\n
Spoki MCP exposes a catalogue of tools to manage contacts, automations, campaigns, lists, templates, tags, custom fields, tickets, operators, and account analytics. Tools are discovered dynamically by your MCP client, so the dropdown always reflects what is currently available to your account (some tools \u2014 such as tickets \u2014 only appear when the corresponding feature is enabled on your account).<\/p>\n\n\n\n
Contacts<\/h4>\n\n\n\n
- \n
- get_contacts<\/strong>: Search and list contacts. Supports filtering by name\/phone and blocked-only.<\/li>\n\n\n\n
- get_contact<\/strong>: Retrieve a single contact by its numeric ID.<\/li>\n\n\n\n
- get_or_create_contact<\/strong>: Get an existing contact by phone, creating it if missing. Returns the contact and a flag indicating whether it was newly created.<\/li>\n\n\n\n
- update_contact<\/strong>: Update a contact’s profile (only the fields you provide).<\/li>\n\n\n\n
- block_contact<\/strong>: Block or unblock a contact. Blocked contacts will not receive messages.<\/li>\n\n\n\n
- add_tags_to_contact<\/strong> \/ remove_tags_from_contact<\/strong> \/ get_contact_tags<\/strong>: Manage tags on a contact.<\/li>\n\n\n\n
- set_contact_field_value<\/strong>: Set a custom field value on a contact (create or update).<\/li>\n\n\n\n
- search_contacts_advanced<\/strong>: Composite filters across tags, lists, language, email, etc.<\/li>\n<\/ul>\n\n\n\n
Automations<\/h4>\n\n\n\n
- \n
- get_automations<\/strong>: List automations with optional filtering by active status.<\/li>\n\n\n\n
- get_automation<\/strong>: Get details of an automation by ID.<\/li>\n\n\n\n
- activate_automation<\/strong> \/ deactivate_automation<\/strong>: Switch an automation on or off.<\/li>\n\n\n\n
- trigger_automation<\/strong>: Manually trigger an active automation for a specific contact.<\/li>\n<\/ul>\n\n\n\n
Campaigns<\/h4>\n\n\n\n
- \n
- get_campaigns<\/strong>: List scheduled campaigns with optional date filters.<\/li>\n\n\n\n
- get_campaign<\/strong>: Get a specific campaign by ID.<\/li>\n\n\n\n
- create_campaign<\/strong>: Create a new scheduled campaign.<\/li>\n\n\n\n
- get_upcoming_events<\/strong>: Upcoming holidays and events for campaign planning.<\/li>\n<\/ul>\n\n\n\n
Lists<\/h4>\n\n\n\n
- \n
- get_lists<\/strong> \/ get_list<\/strong>: List or retrieve contact lists.<\/li>\n\n\n\n
- create_list<\/strong> \/ update_list<\/strong> \/ delete_list<\/strong>: Manage lists.<\/li>\n\n\n\n
- create_list_from_filters<\/strong>: Build a list using advanced filter criteria.<\/li>\n\n\n\n
- sync_contacts_to_list<\/strong> \/ add_filtered_contacts_to_list<\/strong>: Add contacts to a list (by IDs or by advanced filter).<\/li>\n\n\n\n
- remove_contacts_from_list<\/strong> \/ remove_filtered_contacts_from_list<\/strong> \/ clear_list<\/strong>: Remove members from a list.<\/li>\n\n\n\n
- get_import_job<\/strong>: Check the status of a contact import job.<\/li>\n\n\n\n
- import_from_hubspot<\/strong> \/ import_from_klaviyo<\/strong>: Pull contacts from a HubSpot or Klaviyo list\/segment into a new Spoki list.<\/li>\n<\/ul>\n\n\n\n
Templates<\/h4>\n\n\n\n
- \n
- get_templates<\/strong>: List message templates with optional search and approval-status filter.<\/li>\n\n\n\n
- get_template<\/strong>: Retrieve a template (including localizations and components) by ID.<\/li>\n\n\n\n
- create_template<\/strong> \/ update_template<\/strong> \/ delete_template<\/strong>: Manage templates.<\/li>\n\n\n\n
- submit_template<\/strong>: Submit a template for WhatsApp provider approval.<\/li>\n<\/ul>\n\n\n\n
Tags<\/h4>\n\n\n\n
- \n
- get_tags<\/strong> \/ create_tag<\/strong> \/ update_tag<\/strong> \/ delete_tag<\/strong>: Manage tags.<\/li>\n\n\n\n
- merge_tags<\/strong>: Merge a source tag into a target tag (reassigns contacts).<\/li>\n\n\n\n
- get_tag_categories<\/strong> \/ create_tag_category<\/strong>: Manage tag categories.<\/li>\n<\/ul>\n\n\n\n
Custom Fields<\/h4>\n\n\n\n
- \n
- get_custom_fields<\/strong> \/ get_custom_field<\/strong>: List or retrieve custom fields.<\/li>\n\n\n\n
- create_custom_field<\/strong> \/ update_custom_field<\/strong> \/ delete_custom_field<\/strong>: Manage custom fields.<\/li>\n\n\n\n
- get_custom_field_usage<\/strong>: See where a custom field is referenced across automations and templates.<\/li>\n<\/ul>\n\n\n\n
Tickets (available when the tickets feature is enabled on your account)<\/em><\/h4>\n\n\n\n
- \n
- get_tickets<\/strong>: Browse and search support tickets.<\/li>\n\n\n\n
- get_ticket<\/strong>: Retrieve a specific ticket with full details.<\/li>\n\n\n\n
- create_ticket<\/strong> \/ update_ticket<\/strong>: Manage tickets.<\/li>\n\n\n\n
- close_ticket<\/strong>: Close a ticket and set its closed timestamp.<\/li>\n\n\n\n
- assign_ticket<\/strong>: Assign a ticket to an operator (or pass
owner_id=null<\/code> to unassign).<\/li>\n\n\n\n- get_ticket_categories<\/strong>: List ticket categories available to the account.<\/li>\n<\/ul>\n\n\n\n
Analytics & Operators<\/h4>\n\n\n\n
- \n
- get_contact_stats<\/strong>: Total contacts plus lists and tags with contact counts.<\/li>\n\n\n\n
- get_automation_stats<\/strong>: Total and active automation counts.<\/li>\n\n\n\n
- get_campaign_performance<\/strong>: Performance breakdown per campaign.<\/li>\n\n\n\n
- get_operators<\/strong>: List the operators (team members) on the account and their roles.<\/li>\n<\/ul>\n\n\n\n
<\/p>\n\n\n\n
Resources & Support<\/h2>\n\n\n\n
- get_automation_stats<\/strong>: Total and active automation counts.<\/li>\n\n\n\n
- get_ticket<\/strong>: Retrieve a specific ticket with full details.<\/li>\n\n\n\n
- create_custom_field<\/strong> \/ update_custom_field<\/strong> \/ delete_custom_field<\/strong>: Manage custom fields.<\/li>\n\n\n\n
- merge_tags<\/strong>: Merge a source tag into a target tag (reassigns contacts).<\/li>\n\n\n\n
- get_template<\/strong>: Retrieve a template (including localizations and components) by ID.<\/li>\n\n\n\n
- create_list<\/strong> \/ update_list<\/strong> \/ delete_list<\/strong>: Manage lists.<\/li>\n\n\n\n
- get_campaign<\/strong>: Get a specific campaign by ID.<\/li>\n\n\n\n
- get_automation<\/strong>: Get details of an automation by ID.<\/li>\n\n\n\n
- get_contact<\/strong>: Retrieve a single contact by its numeric ID.<\/li>\n\n\n\n
- Quit and restart the Claude Desktop application for the changes to take effect.<\/li>\n<\/ol>\n\n\n\n
- Each server is an object identified by a unique name (e.g.,
- This will open the
- From the sidebar menu, select the Developer<\/strong> tab.<\/li>\n<\/ol>\n\n\n\n
- In the “
- Set “
- Set “
- Streamable HTTP (mcp-remote)<\/a><\/li>\n\n\n\n