Kenso

MCP clients

Connect Kenso to Grok with MCP

Grok adds Kenso's remote MCP server as a custom connector. Open Connectors on grok.com, select New Connector, then Custom, paste Kenso's server URL and sign in to Kenso. On Grok Business and Enterprise, a team admin adds the connector first.

How Do You Connect Kenso to Grok?

In short Add https://mcp.ken.so/mcp as a remote MCP server in Grok, then sign in to Kenso in your browser.

  1. Open Connectors

    Go to grok.com/connectors, select New Connector, then Custom.

  2. Paste the Kenso Server URL

    Enter the server URL below as the MCP server URL.

    https://mcp.ken.so/mcp
  3. Sign In to Kenso

    When Grok asks you to authenticate, complete the sign-in. Your browser opens the Kenso sign-in. Sign in with the account you use in the Kenso app, then select Allow access on the Kenso approval screen. You never paste a client ID or secret.

  4. Ask Grok

    Grok lists Kenso's tools once it connects and uses them when a question is about your Kenso workspace.

What Can You Ask Kenso From Grok?

In short Ask in plain language. The client picks the Kenso tool, and Kenso runs it with your workspace role.

Example requests in Grok and the Kenso MCP tool that answers each one
AskKenso tool usedWhat the tool does
Find VPs of Sales at US software companies with 50 to 200 employees.search_readSearches Kenso's people and company database and returns filter facets.
Which fintech companies in Germany have more than 100 employees? Search Kenso's 250M people and 24M companies.search_readSearches Kenso's people and company database and returns filter facets.
Which of my campaigns are running right now?campaigns_readLists 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_readReads campaign performance, engagement, deliverability and reply classifications.
Show me the replies that came in today and summarize each one.threads_readLists inbox threads and reads their messages.

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.

What If Kenso Does Not Connect in Grok?

In short Most failures come from a skipped sign-in step or a client setting.

Common Grok connection problems and fixes
ProblemFix
Your Grok Business team has no Kenso connector to connectA team admin adds it first: in console.x.ai, open Grok Business > Connectors, select Add Connector, choose Other and enter the Kenso server URL. That takes Team Read-Write permission. Then each person signs in with their own Kenso account.
A Kenso tool answers "Missing scope"Part of the Kenso approval screen was declined. Remove Kenso from the client, add it again and select Allow access.
Kenso worked, then asks you to sign in every timeThe client's saved registration is gone. Remove Kenso and add it again so the client registers itself again.

Frequently Asked Questions

Do I need a paid Grok plan to add Kenso?

xAI says connectors are available to all Grok users and names no plan for custom ones. On Grok Business and Enterprise, a team admin must add the connector before members can connect it.

Can I use a Kenso API key in Grok?

xAI's docs do not say how Grok sends an API key for a custom connector. Use the Kenso sign-in, which Grok runs when you add the connector.

What can Grok 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.

Sources

Every source, with the date we checked it
SourceChecked
xAI docs: Grok connectors
xAI docs: connector management for Grok Business and Enterprise

Changelog

  1. Page published.