MCP Server

The Kyan MCP server lets AI-powered editors (Cursor, Windsurf, Claude Code, VS Code Copilot) and general-purpose tools (Claude Desktop) interact directly with the Kyan exchange API and documentation.

What is MCP?

Model Context Protocol is an open standard that gives AI applications secure access to external APIs and tools. The Kyan MCP server provides AI agents with:

API exploration — list endpoints, inspect request/response schemas, view authentication requirements
Documentation search — search across all Kyan guides (WebSocket channels, EIP-712 signatures, funding rates, etc.)
Code generation — generate working code snippets for any endpoint in any language
Live API calls — execute requests against staging or production directly from your AI assistant

Setup

Kyan hosts a remote MCP server at https://docs.kyan.blue/mcp. No installation required — just point your AI tool at the URL.

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "kyan": {
      "url": "https://docs.kyan.blue/mcp"
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "kyan": {
      "url": "https://docs.kyan.blue/mcp"
    }
  }
}

Claude Desktop

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

{
  "mcpServers": {
    "kyan": {
      "url": "https://docs.kyan.blue/mcp"
    }
  }
}

Claude Code

claude mcp add kyan --transport streamable-http https://docs.kyan.blue/mcp

With API authentication

To let your AI assistant make live API calls on your behalf, pass your Kyan API key:

{
  "mcpServers": {
    "kyan": {
      "url": "https://docs.kyan.blue/mcp",
      "headers": {
        "x-apikey": "your-kyan-api-key"
      }
    }
  }
}

Available Tools

Tool	What it does
`list-endpoints`	List all REST API paths with HTTP methods and summaries
`get-endpoint`	Full detail on a specific endpoint: parameters, auth, description
`get-request-body`	Request body schema for any endpoint
`get-response-schema`	Response schema for any endpoint and status code
`search-specs`	Search across all API paths, operations, and schemas
`execute-request`	Make a live API call and return the response
`get-code-snippet`	Generate a working code snippet in any language
`search`	Full-text search across all documentation pages
`fetch`	Read the full content of a specific guide page

Test Your Setup

Once configured, open your AI editor and try:

"List all Kyan trading endpoints"
"How do I place a limit order on Kyan?"
"Generate a TypeScript example that subscribes to BTC_USDC orderbook updates"
"What EIP-712 signature do I need to cancel orders?"
"Show me the account_state WebSocket event schema"
"What are the rate limits for the WebSocket API?"

Your AI assistant will query the Kyan API spec and documentation to answer with accurate, up-to-date information.