Skip to Content
Tool ReferenceLangExtractExtract Filing File

Extract Filing File

Ingest a trusted local markdown filing and run a selected extraction schema.

Tier: internal | Cache: llm-call | Playground: authenticated only | Contract: 1.0.0

When To Use It

Use these tools for curated extraction caches and premium language-model-backed filing evidence.

Request Example

This is an MCP-only tool. Call it through an MCP client after configuring edgar-mcp.

{ "tool": "extract_filing_file", "arguments": { "file_path": "/tmp/filing.html", "schema_name": "operational_kpis" } }

Response Fields To Inspect

  • schema_name, evidence spans, and source filing metadata for every extracted claim.
  • Coverage or cache-miss fields before treating missing rows as “not disclosed.”
  • Confidence, provenance, and extraction timestamp fields when comparing periods.

Errors And Coverage

  • 401 or 403: the API key is missing, expired, or not allowed to use this tier.
  • 429: retry after the rate-limit window, and prefer broader batch or series tools over repeated single-period calls.
  • Paid or LLM-backed paths should be used only when cheaper fact, filing, table, or text tools cannot answer the question.
  • Treat partial coverage, empty arrays, and warning fields as answer-quality signals even when HTTP status is 200.

Filing Document, List Extraction Schemas, Filing Extractions

Generated Reference

Contract

FieldValue
Toolextract_filing_file
MCP toolextract_filing_file
Contract version1.0.0
Schema fingerprintsha256:509339c5ff6e48b01b5618be7f42e6f7500e0b527543f1947138ba5bda406015

MCP Signature

ParameterTypeDefault
file_pathstr-
schema_namestr-
sections_filterlist[str] | NoneNone