Korey exposes a Model Context Protocol (MCP) server so AI coding agents — Cursor, Claude Code, and others — can read from and write to your Korey workspace directly. No custom integration code needed on your part.
What is MCP?
MCP is an open standard that lets AI tools discover and call capabilities exposed by external services. Instead of each tool implementing its own Korey integration, any MCP-compatible client can connect once and get access to the same set of tools.
What Korey exposes via MCP
Once connected, an AI agent can:
- Read threads — list and retrieve conversation history from your workspace.
- Send messages — post new messages or continue existing threads.
- Create threads — start new conversations with a given name.
More tools will be added as the MCP integration matures.
Connecting a client
Korey’s MCP server endpoint is:
POST https://mcp.korey.ai/mcp MCP clients authenticate using OAuth 2.0. On first connection the client will:
- Discover Korey’s OAuth configuration automatically from
/.well-known/oauth-authorization-server. - Register itself via Dynamic Client Registration — no manual client setup required.
- Redirect you to Korey to approve the requested scopes.
- Receive tokens and connect.
After the first authorization the client stores its tokens and reconnects silently.
Setup by client
Cursor
- Open Cursor settings and navigate to MCP Servers.
- Add a new server with the URL
https://mcp.korey.ai/mcp. - Cursor will open a browser window to complete the OAuth flow.
- Once approved, Korey tools appear in Cursor’s agent tool list.
Claude Code
- Run
claude mcp add korey https://mcp.korey.ai/mcpin your terminal. - Claude Code will open a browser window to complete the OAuth flow.
- Once approved, use
@koreyin Claude Code to invoke Korey tools.
Other clients
Any MCP client that supports Streamable HTTP transport and OAuth 2.0 Dynamic Client Registration will work with https://mcp.korey.ai/mcp.
Managing MCP access
MCP clients appear as connected apps in your settings:
- Open Settings → Connected Apps.
- Find the MCP client by name (e.g. “Cursor”, “Claude Code”).
- Click Revoke to disconnect it. The client will need to go through the OAuth flow again to reconnect.
For developers: building an MCP-aware integration
If you’re building a tool that connects to Korey via MCP, the relevant endpoints are:
MCP server
POST https://mcp.korey.ai/mcp OAuth discovery
GET https://mcp.korey.ai/.well-known/oauth-authorization-server DCR endpoint
POST https://api.korey.ai/oauth/register Your client should use Dynamic Client Registration (RFC 7591) so users don’t need to register your app manually. The client_name you register with is shown on the Korey consent screen, so choose something recognizable.
See the OAuth & Connected Apps page for the full details on scopes, token endpoints, and client registration.