Connect MetricDuck to your AI agent

ChatGPT

Open MetricDuck in ChatGPT, press Install plugin, then Sign in with MetricDuck. Works on every ChatGPT plan, including Free.

Back in ChatGPT, start a new chat, type @ and choose MetricDuck from the list, then ask your question (or pick MetricDuck from the + menu). Try: “Show me Meta's income statement for the last 8 quarters” (more prompts).

Can't install the app? Business, Enterprise and Edu workspaces (and Pro, read-only) can add the URL above as a custom MCP server: see OpenAI's guide.

Claude (claude.ai and Claude Desktop)

MetricDuck is in Claude's connector directory: open its page (sign-in required), or in Claude go to Customize → Connectors → search “MetricDuck” → Connect.

Back in Claude, start a new chat and check MetricDuck is switched on under + → Connectors. Then ask a question like: “Show me Meta's income statement for the last 8 quarters” (more prompts). Claude calls the tools by itself once MetricDuck is on.

Not listed for you? Go to Customize → Connectors → Add custom connector, paste the URL above, press Add, then sign in. Works on every Claude plan; Free allows one custom connector.

An older Claude Desktop build? Bridge the server with mcp-remote in claude_desktop_config.json (Settings → Developer → Edit Config), then quit and relaunch:

{
  "mcpServers": {
    "metricduck": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.metricduck.com/mcp"]
    }
  }
}

Claude Code

Already added MetricDuck in claude.ai? If Claude Code is signed in with that Claude account (a claude.ai subscription login, not an API key), it already has MetricDuck: /mcp lists it as claude.ai MetricDuck. Nothing to add.

Otherwise:

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

-s user adds it to every project. Then sign in once:

claude mcp login metricduck

Your browser opens once. On a remote or SSH session, add --no-browser and open the URL it prints. If you also have the claude.ai connector, the server you add here replaces it in Claude Code.

Cursor

Install in Cursor (opens Cursor), or add this to ~/.cursor/mcp.json:

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

VS Code

Install in VS Code (opens VS Code), or run this in a macOS or Linux shell:

code --add-mcp '{"name":"metricduck","type":"http","url":"https://mcp.metricduck.com/mcp"}'

Other clients

Codex, Windsurf, Zed, Grok and other MCP clients: paste the URL above into the client's MCP or connector settings. Config key names differ by client, so follow its docs. The server uses Streamable HTTP and signs you in with OAuth.

Or give this to an agent that can edit its own MCP config:

Headless agents and CI

With no browser to sign in, use 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 an API key from the dashboard and send it as Authorization: Bearer fda_…. Building on the REST API instead? See the API docs.

First prompts

• Show me Meta's income statement for the last 8 quartersCopy
• Compare Apple and Microsoft operating margins over the last 5 yearsCopy
• Did Broadcom beat its revenue guidance last quarter?Copy

Check the receipts

This prompt returns figures that each link to the SEC filing they came from, plus what management guided, with who said it:

Troubleshooting

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

For agents and developers

Server URL

https://mcp.metricduck.com/mcp (Streamable HTTP)

Add it

ChatGPT: the MetricDuck app · Claude: the connector directory · any other MCP client: setup steps

Auth

OAuth 2.1 with dynamic client registration, or an API key as Authorization: Bearer fda_…

Access

Read-only data tools; send_feedback sends your message to the MetricDuck team.

Limits and cost

Free: 500 tool calls/day (resets 00:00 UTC), no card. Pro: $20/month or $200/year for 50,000 tool calls/month. Pricing

Tools (23)

• browse_company — Entity-axis orientation map for one company. Returns identity, filing inventory by form type,…
• search_companies — Find companies matching a name, ticker, or keyword.
• get_company_overview — Everything about a company in one call: profile, profitability (ROE, ROIC, margins),…
• get_stock_price — Daily end-of-day closes (close as traded, plus split-adjusted adj_close; OHLC and volume may…
• get_financials — Multi-period financial statement data: income statement, balance sheet, cash flow. Quarterly…
• compare_companies — Benchmark a company against its sector peers across ~70 metrics: its rank among them (1 =…
• screen_companies — Filter companies by financial metrics. Define metric thresholds with operators…
• list_filings — Browse SEC filings for a company with section-level inventory — available sections, word…
• get_filing_section — Read specific sections from SEC filings with pagination. Supports 70 section types for…
• get_xbrl_facts — Search raw XBRL facts by human-readable label, with dimensional breakdowns (segment,…
• get_filing_index — Compact signal map of a single filing — what's interesting and where. Use this first to…
• screen_filing_signals — Cross-company screening by qualitative signals — tone shifts, earnings beats/misses, guidance…
• search_sec_filings — Full-text search of SEC filings since 2001 (not just MetricDuck-tracked tickers); the window…
• get_earnings — 8-K earnings-RELEASE headline financials (revenue, net income, operating income, diluted EPS)…
• get_guidance_vs_actual — Cross-feed temporal join: stitches together transcript guidance items, the SEC filing for the…
• compare_earnings_calls — Cross-quarter trajectory view of earnings-call signals for one ticker — guidance deltas,…
• get_metric_history — Time series for a single metric across recent fiscal periods. Each row carries fiscal_year +…
• get_metric_lineage — The derivation of one COMPUTED metric — its human-readable formula plus immediate inputs (each…
• get_ir_documents — IR earnings-PRESENTATION-DECK text — forward guidance, operational KPIs, and segment outlook…
• get_company_events — A company's IR event CALENDAR — upcoming and past investor-relations events (earnings calls,…
• get_earnings_reports — Per-fiscal-period earnings DOCUMENT INDEX — one row per quarter/year gathering the documents…
• list_recent_filings — Universe-wide feed of extracted filings by SEC filing date since a floor. A small share are…
• send_feedback — Sends your feedback to the MetricDuck team: missing data, a value that looks wrong, or…

References

Tool reference · llms.txt · OpenAPI (REST) · MCP Registry