Connect OpenFilings to Claude, Cursor or ChatGPT

Remote connectors are added from Settings, not by hand-editing a config file — the same mechanism as claude.ai:

1. Claude Desktop → Settings → Connectors → + → Add custom connector
2. Paste https://api.openfilings.org/mcp → Add
3. Click Connect on OpenFilings → sign in via OAuth

{
  "mcpServers": {
    "openfilings": {
      "type": "http",
      "url": "https://api.openfilings.org/mcp",
      "headers": {
        "X-API-Key": "of_your_key_here"
      }
    }
  }
}

1. claude.ai → Customize → Connectors → + → Add custom connector
2. Paste https://api.openfilings.org/mcp → Add
3. Click Connect on OpenFilings → sign in
4. New chat → + → Connectors → enable OpenFilings

Team/Enterprise: an Owner adds it first via Organization settings → Connectors → Add → Custom → Web; members then connect from Customize → Connectors.

ChatGPT connects via a custom MCP connector in the web app (Plus, Pro, Business, or Enterprise). Enable developer connectors first, then add OpenFilings:

1. Settings → Apps & Connectors → Advanced — turn on Developer mode.
2. Settings → Apps & Connectors → Create (custom connector).
3. Name: OpenFilings — URL: https://api.openfilings.org/mcp
4. Authentication: OAuth 2.0 (recommended — same DCR flow as Claude.ai; sign in with your OpenFilings account when prompted). Or API key: header X-API-Key, value your of_… key.
5. In a new chat: Tools → Use connectors — enable OpenFilings.

Sign in — then create an API key on My Page before connecting an agent.

Connector submissions may require our Privacy Policy and Terms.

Open Cursor Settings → MCP and add a remote server, or edit .cursor/mcp.json (OAuth — recommended):

{
  "mcpServers": {
    "openfilings": {
      "type": "http",
      "url": "https://api.openfilings.org/mcp"
    }
  }
}

Reload MCP, then click Connect on openfilings and sign in. Modern clients use CIMD (Client ID Metadata Document — MCP spec 2026-07-28): the client ID is an https://… metadata URL fetched from discovery. Legacy clients still register via POST /oauth/register (RFC 7591 DCR). Redirect URIs: cursor://anysphere.cursor-mcp/oauth/callback (desktop) or https://www.cursor.com/agents/mcp/oauth/callback (web / agents).

API key fallback

{
  "mcpServers": {
    "openfilings": {
      "type": "http",
      "url": "https://api.openfilings.org/mcp",
      "headers": {
        "X-API-Key": "of_your_key_here"
      }
    }
  }
}

Replace of_your_key_here with a key from My Page → API Keys.

Open a new chat and ask in plain language. The agent calls OpenFilings tools automatically.

• “What is OpenFilings' latest view on NVDA? Use search_ticker then get_company_analysis with ticker=NVDA and market=us.”
• “Call list_markets, then get_company_financials for AAPL with fiscal_year_from=2020, fiscal_year_to=2024, line_items=ebitda.”
• “When is Palantir's next earnings? Use search_ticker then get_company_financials with ticker=PLTR and market_id=us — read the earnings block.”
• “List filings for Tencent (0700) on the Hong Kong market and summarize the latest annual report.”
• “Compare revenue and net income for AAPL vs MSFT from their latest 10-K filings.”

Ask in plain language — the agent picks tools automatically. Pass market_id where noted (default us).