Help centre ↗
← All help articles
MCP

FinData MCP tools and example workflows

Explore the read-only MCP tools and use them for company, fundamentals and filing research.

Company and filings

  • search_companies — search imported companies by name, ticker or CIK.
  • get_company — resolve a ticker or CIK.
  • get_filings — list up to 100 recent imported filings.
  • get_status — show the last successful import time.

Metrics and structured facts

  • list_metrics — list mapped metric definitions.
  • get_metrics — retrieve a mapped metric with optional frequency, date range, as_of and latest/history view.
  • search_structured_companies — find a company in the structured filing index by name or CIK.
  • get_structured_facts — retrieve XBRL facts for a numeric CIK, optionally filtered by tag, form, as_of and cursor.
  • get_corporate_actions — retrieve paginated reported corporate-action facts for a ticker or CIK.

Example workflow

Ask: “Find Apple, list its recent filings, and compare its directly reported quarterly revenue and net income from 2022 onward. Include the source filing and explain missing periods.” Your client can call search_companies, get_filings and get_metrics for each metric. Dates and data availability depend on imports; the client must inspect the results rather than invent a missing quarter.

For detailed filing facts, use search_structured_companies then get_structured_facts. If a response contains next_cursor, pass that value as cursor with the same filters to retrieve the next page.

Know the boundaries

Tools use the same underlying API credentials, rate limits and data limitations. Structured facts include source revisions and XBRL contexts; corporate-action facts are reporting-period facts rather than a complete dated event calendar. The MCP tool list does not currently expose every API route, including the aligned metrics-series route.