io.github.vanakenj45/x402-agent-api

Tools

• company_dossier

  Answers "Give me a quick due-diligence read on NVDA", "Is anything wrong at this company?" or "Brief me on Apple before the market opens". Give a ticker, company name, CIK or website domain. One call returns: who the company is (industry, HQ, CEO, founded, employees, description), four fiscal years of revenue, operating and net income, EPS, operating and free cash flow, cash, debt and equity with margins and growth (SEC XBRL), the latest quarter with year-over-year growth, the last 5 8-K events with item titles and excerpts, insider open-market buying and selling from the latest Form 4s (10b5-1 and tax sales set apart), the latest 10-K/10-Q, and flags: RED for restatements (8-K 4.02), delisting notices, bankruptcy and late 10-Ks; AMBER for auditor changes, cybersecurity incidents, impairments, late 10-Qs, net losses, cash burn, negative equity and shrinking revenue; GREEN for profitable growth and insider buying. `summary` says it all in a few sentences; every flag cites its filing. Replaces five separate calls (company_profile, sec_financials twice, sec_recent_events, sec_insider_trades). next_calls lead to what changed in the risk factors and the latest earnings release. Unknown, ambiguous or private companies are not charged. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.03 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• company_dossier_batch

  Answers "Which of my holdings has a problem?" or "Screen these tickers for red flags before the open". Give up to 10 tickers, CIKs or company names. Returns a ranking (most red flags first, then amber) with each company's flags and one-paragraph summary, and every company's full dossier: profile, four fiscal years of financials and the latest quarter, the last five 8-K events, insider buying and selling over the latest 10 Form 4s, the latest 10-K/10-Q, and flags (RED: restatements, delisting notices, bankruptcy, late 10-Ks; AMBER: auditor changes, cybersecurity incidents, impairments, late 10-Qs, losses, cash burn, negative equity, shrinking revenue; GREEN: profitable growth, insider buying), each citing its filing. Priced by size: $0.03 for the first company and $0.025 for each further one (2 companies $0.055, 3 $0.08, 4 $0.105, 5 $0.13), capped at $0.15 for 6 to 10, always less than separate company_dossier calls. The 402 answer quotes the exact price for your list. Companies that cannot be found are listed in `failed`; if none can, you are not charged. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.03 to $0.15 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• company_profile

  Answers "Who is behind stripe.com?", "What does this company do, where is it based and who runs it?" or "Is it public, and what is its ticker?". Give a website domain (or any URL), a company name, a ticker or a CIK. Returns one profile combining: SEC EDGAR for public companies (legal name, tickers, exchanges, CIK, SIC industry, state of incorporation, fiscal year end, business address, phone, filer category, former names), Wikidata (founded, founders, CEO, headquarters, country, employees with date, industries, official website), a short Wikipedia description (with its URL for attribution), and the domain's email provider (from MX records) and registration date and registrar (RDAP). Works for private companies too (Wikidata and the domain). `sources` says which sources answered. For public companies, next_calls lead to their financials, 8-K events and insider trades. A name matching several SEC registrants returns the candidates, free; no company found is a 404, free. 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. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• counterparty_check

  Answers "Is it safe to pay this vendor?", "Can I onboard this customer?" or "Who is behind this payTo address?". Give a company or person `name`, their `domain` (website or email address) and/or the `wallet` you would pay. One call runs, side by side: an OFAC sanctions screen of the name and wallet (SDN and Consolidated lists, fuzzy name matching), the company profile (public or private: industry, HQ, founded, employees, tickers), the domain's age, email setup (MX, DMARC) and website, and an on-chain wallet risk check on Base or Ethereum (sanctioned controllers, account type, activity, balance). Returns `verdict` (block / review / clear), a one-line `summary`, every reason with the check it came from, and the facts behind them. A check that cannot reach its source is reported as failed instead of failing the call. Replaces sanctions_screen, company_profile, domain_enrich and wallet_risk_check (four calls) for vendor onboarding, KYB, payee vetting before an x402 or USDC payment, and fraud screening. A screening aid, not legal advice. 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. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• crypto_tax_ledger

  Answers "What crypto transactions did this wallet make in 2026?", "Give my accountant my crypto activity" or "Which of my transfers are taxable?". Give a wallet address on Base (default) or Ethereum and a tax year (or `from`/`to` dates). Returns every token, coin and NFT transfer in the period from the wallet's full on-chain history, each labeled with its kind (received, sent, swap, self-transfer, NFT in/out) and how a CPA usually treats it (income, disposal, trade, not taxable), the amount in or out, the counterparty, the transaction link and the USD value for dollar stablecoins; totals received, sent and net per asset; counts; and, with `include_csv`, the same rows as CSV for a spreadsheet or tax software. Swaps are flagged as taxable disposals. A record for preparing taxes, not tax advice; gains need cost basis and prices. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.05 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• daily_briefing

  Answers "What happened in the markets I should know about?", "Give me a morning briefing" or "Anything bad filed about my holdings overnight?". One call combines: SEC alerts filed in the last 24 hours, most serious first (restatements, auditor changes, delisting notices, late filings, cyber incidents, insider purchases of $100K+); earnings releases from the latest day with any, with headline figures; IPO registrations and pricings this week (SPACs left out); and US Treasury yields, CPI, unemployment, payrolls and Fed funds. Give `tickers` to narrow alerts and earnings to a watchlist, or `include` to pick sections. Starts with a few plain-sentence `summary` lines. For one every morning on your webhook, use daily_briefing_subscription. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.025 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• daily_briefing_subscription

  Answers "Send me a market briefing every morning" without scheduling anything. One payment covers 30 days: each day at `delivery_hour_utc` (default 11, i.e. 7am New York, before the US open) the same briefing daily_briefing returns is POSTed to your HTTPS `webhook_url` as JSON ({type: "briefing", briefing: {...}}), signed with HMAC-SHA256 using the `signing_secret` returned once at signup. The first briefing arrives within minutes of subscribing. Narrow it with a `tickers` watchlist or `include` sections. Failed deliveries are retried. The webhook must answer a test ping with 2xx or you are not charged. Extend with `renew_subscription_id` (+30 days); check deliveries or cancel with the free sec_alert_subscription_status. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $3.00 USDC per 30 days via x402 (30 briefings for the price of 120 one-off calls). Paid per call with x402 inside MCP (see the server instructions).

  shallow
• domain_enrich

  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.004 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• economic_indicators

  Answers "What is the 10-year Treasury yield?", "Is the yield curve inverted?", "What is inflation now?", "What is the unemployment rate?" and "Where is the fed funds rate?". Returns a snapshot of key US macro indicators from official public-domain sources: the U.S. Treasury's daily par yield curve (1 month to 30 years, 10y-2y spread, inversion), the Bureau of Labor Statistics' CPI and core CPI (year-over-year %), unemployment rate and nonfarm payrolls (level and monthly change), and the New York Fed's effective federal funds rate and target range. Optionally up to 24 months of monthly history. Choose indicators to keep the answer short. Sources are cached (yields and fed funds 1 hour, BLS 12 hours); a source that does not answer is listed in `unavailable`. If none answers, you are not charged. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.003 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• email_verify

  Answers "Is this email address valid?", "Will mail to it bounce?" and "Is it a throwaway, a shared inbox or a typo?" before an agent sends mail or saves a lead. Checks, without sending mail: syntax, whether the domain accepts email (MX records, an A/AAAA record as implicit MX, or a null MX that refuses all mail), disposable/temporary providers (a maintained list of thousands of domains), free webmail (Gmail, Outlook, Yahoo, ...), role accounts (info@, support@, noreply@), likely misspellings of big providers with a corrected suggestion (gmial.com → gmail.com), and the domain's SPF and DMARC records and email provider. Returns a verdict (deliverable, risky, undeliverable), a 0-100 score and the reasons. The mailbox itself is not probed (no SMTP), so a catch-all domain accepts any name. An invalid address is still an answer (undeliverable); only a DNS failure is an error, not charged. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.001 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• free_sample

  Free, no payment needed. Returns a paid tool's real, live answer to its documented example input (refreshed every 5 minutes to 6 hours depending on the tool), the price of a call with your own input, and where to send it. With no `tool`, lists every paid tool with the URL of its sample. Use it to check a tool's output format and quality before paying, or to test an integration. Also answers GET, e.g. /api/v1/samples?tool=token_risk_check. Rate-limited per client.

  shallow
• hvac_coil_load

  Answers "What is the cooling coil load for 10,000 CFM from 80/67 °F to 55/54 °F?", "What leaves a coil that removes 270 MBH sensible and 60 MBH latent?" and "What is the mixed air with 20% outdoor air?" for AHU and RTU selection, coil schedules and design checks. Give the airflow and either the entering and leaving air (any two properties each) to get the sensible, latent and total loads, tons, sensible heat ratio, condensate rate and both full state points; or one state plus the loads to solve the other (cooling or heating). The entering air can be mixed from outdoor and return air states with an outdoor air % or airflow; or, given the mixed air, the outdoor air % is back-calculated. Standard-air equations (Qs = 1.08·CFM·ΔT, Ql = 4840·CFM·ΔW, Qt = 4.5·CFM·Δh as a cross-check), ASHRAE psychrometrics at the site elevation, IP (CFM, MBH) or SI (L/s, kW). Flags impossible (supersaturated) results. Every result includes `steps` with the equations and numbers. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.002 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• hvac_duct_size

  Answers "What size duct for 1,000 CFM at 0.08 in. w.g./100 ft?", "What is the velocity and friction in a 24×12 duct at 2,000 CFM?" and "What height do I need with a 10 in depth limit?" for duct design and checking. Give any two of a duct size (round diameter, or rectangular width × height), airflow, velocity and friction rate (equal-friction sizing); a single width or height is held as a fixed side. Returns the exact round diameter and a rectangular equivalent (ASHRAE/Huebscher equivalent diameter for equal friction, or equal area for a velocity design), the nearest standard round and rectangular sizes with the velocity and friction of each, the friction loss per 100 ft (Darcy-Weisbach with Colebrook-White, galvanized steel, standard air), velocity pressure, Reynolds number, and design checks for velocity, friction and aspect ratio. IP (in, CFM, FPM) or SI (mm, L/s, m/s, Pa/m, metric sizes). Every result includes `steps` with the equations and numbers. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.002 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• hvac_psychrometrics

  Answers "What is the dew point / enthalpy / humidity ratio of 95 °F air at 75 °F wet bulb?" and "What RH is 75 °F air with a 55 °F dew point in Denver?" for HVAC design, commissioning, energy and comfort work. From any two of dry bulb, wet bulb, dew point, relative humidity, humidity ratio, enthalpy or grains, returns the full state point: all seven plus specific volume, density and vapor pressure, at any site elevation (atmospheric pressure), in IP (°F, BTU/lb, gr/lb) or SI (°C, kJ/kg, g/kg). Uses the ASHRAE Handbook—Fundamentals (2021) Ch. 1 equations (Hyland-Wexler saturation pressure, ice below freezing) and is cross-checked against PsychroLib to within 0.02 °F. Every result includes `steps`: each equation with the numbers put into it and its ASHRAE reference, so the work can be checked or pasted into a calc package. Impossible states (wet bulb above dry bulb, RH over 100%) are errors and are not charged. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.002 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• new_token_launches

  Answers "What tokens launched on Base in the last hour, and which look safe?" for trading and research agents. Finds every pool created against WETH, ETH or USDC on Uniswap v2, v3 and v4 and Aerodrome in the window (default the last 60 minutes, up to 6 hours), groups them by token, newest first, and runs each of the newest (up to 20) through token_risk_check: name and symbol, whether the contract itself is brand new, owner and renounced ownership, powers in its code (mint, blacklist, fees, pause, trading switch, limits), upgradeability, measured liquidity in USD, OFAC screening, and a verdict (high_risk, caution, no_flags) with reasons. Filter by minimum liquidity or hide high-risk tokens. Built for polling: each answer gives `latest_block`; pass it as `since_block` next time to get only newer launches. Read live from the chain. Not financial advice. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.01 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sanctions_screen

  Answers "Is this company or person sanctioned by the US?" and "Is this crypto wallet on OFAC's list?" for KYC, vendor onboarding, payments and compliance checks. Screens a name against the US Treasury OFAC Specially Designated Nationals (SDN) list and the Consolidated (non-SDN) sanctions lists, primary names and aliases, tolerant of word order ("PUTIN, Vladimir"), accents, punctuation, honorifics, legal suffixes and small typos; and a cryptocurrency address against the addresses OFAC lists (exact match). Each match has a 0-100 score, the name it matched (primary or a.k.a.), and the listing: OFAC ID, type, programs, title, aliases, addresses, date of birth, nationality, crypto addresses and remarks. Filter by type and country; set the score threshold. `clear` is true when nothing matched. Lists are refreshed from OFAC every 12 hours. A screening aid, not legal advice. 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. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• scrape_batch

  Use it when an agent needs to read several web pages at once: compare competitors' pricing pages, read the top search results, or the pages a site_map call found. Reads 2-5 public URLs in one paid call (one payment round trip instead of five), each exactly like scrape_markdown: the main content as clean Markdown (or `mode: "full"`), real tables, code blocks, metadata from meta tags and JSON-LD (author, dates, language, canonical URL), PDFs as text by page, RSS feeds as item lists, optionally each page's links. Results come back in request order, each either `ok: true` with the page or `ok: false` with an error code and message (bot check, unreachable, unsupported content), so one bad URL does not spoil the batch. Each page is cut at `max_chars_per_page` (default 20,000); next_calls continue a long page with scrape_markdown. If no page at all can be read, the call fails and is not charged. JavaScript is not executed. No account or API key. Costs $0.008 USDC per call via x402 ($0.002 per page when read one by one). Paid per call with x402 inside MCP (see the server instructions).

  shallow
• scrape_markdown

  Use it when an agent needs to read a web page, article, documentation, PDF, blog post, product or pricing page, news story or RSS feed. Returns the main content as clean Markdown ready for an LLM: navigation, ads, footers and sidebars removed (or `mode: "full"` for the whole page), real tables as Markdown tables, code blocks with their language, math as TeX, the real (not lazy-loaded placeholder) images, absolute links without same-page anchors, and no needless escaping. Also returns metadata from meta tags and JSON-LD (description, author, published and modified time, language, site name, canonical URL, image, schema.org type), the HTTP status, word and token counts, and optionally the page's links. PDFs come back as text by page (up to 100 pages, 15 MB; no OCR), RSS/Atom feeds as item lists, JSON pretty-printed, and JavaScript-built pages that embed their content as data (JSON-LD articleBody, Next.js) are read from it. Long pages are returned in parts of up to 100,000 characters: pass `next_offset` back as `offset`; `strip_link_urls` saves tokens. Bot checks ("Just a moment...") and pages with no readable text answer 422 and are not charged; JavaScript is not executed. No account or API key. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.002 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_alert_subscription

  Answers "Tell me the moment any of my holdings files something bad" without polling. One payment covers 30 days: every new alert matching your filters (a `tickers` watchlist, `levels`, `types`; default red, amber and green: restatements, delisting notices, bankruptcies, late 10-K/10-Q, auditor changes, cybersecurity incidents, impairments, changes in control, insider purchases of $100K+) is POSTed to your HTTPS `webhook_url` as JSON within about 2 minutes of being found, in the same shape sec_market_alerts returns, signed with HMAC-SHA256 using the `signing_secret` returned once at signup. Failed deliveries are retried every 2 minutes. The webhook must answer a test ping with 2xx or you are not charged. Extend with `renew_subscription_id` (+30 days); check deliveries or cancel with the free sec_alert_subscription_status. Subscriptions survive server restarts. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $1.00 USDC per 30 days via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_alert_subscription_status

  Free, no payment needed. Give the `subscription_id` and `signing_secret` from sec_alert_subscription to see whether it is active, when it expires, how many alerts were delivered and the last delivery error, or set `cancel: true` to stop deliveries (no refund).

  shallow
• sec_alerts_peek

  Free, no payment needed. Counts the alerts sec_market_alerts would return for the same `since`, `levels`, `types` and `tickers`, by level and type, with a new `cursor`. Counts only: the companies, filings and excerpts come with the paid sec_market_alerts, whose ready-to-send call is included when there is something new. Built for polling: peek for free every few minutes, pay only when new_alerts > 0. Rate-limited per client.

  shallow
• sec_earnings_today

  Answers "Who reported earnings this morning?", "How did the banks do today?" or "Did any of my holdings report?". Lists the earnings releases (8-K item 2.02, Results of Operations and Financial Condition) filed with the SEC on a day across all companies, newest first. For each: company, ticker, EDGAR acceptance time, the press release's headline, its highlights (subheadlines and the sentences carrying revenue, EPS, net income, margins and guidance figures), the opening paragraph, and links to the press release (EX-99.1) and the filing. Filter with a `tickers` watchlist; poll with `since` = the previous answer's `cursor` to get only new releases (the free sec_alerts_peek with types ["earnings"] counts them first). A day without releases (or none from the watchlist) is a free 404. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.01 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_filing_section

  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, or `accession_number` for an exact filing (the free sec_list_filings tool lists them, with the sections each one has). For several sections of one filing use sec_filing_sections; for what changed since last year, sec_section_changes. 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.01 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_filing_sections

  Answers several questions about one report at once, e.g. "What are Nvidia's risks, and what does management say about results?". Returns 2 or 3 sections of the same 10-K or 10-Q from SEC EDGAR as clean text, in one call: Risk Factors, MD&A, Business, Legal Proceedings, Market Risk, Cybersecurity. Same inputs and output per section as sec_filing_section (latest filing, a `fiscal_year` since 2001, or an exact `accession_number`; by ticker, CIK or company name), at $0.015 for up to three sections instead of $0.01 each. Sections the filing does not contain are listed in `not_found`; if none can be read you get 404, free. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.015 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_financials

  Answers "What were Apple's revenue and net income over the last five years?", "Is Tesla's free cash flow positive?" or "How fast is Nvidia growing quarter over quarter?". Returns a US public company's key financial-statement figures for its latest fiscal years (annual, from 10-Ks) or single quarters (quarterly), newest first, from the XBRL data companies file with the SEC: income statement (revenue, cost of revenue, gross profit, R&D, SG&A, operating income, pretax income, tax, net income, basic and diluted EPS, diluted shares), balance sheet (cash, current and total assets and liabilities, long-term debt, equity) and cash flow (operating cash flow, capex, free cash flow, dividends, buybacks), plus gross, operating and net margins and year-over-year revenue growth. Fourth quarters and single-quarter cash flows, which companies only report as full-year or year-to-date totals, are derived and flagged in `derived`. Each period cites the latest filing that reports it, so restated figures replace original ones. Up to 20 periods per call, back to about 2009; `fiscal_year` reaches earlier years. By ticker, CIK or company name. US-GAAP filers only (not IFRS 20-F filers); values in USD. 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. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_full_text_search

  Answers "Which companies disclosed a material weakness this year?", "Who mentions tariffs in their 10-Q risk factors?", "Which filings name this executive, product or supplier?" or "Has this company ever mentioned a going-concern doubt?". Searches the full text of SEC EDGAR filings and their exhibits since 2001 (EDGAR Full-Text Search): put exact phrases in double quotes. Filter by form (10-K, 10-Q, 8-K, S-1, DEF 14A, ...), by company (ticker, CIK or name) and by filing date. Each hit gives the company, ticker, CIK, form, document type (e.g. EX-99.1), filing date, period, accession number, document and filing-index links, 8-K items, location, and `next_call`: the paid call that reads it (a 10-K/10-Q section, the 8-K event, or the document as Markdown). Also returns the total hit count and the companies and forms with the most hits across all pages. Up to 50 results per call; page with `offset`. No match is a 404, free. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.01 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_fund_holdings

  Answers "What does Warren Buffett own?", "What did Michael Burry buy last quarter?", "Did Bridgewater sell Nvidia?" or "What are Cathie Wood's biggest positions?". Give a fund or investor name (Berkshire Hathaway, Bridgewater, Renaissance, Pershing Square/Ackman, Scion/Burry, ARK/Cathie Wood, Citadel, Soros, Tiger Global, Appaloosa/Tepper, Icahn, Baupost, Third Point, Duquesne/Druckenmiller, Vanguard, Two Sigma, Elliott, Viking, D. E. Shaw and any other 13F filer) or its SEC CIK. Returns the latest (or any `period`) 13F-HR: total value, number of positions, each position (issuer, CUSIP, value, shares, % of portfolio, options marked put/call) merged across sub-managers, and against the quarter before: new positions, positions sold out, the biggest adds and cuts, and a plain-English `summary`. Managers with over $100M in US equities file within 45 days of each quarter's end. Unknown funds are not charged. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.01 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_insider_trades

  Answers "Are Nvidia's executives selling?", "Did any Intel insider buy shares on the open market this year?" or "What did Tesla's CFO do with his vested stock?". Returns a US public company's latest Form 4 filings from SEC EDGAR, the reports officers, directors and 10% owners must file within two business days of trading its stock: who traded (name, role, title), each transaction with its date, code and plain-English meaning, shares, price, dollar value, holdings after, and direct or indirect ownership, plus footnotes. A summary totals open-market purchases and sales (shares, dollars, which insiders) and separates sales under pre-arranged Rule 10b5-1 plans and sales that only cover taxes on vesting stock, which say little about insiders' views. Filter by filing date or transaction code (e.g. ["P"] for open-market purchases), optionally with option and RSU transactions; up to 40 filings per call. By ticker, CIK or company name. If nothing matches you get 404, free. 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. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_ipo_filings

  Answers "Who filed for an IPO this week?", "Which IPOs priced today?" or "Any new SPACs?". Lists IPO registrations from EDGAR's live feed (about the last week), newest first, each with its stage: filed (first S-1, F-1 or S-11), amended (S-1/A, on the way to pricing), upsized (S-1MEF, registered just before pricing) or priced (424B4 final prospectus), the filing link, and whether it looks like a SPAC. Resale and follow-on registrations by companies that already trade are left out unless `include_public_companies` is true. Filter by stage or SPACs; poll with `since` (the previous `cursor`) to get only new filings. 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. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_list_filings

  Free, no payment needed. Two uses: (1) with a ticker, CIK or company name, a US public company's 10-K (annual), 10-Q (quarterly) and 8-K (material event) filings from SEC EDGAR, newest first, back to 2001; (2) with no company, the latest filings across all companies from EDGAR's live feed (about the last few business days): "Which companies reported earnings since Friday?", "Who announced a CEO change today?", "Which 10-Qs were filed this morning?". Each filing has the company, ticker, form, filing date (and acceptance time in the live feed), sec.gov link, the sections sec_filing_section can extract (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, …). Filter by form, 8-K `items` (codes or words like "earnings") and date. Every filing carries `next_call`: the exact paid tool call, with arguments and price, that returns its text. Up to 50 filings per call. Rate-limited per client.

  shallow
• sec_market_alerts

  Answers "Did anything bad just get filed?", "Alert me to restatements, auditor changes or CEO departures" or "Which insiders bought stock today?". Alerts from new SEC filings across all public companies, most serious first: RED (8-K item 4.02 restatements, 3.01 delisting notices, 1.03 bankruptcies, NT 10-K late annual reports), AMBER (4.01 auditor changes, 1.05 cybersecurity incidents, 2.06 impairments, 2.04 debt triggers, 5.01 changes in control, NT 10-Q), GREEN (open-market insider purchases of $100K or more, from Form 4s) and INFO (5.02 leadership changes, 2.02 earnings releases, 1.01 agreements, 2.01 deals, 2.05 restructurings, 3.02 unregistered share sales). Each alert has the company, ticker, EDGAR acceptance time, items, a text excerpt for red and amber 8-Ks, the filing link and the paid call that reads it in full. Filter by `levels`, `types` or a `tickers` watchlist. Built for polling: pass the previous answer's `cursor` as `since` to get only new alerts, and check the free sec_alerts_peek first so you pay only when there is something new. 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. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_recent_events

  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.01 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• sec_section_changes

  Answers "What changed in Tesla's risk factors this year?", "Which new risks did Apple add?" or "How did Microsoft's MD&A change since 2022?". Compares one section of a company's 10-K with the same section of an earlier 10-K from SEC EDGAR, paragraph by paragraph: paragraphs added (new risk factors appear here), removed, and edited, each edit with a word-level diff marking deletions [-like this-] and insertions {+like this+}, plus a summary (counts and the share of text unchanged). Moved but identical paragraphs count as unchanged. Defaults to the latest 10-K against the one before it; pass `fiscal_year` or `accession_number` for the newer report and `compare_to_fiscal_year` for the older one (2001 on). Sections: Risk Factors, MD&A, Business, Legal Proceedings, Market Risk, Cybersecurity (filed from late 2023 on). By ticker, CIK or company name, with sec.gov links for both filings. Use it for risk monitoring, due diligence and investment research without reading two 100-page filings. If either report lacks the section you get 404, free. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.04 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• site_map

  Use it when an agent needs to know what pages a website has before reading them: where is the pricing page, which docs pages exist, what did the blog publish lately, which product or careers pages are there. Give any URL on the site; returns the site's page URLs with their last-modified dates, like Firecrawl's /map. Reads the sitemaps named in robots.txt, else /sitemap.xml and /sitemap_index.xml, following sitemap indexes (up to 10 child sitemaps, 20,000 URLs) and gzip (.xml.gz) sitemaps; a site with no sitemap is mapped from its home page's links on the same host. Filter with `search` (every word must appear in the URL, title or date, e.g. "pricing" or "blog 2026") and `path_prefix` (e.g. "/docs/"); `limit` up to 1,000 (default 200). next_calls read the first matches with scrape_batch. When the site cannot be reached (502) or no page matches (404), you are not charged. No account or API key. Costs $0.002 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• token_launches_peek

  Free, no payment needed. Counts the pools created against WETH, ETH or USDC on Uniswap v2, v3, v4 and Aerodrome on Base since `since_block` (or in the last `minutes`) and how many distinct tokens they are for, by DEX, with the latest block. Counts only: the token addresses, names and risk verdicts come with the paid new_token_launches, whose ready-to-send call is included when there is something new. Built for polling bots: peek for free, pay only when new_tokens > 0. Rate-limited per client.

  shallow
• token_risk_check

  Answers "Is this token a scam?", "Can I sell it?" and "Can the owner mint, freeze or tax it?" before an agent buys, accepts or lists an ERC-20 token on Base or Ethereum. Reads the contract and its proxy implementation: name, symbol, supply; owner and whether ownership is renounced; upgradeability (EIP-1967 proxies, admin); the powers its code grants a privileged account, found from its function signatures: mint new tokens, blacklist or freeze holders, change buy/sell fees, pause transfers, set max transaction or wallet limits, or keep trading switched off; and DEX liquidity: every Uniswap v2, Uniswap v3 and Aerodrome (Base) pool against WETH and USDC with reserves and an estimated USD value. The token, its owner and proxy admin are screened against OFAC. Returns a verdict (high_risk, caution, no_flags), a risk score and the reasons. Heuristics, not a sell simulation or audit. A wallet address (no code) is an error and not charged. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.01 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• token_verdict

  Answers "Is this token a scam?", "Is it safe to ape into this?", "Rug pull risk?" or "Should my agent accept this token as payment?" in one short answer. Send a token contract address on Base (default) or Ethereum. The service reads the contract and its DEX liquidity on-chain (owner powers such as minting, blacklisting, pausing, fees and trading switches; upgradeability; renounced ownership; Uniswap and Aerodrome liquidity; OFAC sanctions) and returns a grade: A (solid), B (no flags, modest liquidity), C (read the cautions), D (serious risks) or F (avoid: no liquidity, sanctioned or high-risk), a one-liner under 70 characters, a two-sentence take, the red flags and good signs, liquidity in USD and a 0-100 risk score, plus a sell test: a simulated buy from the biggest pool and sell back into it (nothing is sent on-chain) that catches honeypots and hidden buy/sell taxes. For every detail, token_risk_check returns the full evidence. Not financial advice. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.009 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• wallet_risk_check

  Answers "Is it safe to send money to this address?" before an agent pays an x402 payTo, a vendor, a user or another agent, and "Who is behind this address?". Checks, on Base or Ethereum: whether the address is on the US Treasury OFAC SDN or Consolidated lists, and whether anything controlling it is (the owner of a contract, the owners of a Safe multisig, an EIP-7702 delegate, a proxy implementation); what it is (a person's wallet, smart wallet, Safe multisig, token contract, proxy or other contract); how many transactions it has sent; its ETH and USDC balances; and flags a never-used wallet or a token contract (sending funds to one usually loses them). Returns a verdict (high_risk, caution, no_flags), a 0-100 risk score and the reasons, with an explorer link. Read live from the chain; OFAC lists refreshed every 12 hours. A screening aid, not legal advice. 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. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• web_search

  Answers any question that needs the live web: "latest news on X", "who makes Y", "documentation for Z". Returns ranked results (title, URL, snippet, date), a direct answer or knowledge-panel summary when the search engine shows one, and related searches. Filter by country, language and recency (past day, week, month, year). To read the pages too, use web_search_read (search plus the top pages as clean Markdown in one call) or scrape_markdown on a result. No results is an error and not charged. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.006 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• web_search_read

  Answers a research question in one call: searches the web, then reads the top results (up to 3) as clean Markdown with the same reader as scrape_markdown (main content, tables kept, PDFs supported), so an agent gets the sources' text instead of just links. A page that cannot be read (bot check, error) is skipped and the next result read instead, and listed in `skipped`. Also returns all results, a direct answer when there is one and related searches. Country, language and recency filters; characters per page are adjustable. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.012 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow
• x402_preflight

  Answers "Is it safe to pay this x402 endpoint?" before an agent pays a seller it has not used before. Requests the URL without paying (GET, then POST), reads the 402 challenge (x402 v1 or v2) and checks every payment option: scheme, network, amount, asset, payTo and timeout, testnet vs mainnet, and the price in USD for USDC; whether it declares a valid Bazaar listing; how fast it answers. Screens the payTo wallet against OFAC and, on Base or Ethereum, checks what it is (a wallet, multisig, or a token contract that would swallow the payment). Adds how much the endpoint and its seller are actually used: 30-day calls and unique paying wallets from the Coinbase Bazaar's published figures. Set max_price_usd to enforce a budget. Returns ok_to_pay, caution or do_not_pay with reasons. An unreachable endpoint is an answer (do_not_pay). You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.003 USDC per call via x402. Paid per call with x402 inside MCP (see the server instructions).

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/3793d193-51f1-4cd2-bcf3-a7db42aa8c6f/badge.svg)](https://vouch.tools/servers/3793d193-51f1-4cd2-bcf3-a7db42aa8c6f)