SEC EDGAR MCP server for company filings and financial data
Server has 17 well-named tools with consistent verb_noun patterns (get_*, analyze_*, search_*). All tools have descriptions (avg ~120 chars, within baseline 34-392 range). Input schemas are present with type definitions and parameter descriptions. However, output schemas are NOT documented, critical gap for LLM planning. Error handling is absent; no recovery guidance or categorization. Tool descriptions lack WHEN-to-use context and dependency hints. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite all being READ_ONLY. Parameter descriptions are adequate but lack format/constraint details (e.g., 'days' has no min/max bounds). Composition is sound, each tool has one responsibility and names chain logically (search_companies → get_company_info → get_financials). Missing: output schema documentation, error handling patterns, tool annotations, and parameter constraint details.
Analyze an 8-K filing for specific events and items.
Analyze insider trading activity patterns for a company.
Compare a financial metric across different time periods.
Discover available financial metrics for a company.
Get the CIK (Central Index Key) for a company based on its ticker symbol.
Get company facts and key financial metrics.
Output schemas not documented. LLMs cannot plan downstream tool calls or extract required fields without knowing response structure. Critical for tool chaining.
No error handling or recovery guidance. Tools lack categorization (retryable vs user-fixable vs fatal) and actionable error messages. Agents cannot self-correct on failures.
Tool annotations missing. All 17 tools are READ_ONLY but lack readOnlyHint annotation. Agents cannot distinguish safe tools from destructive ones without explicit hints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
Get detailed information about a company from SEC records.
Get the content of a specific SEC filing.
Get specific sections from a filing (e.g., business description, risk factors, MD&A).
Get financial statements for a company. USE THIS TOOL when users ask for: Cash flow, cash flow statement, operating cash flow, investing cash flow, financing cash flow; Income statement, revenue, net income, earnings, profit/loss, operating income; Balance sheet, assets, liabilities, equity, cash and cash equivalents; Any financial statement data or financial metrics
Get current insider holdings for a company.
Get insider trading transactions for a company.
Get key financial metrics for a company.
Get recent SEC filings for a company or across all companies.
Get revenue breakdown by segments (geographic, product, etc.).
ADVANCED TOOL: Extract specific XBRL concepts from a filing.
Search for companies by name.
Parameter constraints underdocumented. 'days' and 'limit' parameters lack min/max bounds; 'form_type' and 'statement_type' lack enum constraints. LLMs may pass invalid values.
Descriptions lack WHEN-to-use context and dependency hints. E.g., get_financials does not mention it requires a valid identifier from search_companies or get_cik_by_ticker first.