MCP server

The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your Kyo data in a simple and secure way.

Kyo's MCP server comes in two flavors: a hosted (remote) server you connect to with a URL — no install — and a local server that ships inside the Kyo CLI and runs over stdio. Both expose the same 36 read and write tools that map 1:1 to the REST API — deals, contacts, companies, tasks, pipelines, spaces, and more. Every tool call runs as you, bounded by the scopes you granted at sign-in and by your workspace permissions, so an agent can never do more than you can in the app.

Setup instructions

Hosted server — no install

Point any remote-capable MCP client at:

url

https://app.trykyo.com/api/mcp

The first connection opens Kyo's sign-in and consent screen in your browser — you approve the scopes there, and the client registers itself and completes OAuth automatically. In claude.ai, add it under Settings → Connectors → Add custom connector. In Claude Code:

bash

claude mcp add --transport http kyo https://app.trykyo.com/api/mcp

In Cursor, add the URL form to ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "kyo": { "url": "https://app.trykyo.com/api/mcp" }
  }
}

Local server — general

Prefer the local (stdio) server if your client can't reach remote servers, or you want your tokens to live only on your machine. Every client needs the CLI installed and a one-time sign-in:

bash

npm install -g kyo-cli
kyo login

After that, your MCP client launches the server itself from its config — you never run kyo mcp by hand. Restart the client after editing its config; the tools are discovered automatically.

Claude Desktop

Add Kyo to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{
  "mcpServers": {
    "kyo": { "command": "npx", "args": ["-y", "kyo-cli", "mcp"] }
  }
}

Claude Code

One command from any terminal:

bash

claude mcp add kyo -- npx -y kyo-cli mcp

Cursor

Add Kyo to ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "kyo": { "command": "kyo", "args": ["mcp"] }
  }
}

Other clients

Any MCP client that supports local stdio servers works. Configure it to run the command npx with arguments ["-y", "kyo-cli", "mcp"] — or simply kyo mcp if the CLI is installed globally.

Then try it: ask your agent to "list my Kyo deals" or "create a deal for Acme in the Sales pipeline."

Available tools

36 tools, each mapping to a REST API resource:

Group	Tools
General	`kyo_whoami`
Deals	`kyo_list_deals`, `kyo_get_deal`, `kyo_create_deal`, `kyo_update_deal`
People	`kyo_list_people`, `kyo_get_person`, `kyo_create_person`, `kyo_update_person`
Companies	`kyo_list_companies`, `kyo_get_company`, `kyo_create_company`, `kyo_update_company`
Tasks	`kyo_list_tasks`, `kyo_create_task`, `kyo_update_task`, `kyo_list_deal_tasks`, `kyo_create_deal_task`
Pipelines	`kyo_list_pipelines`, `kyo_create_pipeline`, `kyo_update_pipeline`, `kyo_list_pipeline_stages`, `kyo_create_pipeline_stage`, `kyo_update_pipeline_stage`
Spaces & projects	`kyo_list_spaces`, `kyo_create_space`, `kyo_update_space`, `kyo_list_projects`, `kyo_create_project`, `kyo_update_project`
Labels	`kyo_list_labels`, `kyo_create_label`
Comments & links	`kyo_add_comment`, `kyo_list_comments`, `kyo_link_person_to_deal`
Enrichment	`kyo_enrich_company` (metered)

Security

Runs as you — every call is bounded by the scopes granted at kyo login and your workspace permissions, including private-task visibility. An agent can never exceed what you can do in the app.
Credentials never reach the model — the local server holds your tokens on your machine, the hosted server keeps them server-side; either way only tool results are returned.
No delete tools — v1 of the API is non-destructive, so an agent can't hard-delete your data.
Enrichment is opt-in and metered — kyo_enrich_company spends workspace credits and needs the enrich:write scope, which is excluded from the default sign-in grant.
Revocable — disconnect any time with kyo logout, or from Settings → API in the Kyo app.

FAQ

Is there a hosted (remote) MCP server?

Yes — https://app.trykyo.com/api/mcp. It speaks MCP over Streamable HTTP, discovers Kyo's OAuth automatically, and serves the same 36 tools as the local server. Use the local CLI server instead if you want tokens to live only on your machine.

Which scopes does the agent get?

Whatever you granted at sign-in — on the hosted server that's the consent screen shown at connect time; on the local server it's kyo login (re-run with --scope "…" to grant more or less). The default grant is full read/write on your workspace, minus enrichment.

Can an agent delete my data?

No. There are no delete tools, and the underlying API has no DELETE in v1.

Which clients are supported?

The hosted server works with claude.ai connectors, Claude Code, Cursor, and any MCP client that supports remote servers with OAuth. The local server works with Claude Desktop, Claude Code, Cursor, and any client that can launch stdio servers.