edgar13f-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SEC_USER_AGENT | Yes | The User-Agent sent to sec.gov. It is required; without it the server does not contact sec.gov. | |
| EDGAR13F_REDACT | No | Set to exactly off to return rows that are redacted by default. Any other value, or none, keeps redaction on. | |
| EDGAR13F_CACHE_DIR | No | The on-disk cache directory. The default is $XDG_CACHE_HOME/edgar13f (or ~/.cache/edgar13f), then a private per-user temp dir. | |
| EDGAR13F_AGENT_MODE | No | Set to exactly on to cap unnarrowed holdings and diff answers at the 50 largest positions. Unset, every v1 call answers byte for byte as in v1.1.0. | |
| EDGAR13F_FIXTURE_DIR | No | Serve recorded fixtures instead of EDGAR. Used by the tests; refused together with EDGAR13F_REDACT=off. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| find_managerA | Find a manager's CIK from its name (a case-insensitive substring of current or former EDGAR entity names). Candidates that have filed Form 13F come first. Use it before the other tools when you only know the name. entity_name is EDGAR's current name (not point-in-time); with as_of, has_13f_filings counts only 13F filings dated on or before as_of. |
| list_13f_filingsA | Every Form 13F submission (13F-HR, 13F-HR/A, 13F-NT, 13F-NT/A) by the manager whose EDGAR filing date is on or before as_of (what was publicly filed by then). Pass period to list only the filings for one report period. |
| get_holdings_as_ofA | Effective 13F holdings of the manager for one report period as knowable on as_of (point-in-time and amendment rules), with the accession number(s) they come from. Large managers file tens of thousands of rows: narrow with issuer, cusip or max_positions. as_of means what was publicly filed by that date. |
| diff_holdingsA | Position-level changes between period_a and period_b, each computed with get_holdings_as_of rules on the same as_of and consolidated by (cusip, put_call, sh_prn). Large managers file tens of thousands of rows: narrow with issuer, cusip or max_positions. as_of means what was publicly filed by that date. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a distinct role: resolving a manager, listing filings, retrieving point-in-time holdings, and computing position changes. The overlap between get_holdings_as_of and diff_holdings is well bounded by comparison versus snapshot semantics.
All tools use snake_case with a leading action verb and clear resource noun: find_manager, list_13f_filings, get_holdings_as_of, diff_holdings. The longer temporal qualifier in get_holdings_as_of is descriptive rather than inconsistent.
Four tools are well scoped for a manager-centric 13F research server. Each tool supports a necessary step in the workflow, with no redundant or filler operations.
The core workflow is covered: find a manager, list filings, retrieve holdings as of a date, and diff periods. Minor gaps remain around direct CIK/ticker lookup and filing-level metadata inspection, but agents can work around these through existing tools.