Free client for Arkleon's point-in-time SEC fundamentals: filing-dated facts straight from EDGAR with no key, and an optional API client for the certified corpus with replayable as_of queries.
Arkleon provides 9 well-structured tools with complete JSON schemas and honest, detailed descriptions. All tools have clear input schemas with typed parameters and descriptions. Tool names follow verb_noun convention (edgar_*, pit_*, resolve_*). Descriptions are substantive (150 - 250 chars) and include important caveats about data provenance and reproducibility. However, output schemas are not formally documented in the tool definitions, handlers return plain dicts without explicit schema declarations. Error handling is minimal; handlers do not validate inputs or provide recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) are present. Parameter descriptions are good but could be more prescriptive about formats and constraints (e.g., date format YYYY-MM-DD is mentioned but not enforced via pattern or enum).
Fetch all as-reported numeric XBRL facts for a company by CIK. Source: live SEC EDGAR, best-effort. Not certified, not exhaustively join-verified, and not permanently reproducible; SEC may change what its endpoints return at any time.
Fetch a single XBRL concept (tag) across all units and time periods for a company. Source: live SEC EDGAR, best-effort. Not certified, not exhaustively join-verified, and not permanently reproducible; SEC may change what its endpoints return at any time.
Fetch facts filed on or before a given date (best-effort point-in-time). Source: live SEC EDGAR, best-effort. Not certified, not exhaustively join-verified, and not permanently reproducible; SEC may change what its endpoints return at any time.
List a company's filings from SEC EDGAR submissions, by CIK. Source: live SEC EDGAR, best-effort. Not certified, not exhaustively join-verified, and not permanently reproducible; SEC may change what its endpoints return at any time.
Resolve a ticker symbol to a CIK using SEC's current snapshot. WARNING: this mapping is a current snapshot and is non-point-in-time: a ticker is reassigned over time and one CIK carries several symbols at once. Use CIK for reproducible identity.
Output schemas not formally documented. Handlers return plain dicts (e.g., {'filings': [...], 'facts': [...], 'note': ...}) but tool definitions do not declare expected output structure. LLMs cannot plan downstream tool calls or validate response fields.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All tools are read-only, but this is not declared in the tool definitions. LLMs cannot infer safety properties and may incorrectly reason about retry semantics.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | 2026-07-28+ | v2 |
Fetch certified point-in-time numeric facts from the Arkleon corpus. Point-in-time and permanently reproducible: identical query plus identical as_of returns identical data permanently. Requires an ak_ API key.
Fetch certified point-in-time filings from the Arkleon corpus. Point-in-time and permanently reproducible: identical query plus identical as_of returns identical data permanently. Requires an ak_ API key.
Compose a value-versus-as_of timeline by querying the same fact across multiple as_of dates. Reveals where a value changed due to restatements. Source: the certified Arkleon corpus. Point-in-time and permanently reproducible: identical query plus identical as_of returns identical data permanently. Requires an ak_ API key.
Resolve company identity by CIK, name, or ticker from the Arkleon corpus. Source: the certified Arkleon corpus. Point-in-time and permanently reproducible: identical query plus identical as_of returns identical data permanently. Requires an ak_ API key.
No input validation or error recovery guidance. Handlers do not validate date formats (YYYY-MM-DD), CIK ranges, or enum constraints. Invalid inputs fail silently or with generic errors. Descriptions mention formats but do not enforce them.
Pagination support incomplete. pit_facts and pit_filings accept cursor and limit but do not document the pagination contract (e.g., what next_cursor=null means, whether limit is enforced). No guidance on result limits or context window impact.
API key handling relies on environment variable fallback (ARKLEON_API_KEY) but is not documented in tool descriptions. LLMs cannot infer whether a tool requires authentication or how to provide it. Paid tools should explicitly state 'Requires ak_ API key' in descriptions (which they do), but the fallback mechanism is opaque.