kodros-sec-edgar-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
kodros-sec-edgar-mcp
A read-only MCP server that gives an AI assistant numbers from SEC EDGAR filings. Every figure comes back with the filing it came from: accession number, form, filed date and XBRL tag.
Part of the Kodros local AI stack.
How it works
flowchart LR
Client[MCP client: Claude, Hermes, OMP] -->|stdio| Server[server.py: 18 fs_* tools]
Server --> Core[core.py: HTTP, cache, EDGAR normalizing]
Core -->|8 req/s, contact User-Agent| SEC[sec.gov and data.sec.gov]
Core --> Cache[(disk cache)]
Collector[sec-edgar-collect CLI] --> Signals[signals_sec.py, signals_mkt.py]
Signals --> DB[(SQLite signal store)]
Outcomes[outcomes.py: 1/5/10/20 day forward returns] --> DB
Server --> DBcore.py has no MCP imports, so it tests offline. The tools cover company lookup, reported XBRL series with restatements flagged, a fundamentals snapshot, side-by-side comparison of up to 8 companies, reading one Item of a filing, Form 4 insider trades, price history and a DCF calculator that fetches nothing. A collector sweeps the EDGAR daily index and grades each signal type against an equal-weight control. No language model sits in the data path. Missing data comes back as null, never zero.
Related MCP server: filingrail-mcp
Stack
Python 3.12, FastMCP 3, httpx, defusedxml for filing XML, SQLite, uv, pytest.
Run
uv sync
export SEC_EDGAR_USER_AGENT="my-app you@example.com" # required by the SEC
uv run pytest
uv run sec-edgar-mcp # stdio MCP server
uv run sec-edgar-collect sec --days 2 # fill the signal storeMCP client config:
{ "mcpServers": { "sec-edgar": {
"command": "uv", "args": ["run", "--directory", "/path/to/kodros-sec-edgar-mcp", "sec-edgar-mcp"],
"env": { "SEC_EDGAR_USER_AGENT": "my-app you@example.com" } } } }Optional: SEC_EDGAR_CACHE (default ~/.cache/sec-edgar-mcp) and SEC_EDGAR_DB (default ~/.local/share/sec-edgar-mcp/signals.db).
Status and limits
Version 0.1.0. The offline test suite covers the math, signal scoring, XML entity rejection and outcome grading. Live smoke scripts in
tests/need network.Requests to sec.gov are throttled to about 8 per second, under the SEC limit of 10.
Price data uses Yahoo's unofficial chart endpoint, which can change without notice. Prediction market reads use public Polymarket and Kalshi APIs.
The signal universe is today's liquid tickers, so backtests carry survivorship bias.
No order, transfer or account tools. Output is research data, not investment advice.
License
Copyright 2026 Tanner Osterkamp. All rights reserved. See LICENSE. The source is public to read; ask before reuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
SEC-filed company financials with filing citations, plus market data, for AI agents
Provide AI assistants with real-time access to official SEC EDGAR filings and financial data. Enab…
SEC EDGAR financials, insider trading, and economic data for AI agents. US GAAP + IFRS.
SEC EDGAR filings for AI agents: company lookup, filings, financials, insider trades. No keys.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides AI assistants with real-time stock prices, financial statements, SEC filings, and analytical tools like DCF valuation and ratio analysis.14-
- AlicenseAqualityCmaintenanceGive your AI agent live SEC EDGAR data: company financials, insider trades, 8-K events, 13F holdings, and the raw filings stream — all normalized to clean JSON, every number traceable back to its sec.gov source filing.843 PyPIMIT
- FlicenseNot gradedqualityDmaintenanceProvides AI assistants direct access to SEC EDGAR filing data — financials, filings, and filing text — with no API key required.-
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to SEC EDGAR filings for retrieving company data, financial statements, and insider transactions with exact precision.1MIT