# supremeai

Pay-per-call HTTP APIs for AI agents. x402 payments, USDC on Base.
No API keys, no signup. Free preview: GET /v1/preview
Machine listing: https://agents.supremeai.ca/.well-known/x402.json

MCP server (free, same tools):
  Streamable HTTP: https://agents.supremeai.ca/mcp
  SSE (legacy):    https://agents.supremeai.ca/mcp/sse

## POST https://agents.supremeai.ca/v1/validate  ($0.002 USDC/call)
Validate a Latin American tax ID with full checksum verification: Brazil CNPJ, Argentina CUIT, Chile RUT, Peru RUC, Paraguay RUC (Mexico RFC structural). Deterministic, offline, no rate limits. Returns valid/invalid, normalized form, and failure reason. For KYB pre-screening and invoice/form validation.

## POST https://agents.supremeai.ca/v1/validate/batch  ($0.01 USDC/call)
Batch-validate up to 100 Latin American tax IDs (Brazil CNPJ, Argentina CUIT, Chile RUT, Peru RUC, Paraguay RUC, Mexico RFC format) with full checksum verification. Body {items:[{country,id}]}. For cleaning lead lists and bulk KYB.

## POST https://agents.supremeai.ca/v1/health-check  ($0.003 USDC/call)
Probe a public HTTP(S) URL and report availability: up/down, HTTP status, and latency in ms. Use it to check whether another paid API or x402 service is alive before spending money calling it. Public internet targets only.

## POST https://agents.supremeai.ca/v1/npm/package  ($0.005 USDC/call)
Look up an npm package: latest version, license, description, weekly downloads, dependency count, last publish date, and repository URL. One call instead of scraping npmjs.com. For dependency analysis, package vetting, and competitive research on JavaScript libraries.

## POST https://agents.supremeai.ca/v1/github/repo  ($0.005 USDC/call)
Look up a GitHub repository: stars, forks, open issues, primary language, license, default branch, topics, and last push time. One call, structured JSON. For open-source vetting, competitive analysis, and tracking project activity.

## POST https://agents.supremeai.ca/v1/pypi/package  ($0.005 USDC/call)
Look up a PyPI package: latest version, license, summary, required Python version, dependency count, homepage, and release count. One call, structured JSON. For Python dependency analysis and package vetting.

## POST https://agents.supremeai.ca/v1/preflight  ($0.01 USDC/call)
Check an x402 endpoint BEFORE paying it. Makes one unpaid request (never sends money), decodes the 402 terms, and verifies: the asset is a real USD stablecoin on that network, the price in USD vs your max_price_usd cap (default $0.50), payTo is a sane address (and matches expected_pay_to if given), HTTPS and certificate validity, redirects, and domain age. Returns safe_to_pay, a risk level, findings, and the cheapest acceptable payment option.

## POST https://agents.supremeai.ca/v1/read  ($0.005 USDC/call)
Read a public web page as clean markdown: main content only (navigation, ads and footers stripped), plus title, author, date and site name. Fast plain fetch — for JavaScript-heavy pages use /v1/read/render. Not charged if the page can't be fetched.

## POST https://agents.supremeai.ca/v1/read/render  ($0.01 USDC/call)
Read a JavaScript-heavy page as clean markdown: renders it in a headless browser first (SPAs, client-side content), then extracts the main content, title, author and date. Not charged if the page can't be loaded.