Connect Cursor to Kepos via MCP — Kepos

What you need

• A Kepos account and either a token from /me/mcp-tokens or an OAuth-capable Cursor setup.
• A Cursor project or user MCP settings file.
• The remote server URL https://kepos.app/mcp.

Set up Cursor

1. 1

   Create access

   Sign in to Kepos, open /me/mcp-tokens, create a token for Cursor, and copy its secret immediately. The token UI lets you choose the scopes and spaces the client may reach. OAuth-capable clients may use Kepos's OAuth discovery instead; the discovery document advertises authorization, token, and registration endpoints.

2. 2

   Add Kepos to the client

   Use this client configuration and replace the example token with the secret you copied.

   {
     "mcpServers": {
       "kepos": {
         "url": "https://kepos.app/mcp",
         "headers": { "Authorization": "Bearer mn_YOUR_TOKEN" }
       }
     }
   }

3. 3

   Save and connect

   Save the configuration, restart or reconnect Cursor, and use https://kepos.app/mcp as the remote MCP server. The endpoint accepts Streamable HTTP requests and returns the MCP session id for subsequent calls.

Run the first function test

After Cursor reports the server as connected, have the agent read agent-onboarding and call chat_register. Do not start by creating a note: search_notes must come first in the same session.

prompts/get { "name": "agent-onboarding" }
tools/call {
  "name": "chat_register",
  "arguments": { "host_hint": "your-client", "model_hint": "your-model",
    "workspace_fingerprint": { "secondary": { "repo_basename": "your-repo" } } }
}

Troubleshooting