Connect MetricDuck to your AI agent

MetricDuck gives your agent first-source financial data — SEC financials, filings, earnings-call signals, and raw XBRL for 5,500+ US public companies — as callable MCP tools, every figure traceable to its source. It screens, compares, and reads filings mid-conversation in Claude, Cursor, ChatGPT, or any MCP client.

See example workflows ↗ · Prefer the REST API? Quickstart →

Fastest: let Claude Code set it up

Paste this — it adds the server, signs you in once (a browser opens), and confirms with a real query. No JSON, no API key.

Add the MetricDuck MCP server to my MCP client. It is a remote streamable-HTTP server at https://mcp.metricduck.com/mcp (no API key needed — it opens a browser once to sign in). After adding it, call its search_companies tool for "Apple" to confirm the tools are available.

Free, no credit card — 500 tool calls/day, 5,500+ companies, 10+ years. One account — your website dashboard, your AI agents, and the API all share it.

Claude Code

Add the server with one command:

claude mcp add --transport http -s user metricduck https://mcp.metricduck.com/mcp

-s user registers it for every project; use -s project for just the current repo.

Then sign in (one command, or skip it — auth also triggers on first tool use):

claude mcp login metricduck

Your browser opens once for a quick Google/GitHub sign-in; after that it's automatic. On a remote or SSH session, add --no-browser to get a URL you can open anywhere and paste the redirect back.

Prefer a config file? Add this to .mcp.json:

{
  "mcpServers": {
    "metricduck": {
      "type": "http",
      "url": "https://mcp.metricduck.com/mcp"
    }
  }
}
Claude Desktop

Same as claude.ai — add it in the app: Settings → Connectors, click Add custom connector, paste the URL, then finish the one-time browser sign-in. The tools appear in any chat. (Every plan, including Free.)

https://mcp.metricduck.com/mcp

On an older build, or prefer a config file? Bridge the remote server with mcp-remote in claude_desktop_config.json (Settings → Developer → Edit Config), then fully quit and relaunch:

{
  "mcpServers": {
    "metricduck": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.metricduck.com/mcp"]
    }
  }
}
Claude.ai (web & mobile)

Works on every Claude plan — including Free (Free allows one custom connector, and MetricDuck is the one you want). Open Settings → Connectors, click Add custom connector, paste the URL below, then finish the one-time Google/GitHub sign-in. The tools appear in any chat afterward.

https://mcp.metricduck.com/mcp

Menus move occasionally — see Anthropic's help center if a label has changed.

Cursor

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) — or use Settings → MCP → Add new server:

{
  "mcpServers": {
    "metricduck": {
      "type": "http",
      "url": "https://mcp.metricduck.com/mcp"
    }
  }
}
ChatGPT

ChatGPT connects to remote MCP servers as connectors (paid plans, with connectors / developer mode enabled). In Settings → Connectors, choose Add custom connector, paste the URL below, and complete the one-time Google/GitHub sign-in — the tools then show up in chat and the composer's connector menu.

https://mcp.metricduck.com/mcp

The exact steps and plan availability change often — see OpenAI's remote-MCP docs. Building on the API? The Responses API accepts the same URL as a remote MCP tool.

Any MCP client

Windsurf, VS Code, Zed, or your own agent — paste the URL into the client's MCP settings, or add the standard config. Transport is Streamable HTTP with automatic OAuth 2.1.

{
  "mcpServers": {
    "metricduck": {
      "type": "http",
      "url": "https://mcp.metricduck.com/mcp"
    }
  }
}
Headless agents & CI

For automated pipelines with no browser, authenticate with an API key instead of OAuth:

{
  "mcpServers": {
    "metricduck": {
      "type": "http",
      "url": "https://mcp.metricduck.com/mcp",
      "headers": {
        "Authorization": "Bearer fda_your_api_key_here"
      }
    }
  }
}

Get your API key from the dashboard, then send it as Authorization: Bearer fda_… (no extra quotes or spaces).

Verify it works

Used the agent setup prompt? It already confirmed the tools. Otherwise, ask your assistant:

Search for Apple on MetricDuck and give me a quick overview.

Your browser opens once for sign-in. After that, every tool works automatically.

Tools

20 MCP tools across signal triage, filing extraction, peer comparison, and full-text search. See the live tool reference for the current list and per-tool docs.

FAQ

What is MetricDuck?

SEC filing intelligence for AI agents. MetricDuck processes SEC filings (10-K, 10-Q, 8-K, DEF 14A proxy statements, and Foreign Private Issuer forms 20-F / 6-K / 40-F) into structured financial data, derived metrics, and LLM-generated filing analysis for 5,500+ US-listed companies.

How much does it cost?

Free tier: 500 tool calls/day, no credit card. Pro: $20/mo or $200/year for 50,000 tool calls/month. See pricing.

What AI clients work with MetricDuck?

Any MCP-compatible client: Claude Code, Claude Desktop, Claude.ai (custom connector), Cursor, ChatGPT (as a connector), Windsurf, VS Code, and custom agents. Streamable HTTP transport with automatic OAuth 2.1 (or an API key for headless use).

Where does the data come from?

Multiple sources: SEC filings (financial statements & XBRL, parsed directly from EDGAR), earnings-call transcripts and IR disclosures for qualitative signals, and a daily end-of-day market-data feed for prices. Full breakdown: Data sources & provenance.

Troubleshooting

Your client doesn't show MetricDuck tools

Fully quit and relaunch the client (don't just close the window). Validate your MCP config JSON — a missing comma or bracket silently disables the server. Then trigger sign-in: in Claude Code run claude mcp login metricduck (or /mcp → select metricduck → Authenticate).

Authentication errors (401 / "unauthorized")

OAuth: re-run the browser sign-in (tokens expire). API key: send it as Authorization: Bearer fda_… with no extra quotes or spaces; get or rotate keys in the dashboard. The free tier includes MCP access — no paid plan required.

Connection or timeout errors

Confirm you can reach metricduck.com in a browser; corporate VPNs and firewalls can block outbound MCP traffic. Break very large requests (many companies × many years) into smaller asks. Check status.metricduck.com for incidents.

Stale or unexpected data

Companies report on different schedules — a recent quarter may not be filed yet. Confirm the ticker (watch share classes like GOOGL vs GOOG) and whether you asked for quarterly vs annual. Genuinely wrong numbers? Email [email protected] with the ticker and date.

Still stuck? [email protected] — include your client and version, the exact error, and the steps you tried.

metricduck.com