The TopK MCP server lets any MCP-compatible AI agent query your datasets using natural language. Once connected, your agent can:
List datasets — discover what data is availableAsk questions — query datasets with natural language and get grounded answers
MCP Server URL The MCP server URL is region-specific . Make sure to use the URL that matches the region where your datasets are stored, otherwise requests will fail.
The MCP server URL depends on the region where your datasets are stored:
Region MCP Server URL aws-us-east-1-elasticahttps://elastica.api.topk.io/mcpaws-eu-central-1-monsterahttps://monstera.api.topk.io/mcp
Setup Claude Desktop
Claude Code
Cursor
Windsurf
VS Code
Open your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json Alternatively, go to Settings → Developer → Edit Config . Add the following under mcpServers: 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 ${API_TOKEN}" ], "env" : { "API_TOKEN" : "your-api-key" } } } }
Restart Claude Desktop to apply the changes. Add the following to your .claude/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 ${API_TOKEN}" ], "env" : { "API_TOKEN" : "your-api-key" } } } }
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 ${API_TOKEN}" ], "env" : { "API_TOKEN" : "your-api-key" } } } }
Restart Cursor to apply the changes. Add the following to ~/.codeium/windsurf/mcp_config.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 ${API_TOKEN}" ], "env" : { "API_TOKEN" : "your-api-key" } } } }
Restart Windsurf to apply the changes. Add the following to .vscode/mcp.json: aws-us-east-1-elastica
aws-eu-central-1-monstera
{ "servers" : { "topk-elastica" : { "command" : "npx" , "args" : [ "-y" , "mcp-remote" , "https://elastica.api.topk.io/mcp" , "--header" , "Authorization: Bearer ${API_TOKEN}" ], "env" : { "API_TOKEN" : "your-api-key" } } } }
Once connected, your agent will have access to the following tools:
Lists all available datasets in your TopK project. The agent should call this first to discover what data is available before answering any data-related questions.
Queries one or more datasets using natural language and returns a grounded answer. Supports two modes:
reason (default) — multi-step search and reasoning, best for analytical or comparative questionssummarize — single search with a concise answer, best for simple lookups 
Python SDK
JavaScript SDK