Company Research MCP

Workflow guide for using company-research as an MCP server

RiftWerx Updated

File contents

company-research MCP workflow

Canonical sequence

Call in order: search_companylist_filingsfetch_filingextract_xbrl_facts

get_latest shortcut: replaces list_filings + fetch_filing in one call (most recent filing in a category).

Key facts

  • CH numbers are zero-padded to 8 digits: 00445790 not 445790
  • list_filings common categories: accounts, confirmation-statement; omit category to discover all
  • document_id is an opaque UUID minted by list_filings/get_latest — never construct it
  • extract_xbrl_facts takes local_path (from fetch_filing/get_latest output), not document_id

ZIP archives

When fetch_filing/get_latest returns is_archive: true:

  1. Call list_zip_contents (same ch_number + document_id)
  2. Choose an entry by is_primary: true or target content_type
  3. Pass its local_path to extract_xbrl_facts

PDF-rendered iXBRL

When render_type is "pdf_rendered": XBRL facts are present but narrative text is inaccessible. Check warnings for alternative formats.

RiftWerx/company-research/tree/main/internal/skills/company-research-mcp commit 54ce4c0909

Frequently asked questions

npx skillmds@latest add riftwerx/company-research-mcp