MCP clients
Connect Kenso to n8n with MCP
n8n connects to Kenso's remote MCP server with its MCP Client Tool node. Add the node to an AI Agent, set Endpoint to Kenso's server URL and Server Transport to HTTP Streamable, then use Bearer Auth with a Kenso API key.
How Do You Connect Kenso to n8n?
In short Add https://mcp.ken.so/mcp as a remote MCP server in n8n with your Kenso API key as a Bearer header.
Create a Kenso API Key
In the Kenso app, open Settings > Integrations > API Keys and create a key for this workflow.
Add the MCP Client Tool
Open a workflow with an AI Agent node, select the plus under Tool and add MCP Client Tool.
Point It at Kenso
Set Endpoint to the server URL below and Server Transport to HTTP Streamable. If your key reaches several Kenso workspaces, add ?workspace= and the workspace id to the URL.
https://mcp.ken.so/mcpAdd Your Key
Set Authentication to Bearer Auth, create a credential and paste your Kenso API key as the token. Leave Tools to Include on All, or pick the Kenso tools the agent may use.
What Can You Ask Kenso From n8n?
In short Ask in plain language. The client picks the Kenso tool, and Kenso runs it with your workspace role.
| Ask | Kenso tool used | What the tool does |
|---|---|---|
| Find VPs of Sales at US software companies with 50 to 200 employees. | search_read | Searches Kenso's people and company database and returns filter facets. |
| Which of my campaigns are running right now? | campaigns_read | Lists campaigns and reads one campaign's settings and status. |
| How did my campaigns do this week? Show sends, replies and bounces for each one. | analytics_read | Reads campaign performance, engagement, deliverability and reply classifications. |
| Show me the replies that came in today and summarize each one. | threads_read | Lists inbox threads and reads their messages. |
| Before I launch, preview who lands in the Series B segment. | segments_read | Previews which contacts land in a campaign segment. |
| How many emails a day can this campaign send with the inboxes it has? | campaign_flow_read | Estimates how many emails a campaign can send with its inboxes. |
Admins and members get read and write tools. A view-only seat gets read tools plus 8 write tools, inbox replies among them. Only the read-only URL, https://mcp.ken.so/mcp/readonly, removes every tool that writes.
- Kenso MCP security: Prompt injection, the read-only URL and what each role can change
What If Kenso Does Not Connect in n8n?
In short Most failures come from a skipped sign-in step or a client setting.
| Problem | Fix |
|---|---|
| A Kenso tool says the connection is not pinned to a workspace | Your API key reaches several Kenso workspaces. Add ?workspace= and the workspace id to the Endpoint, for example https://mcp.ken.so/mcp?workspace=42. |
| The node shows SSE Endpoint instead of Endpoint | That is the node's first version, which only speaks SSE. Add MCP Client Tool again to get the current version, then set Server Transport to HTTP Streamable. |
| Kenso answers 401 with an API key | The key was revoked or mistyped. Create a new one in the Kenso app under Settings > Integrations > API Keys. |
Frequently Asked Questions
Can n8n sign in to Kenso with OAuth instead of an API key?
The node offers an MCP OAuth2 credential, but a workflow that runs on its own is simpler with an API key. Create one key per workflow, so you can revoke it without touching anything else.
Which Kenso workspace does an n8n workflow use?
The one your API key works in. A key that reaches several workspaces must name one: add ?workspace= and the workspace id to the Endpoint. The id is the number after app.ken.so/ in the app's address.
What can n8n change in my Kenso workspace?
Only what your Kenso role allows. Admins and members get read and write tools, including campaign launches. A view-only seat gets read tools plus 8 write tools: email_copy_write, permissions_write, replies_write, saved_searches_write, scheduler_write, search_write, tags_write and threads_write. Of those, threads_write can send a reply email, delete threads and bulk-update them, and scheduler_write can bulk-cancel bookings. For a connection that cannot change anything, use https://mcp.ken.so/mcp/readonly. Kenso checks your role on every call, so a role change applies right away.
Free credits: 1,000 credits ($20) once, no card.
Related
- Kenso MCP serverWhat Kenso's MCP server does and every client it works with
- Claude MCP: Connect Kenso as a Custom Connector
- ChatGPT MCP: Connect Kenso as a Custom MCP Server
- Claude Code MCP: Connect Kenso
- Cursor MCP: Connect Kenso
- Codex MCP: Connect Kenso to OpenAI Codex
- Gemini CLI MCP: Connect Kenso
- Connect Kenso to Perplexity with MCP
- Connect Kenso to VS Code and GitHub Copilot with MCP
- Kenso pricingPlans and credit prices
Sources
| Source | Checked |
|---|---|
| n8n docs: MCP Client Tool node | |
| n8n source: MCP Client Tool node versions and fields |
Changelog
- Page published.