Financial MCP Server
An open-source Model Context Protocol server that gives any LLM live, tool-calling access to SEC filings, Federal Reserve series, and market fundamentals.
- Six typed tools across three sources, SEC EDGAR, FRED, and Alpha Vantage, that a model chains on its own: resolve a company to a CIK, pull its filings, then correlate against a macro series, without a human copying anything between tabs.
- Pydantic schemas with strict field validation reject a hallucinated argument at the boundary instead of turning it into a malformed upstream request, and an async httpx layer converts every upstream failure into a readable string, because an MCP tool cannot raise: the model has no way to catch it.
- 24 tests run with no network access, covering CIK zero-padding, SEC archive URL construction, form-type filtering, and the error contract; CI runs them on Python 3.11, 3.12 and 3.13.