Financial data MCP

One-line MCP connect

Hosted Streamable HTTP / JSON-RPC URL (Claude Connectors & Cursor):

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

Instant key: curl -sS -X POST https://data.finuties.com/api/v1/auth/sandbox · Connector manifests in repo distribution/.

Five-minute quickstart

1. Get credentials — register for a free public-test key (full P0, 90 days), or timed sandbox via POST /api/v1/auth/sandbox for a quick smoke test.
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 and get_resource_freshness.

We promise freshness on seven data domains only. 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

Catalogue discovery is public. Metered MCP tool calls require the same API token as REST.

# 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"
      }
    }
  }'

# Freshness check before production jobs
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": 3,
    "method": "tools/call",
    "params": {
      "name": "get_resource_freshness",
      "arguments": { "domain": "filings", "resource": "submissions" }
    }
  }'

MCP resources

Besides tools, clients can resources/read URIs such as finuties://resources, finuties://domains, 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. Design-partner access is free or heavily discounted until the Great stage — see pricing.

Core tools

• query — deep data access by domain/resource
• list_resources / get_resource_details — catalogue discovery
• get_query_options / get_resource_freshness
• Economic calendar helpers (get_economic_calendar_events, sources, fill reports)

Freshness: call get_resource_freshness before trusting a series for production jobs. P0 budgets are published in hours (e.g. equities ~6h, filings ~24h, calendar ~12h) — see About and /llms.txt.