1 · Connect (60 seconds)
Claude Code:
claude mcp add --transport http mlq https://mlq.ai/mcp \ --header "Authorization: Bearer YOUR_KEY"
Claude Desktop / Cursor / any MCP client — config snippets here. Building a custom agent without MCP? Point it at mlq.ai/llms.txt — the whole API documented in one agent-readable file.
2 · Recipes
Each prompt below reliably drives the right tools. Steal them verbatim, or use them as patterns.
"Using MLQ: how have NVDA's gross and operating margins trended over the last 8 quarters? Show the numbers and cite each quarter's source filing."
income_statement(period="quarter") + metrics. The source blocks let the agent cite accessions instead of hallucinating."What were MSFT's fundamentals as known on 2025-03-01? Use as_of so nothing filed later leaks in."
"What are Berkshire's 10 largest positions this quarter, and which funds hold puts on NVDA?"
fund_holdings(cik="1067983") + institutional_ownership(include_options=true) — option rows are labeled, never mixed into share counts."Summarize today's most material SEC filings. High tier only, then pull the filing index for anything interesting."
filings_feed(tier="high", sort="material") — the materiality-scored EDGAR firehose — then company_filings for deep links."Any congressional trades in semiconductor names in the last two weeks? Cross-reference with insider selling at those companies."
congress_trades(since=…) + insider_trades per ticker."How much gas generation over 100MW is sitting in PJM's interconnection queue near data centers, and which operators filed data-center permits in Virginia this year?"
interconnection_queue(iso="PJM", fuel="gas", data_center=true, min_mw=100) + permits(state="VA", since=…). Datasets no other financial API has.3 · A scheduled agent in one command
Headless Claude Code turns any recipe into a cron job — a research briefing that runs itself:
claude -p "Using the mlq tools: list today's high-materiality filings, any new congressional trades, and notable insider buys. Cite every source filing. Write the briefing to briefing-$(date +%F).md"
4 · Why agents + this API specifically
- Provenance kills hallucination at the citation layer — every value carries its accession + EDGAR URL, so "cite your sources" is mechanical, not aspirational.
- Typed field docs in the spec — the agent knows
netIncomeis attributable-to-parent andcapitalExpenditureis negative, because the OpenAPI spec says so on the field. - Honest nulls — missing data comes back null with no imputation, so an agent never launders a guess into an answer.
- Verified data — filing-verified accuracy, with the audit method published.