Agents
SEC API for AI
Give your coding agent grounded SEC and public-market data in one paste. 72 hosted MCP tools, 200+ generated OpenAPI operations, four typed SDKs, installable agent skills, and a persona prompt library — all on the same provenance-first contract model.
Capabilities
Everything your agent needs, on one contract model.
The same primitives behind the API are exposed to agents directly: hosted MCP, installable skills, typed SDKs, and bootstrap auth.
Tools & data
Hosted MCP
72 hosted MCP tools over the same contracts as REST, SDK, and CLI — give your agent grounded SEC data without a glue layer.
Released
Skills
Agent skills
Installable SKILL.md workflows that route your agent into repeatable investor research loops instead of guessing the job each turn.
Released
API
REST API
200+ generated OpenAPI operations across filings, statements, ownership, governance, factor, and market-data workflows.
Released
Libraries
Typed SDKs
Official SDKs for JavaScript, Python, Go, and Rust — the same contract model, native to your stack.
Released
Auth
Bootstrap auth
Scoped, ephemeral credentials your agent can provision for a session, with billing-aware guardrails so an autonomous loop stays in bounds.
Released
Setup
Drop-in rules file
An AGENTS.md / CLAUDE.md / .cursor/rules your agent reads to use SEC API correctly — entity-resolution-first, provenance-cited, and inside plan limits.
Released
Setup
One-command install
`secapi init --client <name>` writes your agent client's MCP config in one step; `secapi agent-context` describes the whole CLI for agents.
Released
Connect in one paste
Add SEC API for AI to your agent.
Pick your client, copy the config, and your agent has 72 grounded SEC tools. Then hand it the bootstrap prompt below.
claude mcp add --transport http secapi https://api.secapi.ai/mcp \
--header "x-api-key: YOUR_API_KEY"Give this prompt to your agent
Paste this once so your agent knows how to authenticate, resolve entities first, preserve provenance, cite filings, and stay inside plan limits.
You are using SEC API (secapi.ai) as your system of record for SEC and public-market data. Base URLs: - REST API: https://api.secapi.ai - Hosted MCP: https://api.secapi.ai/mcp - Docs: https://docs.secapi.ai Rules: - Authenticate with the `x-api-key` header. Never send the API key as `Authorization: Bearer`. - Resolve entities (ticker, CIK, CUSIP, ISIN, FIGI) before querying, and pass the resolved CIK downstream. - Prefer structured SEC API endpoints and MCP tools over raw filing text. - Carry freshness, provenance, requestId, and trace metadata through to every answer. - When a number comes from a filing, cite the accession number and the filing page. - Check GET /v1/billing and GET /v1/limits before expensive or repeated workflows, and stop if the server signals a budget cap or an approval requirement.
Or wire it yourself
Prefer code? Same contracts, four SDKs.
REST, JavaScript, Python, Go, Rust, and hosted MCP all share one contract model.
REST API
Use wire-level control when you want exact requests, exact retries, and exact responses.
JavaScript SDK
The native path for web apps, backend services, and TypeScript-heavy teams.
Python SDK
A clean fit for notebooks, research jobs, and data-heavy services.
Go SDK
A lightweight path for typed backend integrations and infra-oriented services.
Rust SDK
For async-heavy or performance-sensitive services that still want the SEC API contract directly.
Hosted MCP
Give coding agents direct access to grounded investor workflows without inventing a glue layer first.
What agents do with it
The loops your agent can run on day one.
Research loops
Primers, thesis work, competitor mapping, earnings prep, earnings recap, and multi-company analysis.
Modeling loops
DCF, comps, profit and loss projection, three-statement modeling, revenue analysis, and estimate reads.
Market loops
Macro regime intelligence, factor dashboard, company financials, footnote investigation, portfolio attribution, and event monitoring.
Ownership loops
SEC filings, ETF holdings, institutional holdings, insider trades, and politician trade reads.
Document loops
PDF, DOCX, spreadsheets, chart prep, workbook verification, and code-assisted spreadsheet work.
Operating loops
Alerts, watchlists, Google Workspace, skill management, and other stack-level support workflows.
Agent skills
A skill library across research, filings, markets, modeling, and ops.
Skills route your agent into repeatable investor workflows instead of guessing the whole job each turn.
Research skills
Skills that help SEC API Agent build context around one company, one theme, or one peer set quickly.
product
Company Primer
Builds the investor-grade 'what does this company do and why does it matter' memo.
company-primer
product
Competitors
Finds direct peers, substitutes, and important adjacent players with a reason for each inclusion.
competitors
product
Earnings Preview
Builds a pre-earnings brief around expectations, key KPIs, and what can actually move the story.
earnings-preview
product
Earnings Recap
Turns a fresh quarter into a scorecard, a reaction read, and a faster first-pass summary.
earnings-recap
product
Estimate Analysis
Pulls consensus expectations, ratings, and target posture so the agent can explain what the market is leaning toward.
estimate-analysis
product
Industry Primer
Builds the market-structure and profit-pool context around a sector before the company-level work begins.
industry-primer
product
Investment Thesis
Builds a clear bull case, bear case, catalyst map, and risk frame from the same grounded inputs.
investment-thesis
product
Deep Research (last30days)
Searches the last month of web, social, and media chatter when fresh outside-the-filing context matters.
last30days
product
Multi-Company Analysis
Normalizes a universe and compares several companies without drifting into inconsistent one-offs.
multi-company-analysis
product
Read News
Filters the daily news feed down to what matters for a ticker, theme, or watchlist.
read-news
product
Upcoming Events
Surfaces the next earnings, dividends, splits, IPOs, and macro events before they surprise the workflow.
upcoming-events
Built for safe agent usage
Bootstrap auth and billing-aware guardrails.
Agents authenticate with a scoped bootstrap flow and stay inside plan limits with predictable rate limiting and usage attribution. The contract keeps source references, request IDs, and freshness close to the answer.
- Bootstrap auth: scoped, ephemeral credentials provisioned for agent sessions.
- Billing-aware guardrails: per-key quotas, budget checks, and usage attribution before expensive loops.
- Provenance on every result: accession references, source URLs, freshness, and trace IDs stay close to the payload.
Next
Point your agent at the SEC.
Connect your client, hand it the prompt, and start shipping grounded investor workflows.