@shawyan/mcp-sec-server
v0.1.3
Published
An MCP server that gives any LLM structured access to SEC EDGAR data — filings, financial facts, and full-text search.
Readme
Dolph SEC Server (MCP)
An MCP server that gives any LLM structured access to SEC EDGAR data — filings, financial facts, and full-text search.
Tools
get_company_filings
Retrieve recent SEC filings (10-K, 10-Q, 8-K, DEF 14A) for a stock ticker.
Input:
{ "ticker": "AAPL", "filing_type": "10-K", "limit": 5 }Output: Array of { filing_type, date_filed, accession_number, primary_document_url, description }
get_filing_content
Fetch and parse the HTML content of a specific filing. Extracts named sections (Business, Risk Factors, MD&A, etc.).
Input:
{ "accession_number": "0000320193-24-000123", "document_url": "https://..." }get_company_facts
Retrieve structured XBRL financial data (revenue, net income, EPS, etc.) across reporting periods.
Input:
{ "ticker": "AAPL" }search_filings
Full-text search across SEC filings by keyword.
Input:
{ "query": "AI strategy", "ticker": "MSFT", "date_from": "2023-01-01" }Setup
pnpm install
pnpm buildClaude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"dolph-sec": {
"command": "node",
"args": ["/path/to/dolph/packages/mcp-sec-server/dist/index.js"],
"env": {
"DOLPH_SEC_USER_AGENT": "YourName [email protected]"
}
}
}
}Notes
- Rate limiting: Max 10 requests/second to SEC EDGAR (enforced automatically)
- Caching: Responses cached in
~/.dolph/cache/(24h for listings, 7d for content) - User-Agent: SEC requires identifying User-Agent header — set via
DOLPH_SEC_USER_AGENT
