{"schemaVersion":"1.0","name":"x402-agent-api","title":"Agent Utility Suite","version":"1.0.0","description":"SEC filings and web data for AI agents: read any section of a US public company's 10-K or 10-Q (risk factors, MD&A, …) since 2001, its latest 8-K events and press releases, and a free index of its filings; turn any web page into clean Markdown; profile a domain's email setup. No accounts or API keys: pay per call in USDC with x402. Payments settle on Base.","documentation":{"openapi":"https://x402-agent-api.onrender.com/openapi.json","llms":"https://x402-agent-api.onrender.com/llms.txt","x402":"https://x402.org"},"payment":{"protocol":"x402","x402Version":2,"scheme":"exact","network":"eip155:8453","networkName":"Base","asset":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"payTo":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC","headers":{"challenge":"PAYMENT-REQUIRED","payment":"PAYMENT-SIGNATURE","receipt":"PAYMENT-RESPONSE","aliases":["X-PAYMENT-REQUIRED","X-PAYMENT","X-PAYMENT-RESPONSE"]},"flow":"Call the tool's HTTP endpoint. On 402, decode the challenge header, sign one `accepts` entry, and retry with the payment header. Payment settles only if the call succeeds."},"server":{"url":"https://x402-agent-api.onrender.com/mcp","transport":"streamable-http","payment":"x402 v2 inside MCP: unpaid tools/call returns PaymentRequired as structuredContent; retry with _meta[\"x402/payment\"]"},"tools":[{"name":"check_health","title":"Check API health","description":"Free liveness probe. Returns status 'ok' and the server time. Use before paid calls to confirm the API is reachable.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"timestamp":{"type":"string","format":"date-time"}},"required":["status","timestamp"]},"annotations":{"title":"Check API health","readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false},"pricing":{"model":"free","price":"0","currency":"USD"},"http":{"method":"GET","url":"https://x402-agent-api.onrender.com/health","inputLocation":"query"}},{"name":"sec_list_filings","title":"List a company's SEC filings (free)","description":"Free, no payment needed. Lists a US public company's 10-K (annual), 10-Q (quarterly) and 8-K (material event) filings from SEC EDGAR, newest first: filing date, fiscal year and period, sec.gov link, the sections sec_filing_section can extract from each report (Risk Factors, MD&A, Business, Legal Proceedings, Market Risk, Cybersecurity), and the event items of each 8-K (earnings 2.02, executive changes 5.02, deals 1.01, cybersecurity incidents 1.05, …). Every filing carries `next_call`: the exact paid tool call, with arguments and price, that returns its text. Use it to check what exists before paying, to find a specific year or event, or to track new filings. Filter by form and date (back to 2001); up to 50 filings per call. Look up by stock ticker or CIK. Rate-limited per client.","inputSchema":{"type":"object","properties":{"ticker":{"description":"US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this or `cik`.","type":"string","pattern":"^[A-Z][A-Z0-9.\\-]{0,9}$"},"cik":{"description":"SEC Central Index Key, e.g. 320193. Use this or `ticker`.","anyOf":[{"type":"string","pattern":"^\\d{1,10}$"},{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}]},"forms":{"description":"Which filings to list: 10-K (annual), 10-Q (quarterly), 8-K (material events). Default: all three.","minItems":1,"type":"array","items":{"type":"string","enum":["10-K","10-Q","8-K"]}},"since":{"description":"Only filings filed on or after this date (YYYY-MM-DD). Reaches back to 2001.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"limit":{"default":20,"description":"How many filings to return, newest first (1-50, default 20).","type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"company":{"type":"string"},"ticker":{"type":["string","null"]},"cik":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"filings":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string","enum":["10-K","10-Q","8-K"]},"form_type":{"type":"string","description":"EDGAR form type, e.g. 10-K405 or 8-K/A."},"filing_date":{"type":"string"},"period_of_report":{"description":"For 10-K/10-Q, the fiscal period end; for 8-K, the event date.","type":["string","null"]},"fiscal_year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"For 10-K/10-Q, the calendar year the fiscal period ends in (sec_filing_section `fiscal_year`)."},"accession_number":{"type":"string"},"filing_url":{"type":"string"},"sections":{"type":"array","items":{"type":"string"},"description":"For 10-K/10-Q, the sections sec_filing_section can extract."},"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"}},"required":["code","title"],"additionalProperties":false},"description":"For 8-K, the reported event items."},"next_call":{"type":"object","properties":{"tool":{"type":"string","enum":["sec_filing_section","sec_recent_events"]},"price":{"type":"string"},"arguments":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["tool","price","arguments"],"additionalProperties":false,"description":"The paid call that reads this filing. For 10-K/10-Q, change `section` to any of `sections`."}},"required":["form","form_type","filing_date","period_of_report","fiscal_year","accession_number","filing_url","sections","items","next_call"],"additionalProperties":false}},"source":{"type":"string","const":"sec-edgar"}},"required":["company","ticker","cik","count","filings","source"],"additionalProperties":false},"annotations":{"title":"List a company's SEC filings (free)","readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":true},"pricing":{"model":"free","price":"0","currency":"USD"},"http":{"method":"POST","url":"https://x402-agent-api.onrender.com/api/v1/sec-list-filings","inputLocation":"body"}},{"name":"sec_filing_section","title":"SEC 10-K / 10-Q section extractor","description":"Answers questions like \"What are Tesla's risk factors?\", \"What did Apple's MD&A say about margins?\" or \"How has Microsoft's cybersecurity disclosure changed since 2023?\". Returns exactly one section of a US public company's 10-K (annual) or 10-Q (quarterly) report from SEC EDGAR as clean text, ready for an LLM: Risk Factors (Item 1A), Management's Discussion and Analysis (MD&A), Business, Legal Proceedings, Market Risk, or Cybersecurity. Look up by stock ticker or CIK. Defaults to the latest filing; pass `fiscal_year` (2001 on) for an earlier year's report, e.g. to compare how risk factors changed, or `accession_number` for an exact filing (the free sec_list_filings tool lists them, with the sections each one has). The table of contents, page numbers, hidden XBRL data and HTML are removed; tables are kept as readable rows. Includes the filing date, fiscal period, accession number and sec.gov link for citation. Use it for investment research, due diligence, competitor analysis or risk monitoring without downloading a 100-page filing. Sections up to 200,000 characters. If the filing's item only points elsewhere (\"See Note 12\"), you get 404 SECTION_INCORPORATED_BY_REFERENCE with that pointer, free. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.02 USDC per call via x402.","inputSchema":{"type":"object","properties":{"ticker":{"description":"US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this or `cik`.","type":"string","pattern":"^[A-Z][A-Z0-9.\\-]{0,9}$"},"cik":{"description":"SEC Central Index Key, e.g. 320193. Use this or `ticker`.","anyOf":[{"type":"string","pattern":"^\\d{1,10}$"},{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}]},"section":{"type":"string","enum":["business","risk_factors","cybersecurity","legal_proceedings","mda","market_risk"],"description":"Which section to return: risk_factors, mda (Management's Discussion and Analysis), business, legal_proceedings, market_risk, or cybersecurity (10-K only, filings from late 2023 on)."},"form":{"description":"Annual report (10-K, the default) or quarterly report (10-Q). With `accession_number`, taken from that filing.","type":"string","enum":["10-K","10-Q"]},"fiscal_year":{"description":"Return the report whose fiscal period ends in this calendar year instead of the latest one, e.g. 2022 for Apple's 10-K for the year ended September 24, 2022. For a 10-Q, the latest quarter ending in that year. EDGAR has HTML filings from 2001 on.","type":"integer","minimum":2001,"maximum":2100},"accession_number":{"description":"Return the section from this exact 10-K or 10-Q filing of the company, e.g. 0000320193-22-000108.","type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$"}},"required":["section"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"company":{"type":"string"},"ticker":{"type":["string","null"]},"cik":{"type":"string"},"form":{"type":"string","enum":["10-K","10-Q"]},"filing_date":{"type":"string","description":"Date the filing was submitted (YYYY-MM-DD)."},"period_of_report":{"description":"Fiscal period end the filing covers (YYYY-MM-DD).","type":["string","null"]},"accession_number":{"type":"string"},"filing_url":{"type":"string","description":"Link to the filing document on sec.gov."},"section":{"type":"string"},"item":{"type":"string","description":"Item number in the filing, e.g. 1A."},"section_title":{"type":"string"},"text":{"type":"string","description":"Section text, cleaned of HTML, with paragraph breaks preserved."},"char_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"word_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated":{"type":"boolean","description":"True if the section exceeded 200,000 characters and was cut."},"source":{"type":"string","const":"sec-edgar"}},"required":["company","ticker","cik","form","filing_date","period_of_report","accession_number","filing_url","section","item","section_title","text","char_count","word_count","truncated","source"],"additionalProperties":false},"annotations":{"title":"SEC 10-K / 10-Q section extractor","readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":true},"pricing":{"model":"per_call","price":"0.02","currency":"USD","asset":"USDC","atomicAmount":"20000","protocol":"x402"},"http":{"method":"POST","url":"https://x402-agent-api.onrender.com/api/v1/sec-filing-section","inputLocation":"body"}},{"name":"sec_recent_events","title":"SEC 8-K material events","description":"Answers \"What happened at this company lately?\": did the CEO or CFO leave, what were the latest earnings, was there an acquisition, major contract or cyber incident. Returns a US public company's most recent 8-K filings from SEC EDGAR, newest first: the material events companies must report within four business days, such as earnings releases (Item 2.02), CEO, CFO and director changes (5.02), material agreements and acquisitions (1.01, 2.01), cybersecurity incidents (1.05), impairments, auditor changes and shareholder votes. Each event has its item codes with official titles, the 8-K text as clean prose, and the text of its press-release exhibits (EX-99), e.g. the full earnings release. Filter by item codes and filing date, or ask for one exact 8-K by `accession_number` (the free sec_list_filings tool lists them); up to 10 events per call. Look up by stock ticker or CIK. Use it for event monitoring, news and earnings agents, due diligence or trading research, with sec.gov links for citation. If no 8-K matches, you get 404 FILING_NOT_FOUND, free. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.02 USDC per call via x402.","inputSchema":{"type":"object","properties":{"ticker":{"description":"US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this or `cik`.","type":"string","pattern":"^[A-Z][A-Z0-9.\\-]{0,9}$"},"cik":{"description":"SEC Central Index Key, e.g. 320193. Use this or `ticker`.","anyOf":[{"type":"string","pattern":"^\\d{1,10}$"},{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}]},"items":{"description":"Only events reporting one of these 8-K items, e.g. [\"5.02\"] for executive and director changes, [\"2.02\"] for earnings releases, [\"1.01\", \"2.01\"] for deals, [\"1.05\"] for cybersecurity incidents.","minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^\\d\\.\\d{2}$"}},"since":{"description":"Only events filed on or after this date (YYYY-MM-DD).","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"accession_number":{"description":"Return only this 8-K, e.g. one found with the free sec_list_filings tool.","type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$"},"limit":{"default":5,"description":"How many events to return, newest first (1-10, default 5).","type":"integer","minimum":1,"maximum":10},"include_exhibits":{"default":true,"description":"Include the text of press-release exhibits (EX-99), e.g. the earnings release. Default true.","type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"company":{"type":"string"},"ticker":{"type":["string","null"]},"cik":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"events":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string","enum":["8-K","8-K/A"]},"filing_date":{"type":"string","description":"Date the 8-K was filed (YYYY-MM-DD)."},"event_date":{"description":"Date of the reported event (YYYY-MM-DD).","type":["string","null"]},"accession_number":{"type":"string"},"filing_url":{"type":"string","description":"Link to the 8-K document on sec.gov."},"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"}},"required":["code","title"],"additionalProperties":false}},"text":{"type":"string","description":"The 8-K's item disclosures as clean text, from the first Item heading to the signatures."},"truncated":{"type":"boolean"},"exhibits":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Exhibit type, e.g. EX-99.1."},"description":{"type":["string","null"]},"url":{"type":"string"},"text":{"type":"string"},"truncated":{"type":"boolean"}},"required":["type","description","url","text","truncated"],"additionalProperties":false}}},"required":["form","filing_date","event_date","accession_number","filing_url","items","text","truncated","exhibits"],"additionalProperties":false}},"source":{"type":"string","const":"sec-edgar"}},"required":["company","ticker","cik","count","events","source"],"additionalProperties":false},"annotations":{"title":"SEC 8-K material events","readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":true},"pricing":{"model":"per_call","price":"0.02","currency":"USD","asset":"USDC","atomicAmount":"20000","protocol":"x402"},"http":{"method":"POST","url":"https://x402-agent-api.onrender.com/api/v1/sec-recent-events","inputLocation":"body"}},{"name":"scrape_markdown","title":"Web page to Markdown","description":"Use it when an agent needs to read a web page: an article, documentation, a blog post, a product or pricing page, a news story. Fetches a public web page and returns its main content as clean Markdown, ready to put in an LLM context: scripts, styles, navigation, headers, footers and sidebars are removed, the article body is extracted (Readability), and links are made absolute. Returns the page title, the final URL after redirects and the character count; output is capped at 100,000 characters. Use it to read articles, docs, blog posts or product pages. Pages that need JavaScript to render may return little content. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.005 USDC per call via x402.","inputSchema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri","description":"Public http(s) URL of the page to convert, e.g. https://example.com/article."}},"required":["url"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Final URL after redirects."},"title":{"type":"string"},"markdown":{"type":"string","description":"Main content as Markdown, at most 100,000 characters."},"char_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Length of `markdown` in characters."},"truncated":{"type":"boolean","description":"True when the page or the Markdown was cut to fit the size limits."}},"required":["url","title","markdown","char_count","truncated"],"additionalProperties":false},"annotations":{"title":"Web page to Markdown","readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":true},"pricing":{"model":"per_call","price":"0.005","currency":"USD","asset":"USDC","atomicAmount":"5000","protocol":"x402"},"http":{"method":"POST","url":"https://x402-agent-api.onrender.com/api/v1/scrape-markdown","inputLocation":"body"}},{"name":"domain_enrich","title":"Domain email and web profile","description":"Answers \"Who hosts this company's email, and is it configured properly?\" and \"Which SaaS tools does this company use?\". Profiles a domain from live DNS and its website: MX records and the inferred email provider (Google Workspace, Microsoft 365, …), SPF and DMARC configuration and policy, services the domain has verified ownership with (from TXT records: Google, Microsoft, Stripe, Atlassian, …), whether the website is reachable over HTTPS, and stack and security headers (Server, X-Powered-By, HSTS, CSP). Use it for lead enrichment, email deliverability checks, vendor due diligence or security reviews. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.005 USDC per call via x402.","inputSchema":{"type":"object","properties":{"domain":{"description":"Domain to profile, e.g. example.com. A full URL is accepted; its hostname is used.","type":"string","maxLength":300}},"required":["domain"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"domain":{"type":"string"},"has_mx_records":{"type":"boolean"},"mx_hosts":{"type":"array","items":{"type":"string"},"description":"Mail servers, highest priority first."},"email_provider":{"description":"Inferred from MX hosts, e.g. Google Workspace or Microsoft 365.","type":["string","null"]},"spf_configured":{"type":"boolean"},"spf_record":{"type":["string","null"]},"dmarc_configured":{"type":"boolean"},"dmarc_policy":{"description":"DMARC p= value: none, quarantine or reject.","type":["string","null"]},"verifications":{"type":"array","items":{"type":"string"},"description":"Services the domain has verified ownership with (from TXT records)."},"txt_records":{"type":"array","items":{"type":"string"},"description":"Raw TXT records (up to 25)."},"website":{"type":"object","properties":{"reachable":{"type":"boolean"},"status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"final_url":{"type":["string","null"]},"https":{"type":"boolean"}},"required":["reachable","status","final_url","https"],"additionalProperties":false},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Selected response headers from the website: server, x-powered-by, security headers and similar."},"checked_at":{"type":"string"}},"required":["domain","has_mx_records","mx_hosts","email_provider","spf_configured","spf_record","dmarc_configured","dmarc_policy","verifications","txt_records","website","headers","checked_at"],"additionalProperties":false},"annotations":{"title":"Domain email and web profile","readOnlyHint":true,"idempotentHint":false,"destructiveHint":false,"openWorldHint":true},"pricing":{"model":"per_call","price":"0.005","currency":"USD","asset":"USDC","atomicAmount":"5000","protocol":"x402"},"http":{"method":"POST","url":"https://x402-agent-api.onrender.com/api/v1/domain-enrich","inputLocation":"body"}}]}