MCP server

Endpoint

Claude, ChatGPT, Claude Code, Codex, Grok and Hermes sign in with OAuth. Cursor and VS Code use a key for now. Create one on API keys. A key is also the fallback for CI.

https://mcp.data.finks.ai/mcp

Add it to your client

claude mcp add --transport http --scope user finks-api https://mcp.data.finks.ai/mcp

claude mcp add --transport http --scope project finks-api \
  https://mcp.data.finks.ai/mcp \
  --header 'Authorization: Bearer ${FINKS_API_KEY}'

codex mcp add finks-api --url https://mcp.data.finks.ai/mcp
codex mcp login finks-api

[mcp_servers.finks-api]
url = "https://mcp.data.finks.ai/mcp"
bearer_token_env_var = "FINKS_API_KEY"

{
  "mcpServers": {
    "finks-api": {
      "url": "https://mcp.data.finks.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FINKS_API_KEY}"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "finks-api-key",
      "description": "Finks API key",
      "password": true
    }
  ],
  "servers": {
    "finks-api": {
      "type": "http",
      "url": "https://mcp.data.finks.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:finks-api-key}"
      }
    }
  }
}

gemini mcp add --scope user --transport http \
  --header 'Authorization: Bearer ${FINKS_API_KEY}' \
  finks-api https://mcp.data.finks.ai/mcp

mcp_servers:
  finks-api:
    url: https://mcp.data.finks.ai/mcp
    auth: oauth

CLI

Claude Code, Codex and Gemini CLI. The commands are with each client above: Claude Code and Codex sign in, and Gemini CLI reads FINKS_API_KEY.

• Claude Code
• Codex
• Gemini CLI

Tools

Each tool calls one route with the same filters and limits as the API.

finks_searchPOST /v1/search

Search briefs, articles, filings and earnings call transcripts with the same filters as the API. Its input schema is the live tool schema.

finks_get_contentGET /v1/content/{id}

The whole record behind any result id.

finks_list_filing_eventsGET /v1/content

Filing events, newest first, after a summary header; filings sent together stay together. Page back with `older`.

finks_accountGET /v1/account

Your account, plan limits, usage and masked keys. Not metered.

finks_account_usageGET /v1/account/usage

Usage for one month, the current UTC month by default. Not metered.

finks_search_fieldsGET /v1/search/fields

The search catalog and the result fields your key can see. Not metered.

finks_screenerPOST /v1/screener

Screen listed companies with a normalized query or in plain words.

finks_screener_fieldsGET /v1/screener/fields

The screener's fields, operators, units and values. Not metered.

finks_get_eventGET /v1/events/{ledger_event_id}

One filing event by its ledger id.

finks_datasetsGET /v1/datasets

Every dataset Finks serves, with its routes and source, and whether your plan includes it. Not metered.

finks_latest_filingsGET /v1/companies/{symbol}/events?types=filing

A company's newest SEC filings, newest first.

Errors

A refused call returns a tool error with the API's error code and request_id. Errors lists the codes.