# US Company Financials (SEC XBRL)

> Revenue, profit, cash, debt and EPS for any US-listed company straight from SEC XBRL filings — history and peer comparison.

Remote MCP server (Streamable HTTP): https://us-company-financials-mcp.donniertf.workers.dev/mcp
Free tier: `key_financials` — no key, no sign-up, 20 calls/day per IP.
Pro: $15/month, cancel anytime — all tools, unlimited.

## Tools
- key_financials (free): FREE. Latest annual revenue, net income, total assets and cash for a US-listed company (ticker or name) from SEC XBRL data.
- history (Pro): PRO. Up to 10 years (annual) or 12 quarters of revenue, net income, operating income, cash flow, debt, equity, EPS.
- compare (Pro): PRO. Compare latest annual revenue, net margin, revenue growth, debt and cash across up to 10 companies.

## Buying (agents)
1. POST https://us-company-financials-mcp.donniertf.workers.dev/checkout -> {checkout_url, session_id}. A human (or a payment-capable agent) completes Stripe Checkout at checkout_url.
2. GET https://us-company-financials-mcp.donniertf.workers.dev/token?session_id=... -> {access_token}.
3. Send Authorization: Bearer <access_token> to https://us-company-financials-mcp.donniertf.workers.dev/mcp (or pass access_token in tool arguments).

## Pay per call (x402, USDC on Base)
No account: POST JSON args to https://us-company-financials-mcp.donniertf.workers.dev/x402/<tool> -> HTTP 402 with payment requirements ($0.05 USDC per call, payTo 0x02226D28e0c85AE4AdDB7fe7043Dd2b1Ff710D41). Retry with an X-PAYMENT header (x402 v1, scheme exact, network base). Manifest: https://us-company-financials-mcp.donniertf.workers.dev/.well-known/x402. MCP clients may also send X-PAYMENT on tools/call.
Machine-readable pricing: https://us-company-financials-mcp.donniertf.workers.dev/pricing.json · Server card: https://us-company-financials-mcp.donniertf.workers.dev/.well-known/mcp

## Sources
- SEC EDGAR XBRL companyfacts API (data.sec.gov), public domain

## Notes
XBRL figures as reported to the SEC (data.sec.gov companyfacts); tags vary by company, so some fields may be missing. Not investment advice.
Contact: dmorrisonwebdesign@gmail.com. More UK data MCPs: https://github.com/donniertf-hub/uk-mcp-fleet