Corporate-disclosure research across 26 official sources and 21 jurisdiction routes behind ten intent-based tools, as a TypeScript library and MCP server.
Strong foundation with clear, domain-specific tool names and comprehensive descriptions (avg 180 chars). All 10 tools have explicit schemas with typed parameters and descriptions. Tool annotations (readOnlyHint, destructiveHint) are properly declared. Key gaps: output schemas are not declared (tools emit structuredContent additively but don't validate it), error handling lacks recovery guidance (no 'try search_*' hints), and parameter descriptions could specify format/constraints more explicitly (e.g., jurisdiction codes, filing intent enums). CompanyDocument's dual mode (pdf/text) is well-documented but lacks dry-run confirmation for destructive pdf-save path.
Retrieve a corporate filing document (PDF or text) from 26 official sources across 21 jurisdictions. Supports mode='pdf' (saves to local disk) or mode='text' (extracts text content).
Search corporate filings (annual reports, quarterly reports, prospectuses, insider forms, ownership disclosures) across 26 official sources and 21 jurisdictions.
Extract financial facts (revenue, net income, assets, liabilities, equity, cash flow) from corporate filings across 26 official sources and 21 jurisdictions.
Search insider trading disclosures (directors, officers, significant shareholders) across 26 official sources and 21 jurisdictions.
Search ownership disclosures (major shareholders, beneficial owners, significant holdings) across 26 official sources and 21 jurisdictions.
Resolve a company identifier (LEI, ISIN, stock code, registration number, or name) across 26 official sources and 21 jurisdictions to canonical entity records with source URLs and identifiers.
Output schemas not declared. Tools emit structuredContent additively but don't declare outputSchema in registration, preventing MCP SDK validation and client schema discovery.
Error handling lacks recovery guidance. Errors return raw messages without actionable next steps (e.g., 'Try search_* with partial name' or 'Unsupported jurisdiction, see jurisdictions-index resource').
Parameter constraints not fully specified. 'jurisdiction' and 'intent' parameters lack enum constraints or format descriptions; LLMs must infer valid values from prose or trial-and-error.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 65 | 2026-07-28+ | v2 |
Trace ownership chains and consolidation parents through GLEIF Level 2 relationships (accounting-consolidation parents reported for LEI compliance, not market-disclosure ownership stakes).
Search officer and director appointments across 26 official sources and 21 jurisdictions.
Search disqualified officer and director records across 26 official sources and 21 jurisdictions.
Search private capital raises (venture funding, private equity, debt issuance) across 26 official sources and 21 jurisdictions.
CompanyDocument lacks confirmation/dry-run for destructive pdf-save mode. Agents could accidentally overwrite files without explicit confirmation.
No pagination parameters (limit, offset, cursor) visible in tool schemas. Large result sets risk context window exhaustion; tools should cap results and offer pagination.