Financial data MCP

One-line MCP connect

Hosted MCP over HTTPS: JSON-RPC 2.0 POST to https://data.finuties.com/mcp/jsonrpc (protocol 2024-11-05, stateless, no streaming).

https://data.finuties.com/mcp/jsonrpc
Authorization: Bearer fin_sk_YOUR_KEY

Same key as REST, free with a FinUties account · Connector manifests in repo distribution/.

Five-minute quickstart

1. Get credentials — a free public-test key (90 days of access to all seven P0 domains over REST and MCP; Join the waitlist).
2. Point your agent at MCP — URL https://data.finuties.com/mcp/jsonrpc with Authorization: Bearer fin_sk_… (or X-API-Key).
3. Run a P0 recipe — GET /api/v1/recipes/13f-qoq (or calendar / Fed panel), then MCP tool query.

Freshness for the seven P0 domains is published at https://data.finuties.com/api/v1/status/p0. The MCP freshness tool is currently disabled. Broader catalogue rows may appear in discovery as research backlog — not as a freshness promise.

{
  "mcpServers": {
    "finuties": {
      "url": "https://data.finuties.com/mcp/jsonrpc",
      "headers": {
        "Authorization": "Bearer fin_sk_YOUR_KEY"
      }
    }
  }
}

Endpoints

• Canonical — POST https://data.finuties.com/mcp/jsonrpc
• Legacy alias — POST /mcp-legacy/jsonrpc
• Server info — GET /mcp/
• Protocol version: 2024-11-05

Copy-paste curls

Every MCP request, including tools/list, needs a fin_sk_ key or a signed-in session.

# Public REST catalogue (no token)
curl -sS "https://data.finuties.com/api/v1/resources"

# MCP list_resources (token required)
curl -sS -X POST https://data.finuties.com/mcp/jsonrpc \
  -H "Authorization: Bearer $FINUTIES_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_resources",
      "arguments": {}
    }
  }'

# P0 example — recent SEC filings
curl -sS -X POST https://data.finuties.com/mcp/jsonrpc \
  -H "Authorization: Bearer $FINUTIES_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "query",
      "arguments": {
        "domain": "filings",
        "resource": "submissions",
        "limit": 10,
        "order_by": "filed_at",
        "order_dir": "desc"
      }
    }
  }'

MCP resources

Besides tools, clients can resources/read URIs such as finuties://resources, finuties://domains, finuties://assets/translate/help, and sec://filings/latest.

Auth & billing

Use the same credentials as REST (Authorization: Bearer or X-API-Key). Authenticated non-admin query tool calls apply the same variable token pricing and tier rate limits as the matching REST read. Insufficient balance returns HTTP 402; rate limits return HTTP 429. The free public-test key covers P0 + MCP only — see pricing.

Core tools

• query — deep data access by domain/resource
• list_resources / get_resource_details — catalogue discovery
• get_query_options — accepted filters, ranges and sorting
• translate_assets — normalise symbols, ISINs, CIKs and contract codes
• Economic calendar helpers (get_economic_calendar_events, sources, fill reports)

Freshness: the MCP freshness tool (get_resource_freshness) is currently disabled and is not listed in tools/list; please check the dates in returned rows before relying on a print. Short hour figures on Status (e.g. equities 6h) are collector heartbeat targets — not content age. Heartbeat green is not freshness — see /status and /llms.txt.