# sec-edgar-mcp

> A SEC EDGAR MCP (Model Context Protocol) Server

- **URL**: https://www.freshcrate.ai/projects/sec-edgar-mcp
- **Author**: stefanoamorelli
- **Category**: MCP Servers
- **Latest version**: `v1.0.8` (2026-01-25)
- **License**: AGPL-3.0
- **Source**: https://github.com/stefanoamorelli/sec-edgar-mcp
- **Homepage**: https://sec-edgar-mcp.amorelli.tech/
- **Language**: Python
- **GitHub**: 253 stars, 75 forks
- **Registry**: github
- **Tags**: `ai`, `artificial-intelligence`, `edgar`, `edgar-database`, `finance`, `genai`, `llm`, `mcp`, `python`

## Description

A SEC EDGAR MCP (Model Context Protocol) Server

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.0.8` | 2026-01-25 | Low | ## Bug Fixes  - **Fixed `get_segment_data` returning empty segments** (#47, fixes #39)   - Rewrote function to extract segment data from XBRL statements   - Now properly categorizes revenue, cost of revenue, operating income, ...   - Supports both "business" and "geographic" segment types  ## Security  - Upgraded all dependencies to resolve 20 Dependabot security alerts - Key updates: urllib3 2.4.0→2.6.3, mcp 1.7.1→1.26.0, starlette 0.46.2→0.52.1, ...  ## Installation  ```bash pip install sec-ed |
| `v1.0.7` | 2026-01-25 | Low | ## Bug Fixes  - **Fixed \`get_recent_filings\` failing when no company identifier provided** (#46, fixes #45) - Updated to use \`get_current_filings()\` from edgartools instead of deprecated \`get_filings()\` - Changed parameter from \`count\` to \`page_size\` to match upstream API - Adjusted default limit to 40 to align with edgartools defaults  Thanks to @seanq101 for the contribution! |
| `v1.0.6` | 2025-09-15 | Low | ## What's Changed  ### Documentation - Enhanced documentation structure with comprehensive guides and examples - Added detailed installation instructions including uvx method   - Improved MCP clients documentation with setup guides for multiple platforms - Simplified license page for better readability - Added local documentation serving instructions to README - Updated contributors section with GitHub profile links  ### Changes in this Release - Added remaining documentation structure for API r |
| `v1.0.5` | 2025-09-09 | Low | ## What's Changed  Patch release v1.0.5  ### Features & Improvements - Enhanced SEC EDGAR data retrieval capabilities - Improved error handling and stability - Updated dependencies  **Full Changelog**: https://github.com/stefanoamorelli/sec-edgar-mcp/compare/v1.0.4...v1.0.5 |
| `v1.0.4` | 2025-08-17 | Low | ## What's Changed  ### 🐛 Bug Fixes - Fixed 8-K filing analysis date_of_report parsing error by @harinlee83 in #28 - Fixed press_releases iteration issue in 8-K analysis by @harinlee83 in #28 - Applied ruff formatting improvements  ### 📚 Documentation - Added Contributors section with automatic contributor badges - Shows profile pictures of all contributors via contrib.rocks  ### Contributors Thanks to @harinlee83 for the bug fixes in this release!  **Full Changelog**: https://github.com/stefan |
| `v1.0.3` | 2025-08-17 | Low | ## 🔧 Conda Fix Release  ### Fixed - **Conda build**: Implemented post-link scripts solution   - Added post-link.sh (Unix/Linux/Mac) and post-link.bat (Windows)   - Scripts install mcp and edgartools via pip after conda installation   - Build now uses --no-deps to avoid dependency resolution issues    ### How it works Since mcp and edgartools aren't available on conda-forge, the conda package now: 1. Installs the base package with conda 2. Automatically runs pip to install missing dependencies p |
| `v1.0.2` | 2025-08-17 | Low | ## 🐛 Hotfix Release  ### Fixed - **Conda build**: Fixed dependency resolution issues   - Removed mcp-cli and edgartools from conda dependencies (not available on conda-forge)   - Dependencies now installed via pip during build   - Simplified runtime requirements for conda compatibility  ### Note This is a hotfix release to address the Conda build failure from v1.0.1. PyPI package remains fully functional with all dependencies.  **Full Changelog**: https://github.com/stefanoamorelli/sec-edgar-mc |
| `v1.0.1` | 2025-08-17 | Low | ## What's Changed  ### ✨ New Features - 🚀 Added PyPI publishing workflow for automated package distribution - 📦 Added Conda package build fixes with dynamic versioning from Git tags - 🧪 Comprehensive CI/CD workflow with multi-platform testing (Ubuntu, Windows, macOS)  ### 🐛 Bug Fixes - Fixed Conda build Python version requirements (3.11+ instead of 3.13) - Fixed Windows CI compatibility (removed Unicode characters) - Fixed package discovery in setuptools configuration  ### 📚 Documentation - |
| `v1.0.0-alpha` | 2025-07-20 | Low | ## What's Changed * [Feat] Release `1.0.0-alpha` by @stefanoamorelli in https://github.com/stefanoamorelli/sec-edgar-mcp/pull/18 * [Chore] Fix typing and linting issues by @stefanoamorelli in https://github.com/stefanoamorelli/sec-edgar-mcp/pull/19   **Full Changelog**: https://github.com/stefanoamorelli/sec-edgar-mcp/compare/v0.2.0...v1.0.0-alpha |
| `v0.2.0` | 2025-07-14 | Low | ## What's Changed * [Chore] Update protocol and Dockerfile by @stefanoamorelli in https://github.com/stefanoamorelli/sec-edgar-mcp/pull/12 * [Feat] Support custom protocol by @stefanoamorelli in https://github.com/stefanoamorelli/sec-edgar-mcp/pull/15 * [Chore] Add logo by @stefanoamorelli in https://github.com/stefanoamorelli/sec-edgar-mcp/pull/16 * [Feat] Introduce new tools (chunking, rss feeds, concepts extraction) by @stefanoamorelli in https://github.com/stefanoamorelli/sec-edgar-mcp/p |

## Citation

- HTML: https://www.freshcrate.ai/projects/sec-edgar-mcp
- Markdown: https://www.freshcrate.ai/projects/sec-edgar-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/sec-edgar-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._
