MCP Server

Model Context Protocol

Connect any AI assistant (Claude, GPT-4, Cursor…) directly to Mindstk financial data. 53 tools — 17 data tools and 36 AI analysis tools — all accessible via your API key.

What is MCP?

The Model Context Protocol is an open standard by Anthropic that lets AI assistants call external tools in a structured, secure way. Instead of pasting data into a conversation, the AI calls a Mindstk tool directly, gets structured financial data back, and uses it to answer your question in real time.

Real financial data

Live prices, fundamentals, ratios, news — straight from the Mindstk database.

AI analysis on demand

Investment thesis, risk profiles, earnings previews generated per request.

Same API key, same quotas

One key works everywhere. AI tools count on the AI quota, data tools on the standard quota.

Quota & billing

Standard tools (17)

Counts only against your standard request quota. Includes market data, fundamentals, ratios, screener, news, watchlists, peer comparisons.

AI tools (36)

Counts against both the standard and AI quotas. Includes all narrative, thesis, risk, earnings, sector, and portfolio analysis tools.

How to connect

1. Get your API key

Create an account and generate a key from your API Keys dashboard.

Recommended

Claude Code — .mcp.json

Create a .mcp.json file at the root of your project (or ~/.claude.json for global access). The "type": "http" field is required — without it, auth headers are ignored.

{
  "mcpServers": {
    "mindstk": {
      "type": "http",
      "url": " https://api.mindstk.io/v1/mcp/",
      "headers": {
        "Authorization": "Api-Key YOUR_API_KEY"
      }
    }
  }
}

Or via CLI:

claude mcp add --transport http mindstk  https://api.mindstk.io/v1/mcp/ \
  --header "Authorization: Api-Key YOUR_API_KEY"

Claude Desktop — claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mindstk": {
      "url": " https://api.mindstk.io/v1/mcp/",
      "headers": {
        "Authorization": "Api-Key YOUR_API_KEY"
      }
    }
  }
}

Server endpoint:

 https://api.mindstk.io/v1/mcp/

Test with curl

List all tools:

curl -X POST  https://api.mindstk.io/v1/mcp/ \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Call a tool:

curl -X POST  https://api.mindstk.io/v1/mcp/ \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_ascore",
      "arguments": { "tickers": "AAPL,NVDA,MSFT" }
    }
  }'

How it works

1
You ask a question
"What is the investment case for NVIDIA given its current valuation?"
2
The AI selects tools
Claude calls get_ascore, get_ratios, and get_investment_rational for NVDA automatically.
3
Mindstk returns real data
The MCP server fetches live data, validates your key, and increments your quota.
4
The AI synthesises
Claude combines structured financial data with its own analysis to give a complete answer.

Tool catalog

(53 tools — click to expand)

Data tools

17 tools — standard quota

AI analysis tools

36 tools — AI quota

Protocol reference

Supported methods

initialize — handshake, server info
tools/list — full tool catalog
tools/call — execute a tool

Error codes

-32700 — Parse error
-32600 — Invalid request
-32601 — Method not found
-32001 — Auth / invalid key
-32005 — Rate limit exceeded
-32603 — Tool execution error

// Tool response format
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{ "type": "text", "text": "..." }]
  }
}