- \n
- n8n tools integration<\/a><\/li>\n\n\n\n
- Server-Sent Events (SSE)<\/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
- <\/ol>\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 your Spoki MCP server. It typically looks like\u00a0
https:\/\/mcp.spoki.com\/mcp<\/code>.<\/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>” to\u00a0X-Spoki-Api-Key<\/code>.<\/li>\n\n\n\n- In the “
Value<\/code>” field, paste your actualSpoki <YOUR API KEY<\/strong>><\/code>.<\/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 (“Snoki 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 all Spoki MCP functions or “Selected” to choose specific functions from the dropdown list (e.g.,\u00a0create_custom_field,\u00a0create_list,\u00a0create_ticket,\u00a0delete_a_list,\u00a0get_account_report).<\/li>\n<\/ol>\n\n\n\n
![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-09-04-at-13.15.27-1024x544.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. Server-Sent Events (SSE)<\/h3>\n\n\n\n
\n{\n \"mcpServers\": {\n \"Spoki\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-remote\",\n \"https:\/\/mcp.spoki.com\/mcp\",\n \"--header\",\n \"X-Spoki-Api-Key: <ApiKey> \",\n \"--transport\",\n \"sse-only\"\n ]\n }\n }\n}\n<\/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 your local server proxy.<\/li>\n<\/ol>\n\n\n\nRemember to replace
<YOUR API KEY><\/code> with your actual API key.<\/strong><\/p>\n\n\n\n![\"\"](\"https:\/\/support.spoki.com\/wp-content\/uploads\/2025\/08\/Screenshot-2025-08-07-at-16.16.36-1-1024x589.png\")
<\/figure>\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 supports a variety of tools to manage contacts, lists, automations, tickets, reports, and messaging. Here are the currently available tools:<\/p>\n\n\n\n
- \n
- create_custom_field<\/strong>: Create a new custom field<\/li>\n\n\n\n
- create_list<\/strong>: Create a new list<\/li>\n\n\n\n
- create_ticket<\/strong>: Create a new support ticket<\/li>\n\n\n\n
- delete_list<\/strong>: Delete a list<\/li>\n\n\n\n
- get_account_report<\/strong>: Get current usage report for an account<\/li>\n\n\n\n
- get_automation<\/strong>: Get details of a specific automation by ID<\/li>\n\n\n\n
- get_automation_steps<\/strong>: Get steps of a specific automation by ID<\/li>\n\n\n\n
- get_contact<\/strong>: Retrieve a specific contact by ID<\/li>\n\n\n\n
- get_custom_field<\/strong>: Get details of a specific custom field by ID<\/li>\n\n\n\n
- get_list<\/strong>: Get a list by ID<\/li>\n\n\n\n
- list_accounts<\/strong>: List all accounts accessible to the user<\/li>\n\n\n\n
- list_automations<\/strong>: List all automations for the configured Spoki account with optional filtering<\/li>\n\n\n\n
- list_contact_lists<\/strong>: List all contact lists<\/li>\n\n\n\n
- list_contacts<\/strong>: List and search contacts with comprehensive filtering options<\/li>\n\n\n\n
- list_custom_fields<\/strong>: List all custom fields for the account<\/li>\n\n\n\n
- list_lists<\/strong>: List all lists<\/li>\n\n\n\n
- list_reports<\/strong>: List all reports with optional filtering and sorting<\/li>\n\n\n\n
- list_templates<\/strong>: List all message templates<\/li>\n\n\n\n
- list_tickets<\/strong>: List support tickets with filtering options<\/li>\n\n\n\n
- remove_all_contacts_from_list<\/strong>: Remove all contacts from a list<\/li>\n\n\n\n
- remove_contacts_from_list<\/strong>: Remove contacts from a list<\/li>\n\n\n\n
- send_message<\/strong>: Send a message to a contact<\/li>\n\n\n\n
- start_automation<\/strong>: Start\/trigger an automation for a specific contact with provided data<\/li>\n\n\n\n
- sync_contact<\/strong>: Create or update a single contact<\/li>\n\n\n\n
- sync_contacts_to_list<\/strong>: Sync contacts to a list<\/li>\n\n\n\n
- update_list<\/strong>: Update a list<\/li>\n<\/ul>\n\n\n\n
<\/p>\n\n\n\n
Resources & Support<\/h2>\n\n\n\n
- create_list<\/strong>: Create a new list<\/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 “
- For “
![\"\"](\"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
- Server-Sent Events (SSE)<\/a><\/li>\n\n\n\n