MCP server

Koinju runs a hosted Model Context Protocol server at https://mcp.koinju.io/mcp. It gives an AI coding agent — Claude Code, Cursor, VS Code, Codex — direct tools over the market data, so it can look up an instrument and pull candles, trades, funding or an option chain without you writing the request.

Since it uses the same api key as the rest api it shares the same limits.

Connect

Claude Code

claude mcp add --transport http koinju https://mcp.koinju.io/mcp --header "x-api-key: YOUR_API_KEY"

Codex

codex mcp add cannot set a header, so write it into ~/.codex/config.toml:

[mcp_servers.koinju]
url = "https://mcp.koinju.io/mcp"
http_headers = { "x-api-key" = "YOUR_API_KEY" }

Cursor

~/.cursor/mcp.json, or .cursor/mcp.json for one project:

{
  "mcpServers": {
    "koinju": {
      "url": "https://mcp.koinju.io/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

VS Code

.vscode/mcp.json. The key is servers, not mcpServers, and the type is required:

{
  "servers": {
    "koinju": {
      "type": "http",
      "url": "https://mcp.koinju.io/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Gemini CLI

gemini mcp add --transport http --header "x-api-key: YOUR_API_KEY" koinju https://mcp.koinju.io/mcp

Add -s user to register it for every project rather than the current one.

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "koinju": {
      "serverUrl": "https://mcp.koinju.io/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Cline

Cline panel → MCP Servers → Configure MCP Servers. Without the type, Cline falls back to the legacy SSE transport:

{
  "mcpServers": {
    "koinju": {
      "type": "streamableHttp",
      "url": "https://mcp.koinju.io/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Your key is on your dataroom credentials page, with the command above already filled in. Don't have one? Sign up at koinju.io/pricing.

First prompt

Paste this into your agent once the server is connected:

Using the Koinju MCP tools, fetch daily candles for binance BTC-USDT and binance ETH-USDT over the last 30 days. Compute daily log returns from the close prices, report the Pearson correlation for the month, and plot both normalised price series with a 7-day rolling correlation underneath. Save the chart as btc_eth_correlation.png.

Together with the agent skill

The agent skill and this server solve different halves. The skill teaches your agent the schema, the auth and the query patterns; the server hands it tools it can call. Install both: the skill makes the agent fluent in Koinju, the server saves it from writing HTTP by hand.