MCP

Documentation Index

Fetch the complete documentation index at: https://docs.topk.io/llms.txt

Use this file to discover all available pages before exploring further.

• List datasets — discover what data is available
• Ask questions — query datasets with natural language and get grounded answers

​

Authentication

​

Setup

• Claude Code
• Codex
• Claude Desktop
• Cursor

aws-us-east-1-elastica

claude mcp add --transport http topk https://elastica.api.topk.io/mcp \
--header "Authorization: Bearer <your-topk-api-key>"

aws-eu-central-1-monstera

claude mcp add --transport http topk https://monstera.api.topk.io/mcp \
--header "Authorization: Bearer <your-topk-api-key>"

aws-us-east-1-elastica

codex mcp add topk --url https://elastica.api.topk.io/mcp --bearer-token-env-var TOPK_API_KEY

aws-eu-central-1-monstera

codex mcp add topk --url https://monstera.api.topk.io/mcp --bearer-token-env-var TOPK_API_KEY

You need to set the TOPK_API_KEY environment variable that Codex will use in the Authorization header.

1

Open Developer Settings

Go to Settings → Developer -> Edit Config.

Make sure you have Developer Mode enabled in Claude Desktop.

2

Open Config File

Open your Claude Desktop JSON config file:

3

Add TopK MCP

Add the following under mcpServers and provide your API key:

aws-us-east-1-elastica

aws-eu-central-1-monstera

{
  "mcpServers": {
    "topk": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://elastica.api.topk.io/mcp",
        "--header",
        "Authorization: Bearer ${TOPK_API_KEY}"
      ],
      "env": {
        "TOPK_API_KEY": "your-api-key-here"
      }
    }
  }
}

Make sure you have Node.js installed with version 20 or higher.

4

Restart Claude Desktop

Restart Claude Desktop to apply the changes.

Add the following to ~/.cursor/mcp.json:

aws-us-east-1-elastica

aws-eu-central-1-monstera

{
  "mcpServers": {
    "topk-elastica": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://elastica.api.topk.io/mcp",
        "--header",
        "Authorization: Bearer ${TOPK_API_KEY}"
      ],
      "env": {
        "TOPK_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Cursor to apply the changes.

​

Available tools

1. Call list_datasets to discover what datasets are available
2. Select one or more relevant datasets
3. Call ask with a natural language query and the selected datasets

​

list_datasets

​

ask

• auto (default) — chooses the best mode based on the provided query
• summarize — gathers information from the datasets and returns a concise answer
• research — multi-step search and reasoning, best for analytical or comparative questions