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
401or403: 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.
Related Tools
Filing Document, List Extraction Schemas, Filing Extractions
Generated Reference
Contract
| Field | Value |
|---|---|
| Tool | extract_filing_file |
| MCP tool | extract_filing_file |
| Contract version | 1.0.0 |
| Schema fingerprint | sha256:509339c5ff6e48b01b5618be7f42e6f7500e0b527543f1947138ba5bda406015 |
MCP Signature
| Parameter | Type | Default |
|---|---|---|
file_path | str | - |
schema_name | str | - |
sections_filter | list[str] | None | None |