# Ontario Protocol

> Ontario Protocol runs a live x402 API finder and paid first-party Base reads (wallet balances, transaction checks and gas), plus a free x402 readiness verifier and pay-per-call provider listing endpoints. Paid calls settle in USDC on Base through x402; no account or API key.

> Settlement evidence (when available) is published via /treasury and /api/treasury/ledger. Always verify independently and treat evidence as time-bound.

## First-party paid endpoints

- POST [/api/x402/find-api](https://ontarioprotocol.com/api/x402/find-api) — 0.005 USDC. Live API finder for one task: body `{"task": "...", "max_usdc": "0.01"}`, or `GET /api/x402/find-api?task=...`. Returns up to 5 paid x402 APIs that answered a fresh unpaid probe with a valid Base USDC 402, ranked by task fit, price and Bazaar-reported repeat buyers, each with live price, network and a ready-to-call request. Candidates come from Ontario's copy of the Coinbase Bazaar catalog, with live Bazaar and Agentic Market search as fallback. The search runs before settlement: no live match, no charge. Provider calls are paid separately.
- GET [/api/x402/base/balances](https://ontarioprotocol.com/api/x402/base/balances) — 0.002 USDC. Query `address=0x...` and optional `tokens=0x...,0x...` (up to 20). ETH, USDC and about 25 widely held Base tokens with a nonzero balance, plus every named token, with symbol, decimals, raw and formatted amounts and the block read. No prices or USD values. Failed read, no charge.
- GET [/api/x402/base/tx-check](https://ontarioprotocol.com/api/x402/base/tx-check) — 0.002 USDC. Query `hash=0x...`, optional `expected_to` and `expected_amount` (atomic units). Status, block, timestamp and confirmations, ERC-20 Transfers (up to 100 listed; `transfers_total` gives the full count) and EIP-3009 authorizations decoded, and match flags for the expected payTo and amount, which cover every USDC transfer. Transaction not found or pending, no charge.
- GET [/api/x402/base/gas](https://ontarioprotocol.com/api/x402/base/gas) — 0.0015 USDC. Base fee, priority-fee p25/p50/p90 over the last 20 blocks, slow/normal/fast maxFeePerGas suggestions, L1 data-fee upper bounds and total-cost estimates for an ETH and an ERC-20 transfer. Estimates, not inclusion guarantees. Failed read, no charge.
- POST [/api/x402/list-service](https://ontarioprotocol.com/api/x402/list-service) — 0.50 USDC. Publish a third-party launch passport with 30 days of included freshness maintenance.
- POST [/api/x402/refresh-listing](https://ontarioprotocol.com/api/x402/refresh-listing) — 0.10 USDC after included maintenance expires. Refresh one paid profile's observable readiness evidence.
- POST [/api/x402/list-agent](https://ontarioprotocol.com/api/x402/list-agent) — 0.10 USDC. Submit an agent for inclusion in the directory.
- Finder and Base read method, probe User-Agent, opt-out contact and limits: [x402 API finder docs](https://ontarioprotocol.com/docs/x402-api-finder).
- Agent skill for these routes: [SKILL.md](https://ontarioprotocol.com/SKILL.md), with curl, @x402/fetch, Coinbase Agentic Wallet (`npx awal@2.12.1 x402 pay`) and AgentCash invocations; listed with its SHA-256 digest in [/.well-known/agent-skills/index.json](https://ontarioprotocol.com/.well-known/agent-skills/index.json) (`npx skills add https://ontarioprotocol.com`).

## How agents use this site

Note for Google Search: this file is for autonomous agents and non-Google LLM
crawlers. Google AI Search visibility should be earned through normal Google
Search fundamentals: useful original content, crawlability, indexability,
structured pages, and Search Console feedback.

- [x402 manifest](https://ontarioprotocol.com/.well-known/x402.json): Standardised discovery manifest (machine-readable, free)
- [Agent invitation JSON](https://ontarioprotocol.com/.well-known/agent-invite.json): Machine-readable decision contract for discover, verify, can-pay, sandbox, and citation flow
- [Agent buyer guide JSON](https://ontarioprotocol.com/.well-known/agent-buyer.json): Machine-readable list of Ontario's paid tools with price, network and result, plus the x402 challenge, payment and receipt flow
- [Agent payment policy JSON](https://ontarioprotocol.com/.well-known/agent-payment-policy.json): Machine-readable allow/review/deny policy contract that the free can-pay API applies
- [Agent skill](https://ontarioprotocol.com/SKILL.md): Installable skill for the x402 API finder and Base reads, indexed at /.well-known/agent-skills/index.json.
- [Entity definition JSON](https://ontarioprotocol.com/.well-known/entity.json): Canonical brand/category/contact/trust-boundary facts for agents and answer engines
- [Visibility manifest](https://ontarioprotocol.com/.well-known/visibility.json): Public-safe SEO, SoMe, and GEO score contract with social preview metadata and scored page sets
- [Answer pack](https://ontarioprotocol.com/.well-known/answer-pack.json): Compact source-backed x402 answers with canonical URLs, receipt URLs, SHA-256 digests, and guardrails
- [Citation receipts](https://ontarioprotocol.com/.well-known/citation-receipts.json): GEO claim receipts for short answer extraction with evidence URLs and digests
- [Claim index](https://ontarioprotocol.com/.well-known/claims.json): Claim-level retrieval index with stable claim IDs, visible selectors, citation receipts, SHA-256 digests, and an NDJSON feed at https://ontarioprotocol.com/api/geo/claims.ndjson
- [Answer evaluation corpus](https://ontarioprotocol.com/.well-known/answer-evals.json): Self-test prompts, accepted citations, digests, and forbidden inferences for answer engines. NDJSON feed: https://ontarioprotocol.com/api/geo/eval-corpus.ndjson
- [x402 readiness verifier](https://ontarioprotocol.com/verify): Free checker for HTTP 402 challenges, x402 manifest, OpenAPI schema, robots policy, and Bazaar-style catalog metadata. Ready results expose free listing validation before the optional 0.50 USDC provider publication; non-ready results say to fix before paying.
- [x402 Tool Router](https://ontarioprotocol.com/tools/x402-tool-router): Free buyer-side search across fresh strict-ready Ontario paid profiles, Agentic Market, and Coinbase Bazaar with task, network, and USDC budget filters; returns unverified marketplace candidates (the paid finder returns live-checked ones), paid publication adds no ranking score, and the router never makes a payment
- POST [Ontario purchase router](https://ontarioprotocol.com/api/agent/tool-quote): Free deterministic routing across Ontario tools. Empty or commonly wrapped agent calls receive free input guidance; existing paid provider profiles can route to the 0.10 USDC evidence refresh only after free validation. Paid recommendations name the tool, its price and network; the router never calls a tool or spends funds.
- [Agent Payment Firewall](https://ontarioprotocol.com/agent-payment-firewall): Global product page for can-pay policy, x402 pre-payment checks, and implementation packets before agents spend
- [Agent payment policy docs](https://ontarioprotocol.com/docs/agent-payment-policy): How agents and registries should use the payment policy JSON before wallet signing
- [Danish AI/MCP trust audit](https://ontarioprotocol.com/dk/ai-agent-mcp-audit): Human buyer page for fixed-scope AI assistant, MCP tool, and x402 payment-readiness audits in Denmark
- [Ontario x402 Trust Standard](https://ontarioprotocol.com/trust): Public scoring policy for x402 endpoint readiness
- [Trust methodology: what Ontario checks](https://ontarioprotocol.com/trust/what-ontario-checks): What Ontario verifies and reports as evidence
- [Trust methodology: what Ontario does not check](https://ontarioprotocol.com/trust/what-ontario-does-not-check): Limits and excluded checks; use your own policy for gaps
- [Trust standard JSON](https://ontarioprotocol.com/.well-known/x402-trust.json): Machine-readable scoring weights, thresholds, discovery policy, badge policy, and evidence surfaces
- [Service listing JSON Schema](https://ontarioprotocol.com/.well-known/x402-list-service.schema.json): Payload contract for `POST /api/x402/list-service` (paid) and `POST /api/x402/list-service/validate` (free)
- [Agent listing JSON Schema](https://ontarioprotocol.com/.well-known/x402-list-agent.schema.json): Payload contract for `POST /api/x402/list-agent` (paid) and `POST /api/x402/list-agent/validate` (free)
- [Discover catalog](https://ontarioprotocol.com/discover): Flat machine catalog of every paid endpoint, with optional `?category=...` filter
- [Listings (humans)](https://ontarioprotocol.com/listings): Same data with HTML rendering; pass `Accept: application/json` to get JSON
- [Validate a service listing payload (free)](https://ontarioprotocol.com/api/x402/list-service/validate): JSON shape validation + normalization (no payment; does not store a listing). Add `"verify_now": true` to receive signed readiness evidence plus a grade-aware, privacy-safe `provider_publication.agent_checkout` request for the paid handoff.
- [Submit a service listing (paid)](https://ontarioprotocol.com/api/x402/list-service): 0.50 USDC provider publication; creates a canonical profile, readiness evidence, badge, 30 days of included automatic freshness maintenance, conditional fresh ready-grade eligibility in strict `/discover` and Ontario's task-to-tool buyer search, and a privacy-safe 30-day profile request receipt. It does not buy ranking, traffic, leads, purchases, or safety.
- [Validate an agent listing payload (free)](https://ontarioprotocol.com/api/x402/list-agent/validate): JSON shape validation for the optional agent directory (no payment; does not store a listing)
- [Listing status](https://ontarioprotocol.com/api/listings/status): Marketplace pipeline status (pending vs ready) and aggregate counts
- [Verification reports](https://ontarioprotocol.com/reports): Public signed report index plus monitored service profiles
- [Verified service profiles](https://ontarioprotocol.com/api/verify/services): Machine-readable trust graph with certification, score history, and latest report links
- [Verification dataset](https://ontarioprotocol.com/api/verify/dataset.json): Schema.org Dataset JSON-LD for crawlers and agent indexes
- [Paid API Benchmark Lab](https://ontarioprotocol.com/benchmarks): Crawlable benchmark ranking for x402-paid AI-agent APIs
- [x402 paid API benchmarks](https://ontarioprotocol.com/benchmarks/x402): x402-only benchmark view with score breakdowns
- [Paid API benchmark compare](https://ontarioprotocol.com/benchmarks/compare): Side-by-side score deltas for two paid API benchmark rows
- [Best x402 verification tools before agent payment](https://ontarioprotocol.com/compare/x402-verification-tools): Decision page comparing readiness reports, discovery, manifest validation, 402 challenge checks, preflight policy, benchmarks, and schema checks
- [x402 agent decision playbooks](https://ontarioprotocol.com/playbooks): 100 finite evidence-backed pre-payment decision pages for agents, API providers, marketplaces, security reviewers, and enterprise teams
- [Agent decision playbooks JSON](https://ontarioprotocol.com/.well-known/agent-decision-playbooks.json): Machine-readable index of the controlled x402 decision page batch
- [Benchmark dataset](https://ontarioprotocol.com/api/benchmarks): Machine-readable benchmark scores for uptime, payment correctness, schema quality, price clarity, network clarity, and report history
- [Benchmark well-known JSON](https://ontarioprotocol.com/.well-known/paid-api-benchmarks.json): Agent-discoverable benchmark dataset
- [Evidence proof pages](https://ontarioprotocol.com/proof/): Crawlable scanner evidence, remediation examples, live readiness benchmark, and MCP paid-tool checklist
- [Weekly x402 ecosystem intelligence](https://ontarioprotocol.com/intelligence): Indexable report on new services, broken implementations, protocol changes, scanner improvements, and task feedback
- [x402 buyer-market benchmark](https://ontarioprotocol.com/intelligence/x402-buyer-market-benchmark): Public source-reported 30-day endpoint activity snapshot showing where paid-agent calls and endpoint-payer signals appear, with explicit non-revenue and non-unique-user boundaries
- [x402 buyer-market benchmark JSON](https://ontarioprotocol.com/api/intelligence/x402-buyer-market-benchmark.json): Machine-readable benchmark snapshot for agents, providers, and answer engines; no payment or credentials required
- [x402 tools ranked by observed buyer activity](https://ontarioprotocol.com/rankings/x402-tools-by-buyer-activity): Free task-level comparison for agent email, blockchain data, web search, market data, enrichment, inference, media, travel, storage, and validation. Rankings use public call and endpoint payer-count signals, not safety, quality, endorsement, or verified revenue.
- [x402 buyer-activity rankings JSON](https://ontarioprotocol.com/api/intelligence/x402-tools-by-buyer-activity.json): Compact machine-readable rankings by concrete agent job, with price, network, source rows, and free pre-payment verification links.
- [x402 buyer-activity well-known JSON](https://ontarioprotocol.com/.well-known/x402-buyer-activity.json): Stable agent-discovery alias for the dated buyer-activity ranking feed.
- [Hermes intelligence queue](https://ontarioprotocol.com/.well-known/hermes-skills/x402-ecosystem-intelligence.json): Machine-readable scanner, docs, and product tasks generated from repeated findings

## Free verifier endpoint

- POST [/api/verify/x402-readiness](https://ontarioprotocol.com/api/verify/x402-readiness): Free x402 readiness report with score, signals, evidence, actionable fixes, and an unsigned grade-aware provider listing next step. Publication never buys readiness, ranking, traffic, leads, purchases, or safety.
- GET [/api/verify/x402-readiness?target_url=...](https://ontarioprotocol.com/api/verify/x402-readiness): Same report for query-string clients.
- GET [/api/verify/reports](https://ontarioprotocol.com/api/verify/reports): Public verification report ledger.
- GET `/api/verify/reports/{report_id}`: Full public readiness report by id.
- GET `/api/verify/reports/{report_id}/integrity`: Ed25519 signature metadata and server-side validity check.
- GET `/api/verify/reports/{report_id}/sla`: SLA evidence with uptime and verification latency metrics.
- GET [/api/verify/services](https://ontarioprotocol.com/api/verify/services): Monitored x402 endpoint profiles with certification and report history.
- GET `/api/verify/services/{slug}`: One service profile.
- GET `/api/verify/history?target_url=...`: Signed readiness history for one endpoint.
- GET [/api/verify/dataset.json](https://ontarioprotocol.com/api/verify/dataset.json): JSON-LD dataset of the verification graph.
- GET [/api/x402/marketplace-trust-feed](https://ontarioprotocol.com/api/x402/marketplace-trust-feed?limit=25): bounded public sample of the marketplace trust-feed contract; exposes ready/review/deny_or_hold state, freshness, warnings, report IDs, and integrity links without contact data or payment credentials.
- POST [/api/agent/can-pay](https://ontarioprotocol.com/api/agent/can-pay): Free payment firewall. Returns allow/review/deny before an agent pays an x402 endpoint.
- POST [/api/agent/tool-quote](https://ontarioprotocol.com/api/agent/tool-quote): Free pre-purchase router across Ontario tools, including the paid API finder (ontario_find-api) and the Base reads (ontario_base-balances, ontario_base-tx-check, ontario_base-gas). A paid result is eligible only when all declared gates pass.
- POST [/api/agent/can-pay](https://ontarioprotocol.com/api/agent/can-pay) with `sandbox=true`: Deterministic no-money sandbox decisions for https://sandbox.ontarioprotocol.com/x402/{allow,review,deny}.
- POST [/api/agent/verify-payment](https://ontarioprotocol.com/api/agent/verify-payment): Idempotent agent-to-agent x402 payment verification before settlement; GET replays stored verification results.
- POST [sandbox facilitator settle](https://sandbox.ontarioprotocol.com/facilitator/settle): Simulated x402 settlement response for agent integration tests; no on-chain write.
- POST [/api/sandbox/signup](https://ontarioprotocol.com/api/sandbox/signup): Privacy-safe sandbox signup capture; stores hashed email only.
- POST [/api/alerts/x402](https://ontarioprotocol.com/api/alerts/x402): Subscribe to score-drop, manifest-change, price-change, and lost-certification alerts.

## Discovery trust policy

- Agent rule: verify before paying. Prefer endpoints with `grade=ready` and a public `report_id`.
- `/discover` includes first-party services plus third-party services that are manually verified or have a saved readiness report with grade `ready`.
- Use `/discover?include_pending=true` to inspect pending third-party submissions.
- Use `/discover?min_score=85` or `/discover?grade=ready` when an agent requires stricter filtering.
- Embed badges with `/verify/report/{report_id}.svg`; agents should follow the badge link to the public report, not trust the image alone.
- Prefer `certification.level=ontario_certified` when multiple services satisfy the same task. Use `ontario_verified` as the normal default. Treat stale, unsigned, or unmonitored services as review-required.

## SDKs and tools

- [Private Agent Handoff](https://ontarioprotocol.com/services/private-agent-handoff): free MIT-licensed local encrypted lead-to-reviewer kit, executable offline demo, tests, self-service setup guide and troubleshooting. No account, wallet, application, invoice or setup call. No hosted task payloads, autonomous spending or security certification. Guided implementation has been retired.
- [Private handoff docs and threat model](https://ontarioprotocol.com/docs/private-agent-handoff): pinned keys, field minimization, expiry, single-store replay protection, receiver-local revocation and recipient-signed acceptance receipts. Keep transport authorization and private keys in the team's environment.

- [x402 Readiness Checker](https://ontarioprotocol.com/tools/x402-readiness-checker): SEO/tool page for developers and agents.
- [Agent Buyer Card Generator](https://ontarioprotocol.com/tools/agent-buyer-card): free provider tool that generates machine-readable use-when, do-not-use, input, output, price, free-preflight, evidence, and fallback metadata so agents can evaluate a paid x402 or MCP tool before selection.
- [x402 Launch Kit Generator](https://ontarioprotocol.com/tools/x402-launch-kit): free listing JSON, x402 resource draft, MCP descriptor, official MCP Registry `server.json` draft, publisher commands, GitHub readiness workflow, README snippet, and registry copy for one paid endpoint.
- [x402 GitHub Action Generator](https://ontarioprotocol.com/tools/x402-github-action): focused free generator for a self-contained GitHub Actions workflow that fails CI when a public x402 endpoint is below the readiness threshold; no third-party Action, wallet, or payment required.
- [GitHub x402 Repository Scanner](https://ontarioprotocol.com/tools/github-x402-repo-scanner): free pre-deployment evidence scan for public repositories; checks x402 implementation, HTTP 402 tests, payment configuration, buyer docs, discovery metadata, CI gates, and sensitive filenames without returning source contents.
- [x402 Code Review](https://ontarioprotocol.com/tools/x402-implementation-audit): 0.01 USDC bounded code-review-style check for a public endpoint or GitHub repository; returns actionable payment, discovery, security, debugging, and launch findings after free checks, without returning source contents or secret values.
- [x402 Settlement Authenticity Checker](https://ontarioprotocol.com/tools/x402-settlement-authenticity): free Base USDC receipt check that classifies direct self-payment, user-declared related-party, or unattributed evidence without treating unknown wallets as proven customers.
- [x402 Adoption Authenticity Research](https://ontarioprotocol.com/research/x402-adoption-authenticity-2026): source-backed response to July 2026 population-scale x402 research, including a free aggregate calculator that returns supportable public wording without applying ecosystem-wide percentages as a provider verdict.
- POST [x402 Demand Claim Boundary](https://ontarioprotocol.com/api/tools/x402-demand-claim-boundary): free aggregate claim calculator. It accepts counts only, stores no hashes or wallet data, and separates known related activity, user-declared external attribution, and unattributed settlements without inventing customers.
- [How Agentic Is Agentic Commerce?](https://ontarioprotocol.com/answers/how-agentic-is-agentic-commerce): source-backed July 2026 research answer connecting x402 adoption-authenticity findings to the free receipt checker, the 0.02 USDC batch report, explicit related-address disclosure, and a citation receipt. It does not convert unattributed wallets into customer counts.
- [x402 Independent Demand Audit](https://ontarioprotocol.com/services/x402-independent-demand-audit): qualified $199 review of up to 500 public Base receipts, disclosed related addresses, payer concentration, and supportable demand claims; no checkout or independent-customer guarantee.
- [Human x402 Code Review](https://ontarioprotocol.com/services/x402-code-review): qualified $49 fixed-scope repair memo for one public x402 endpoint or repository; prioritizes the highest-impact payment, discovery, debugging, and launch fixes after free checks. Invoice after scope confirmation; no wallet custody, settlement execution, safety guarantee, or demand guarantee.
- [MCP Registry Readiness Checker](https://ontarioprotocol.com/tools/mcp-registry-readiness): free evidence check for a public MCP Registry record and live MCP remote; checks namespace metadata, HTTPS transport, read-only initialize/tools-list responses, and optional x402 discovery surfaces without credentials or tool calls.
- [Agent Catalog Readiness Checker](https://ontarioprotocol.com/tools/agent-catalog-readiness): free provider scorecard combining a public x402 endpoint, GitHub launch evidence, and MCP Registry or remote evidence before agents discover or pay.
- [Agent Buyer Conversion Diagnostic](https://ontarioprotocol.com/tools/agent-buyer-conversion-diagnostic): free end-to-end provider diagnosis for payment readiness, exact Bazaar activation, five buyer-task retrieval samples, submitted budget/network policy, and public demand evidence. It returns the earliest observable purchase blocker and withholds paid offers when the sample does not justify work. An explicit `publish_report: true` creates a public Buyer Path Receipt and README badge; the public artifact omits the submitted budget, raw verifier evidence, credentials, wallet data, and payment payloads.
- [Founding Agent Catalog Publish Pilot](https://ontarioprotocol.com/services/agent-catalog-publish): qualified $49 outcome-based publication workflow for one x402 endpoint or remote MCP server. The publication invoice is issued only after two agreed catalog surfaces are visibly live; provider accounts, ownership confirmations, wallets, and settlement remain provider-controlled. No acceptance, ranking, traffic, safety, or revenue guarantee.
- [x402 Buyer Discovery Audit](https://ontarioprotocol.com/tools/coinbase-bazaar-readiness): free provider audit combining one public endpoint, five live CDP Bazaar buyer-search variations, observed retrieval coverage and ranks, public 30-day call and unique-payer fields, visible Base-USDC price bands, HTTP 402, manifest, schema, price/network, freshness, and activation evidence. Public quality counts can include owner-funded calls and are not revenue. No payment or settlement.
- [x402 Bazaar EXTENSION-RESPONSES Debugger](https://ontarioprotocol.com/tools/x402-bazaar-extension-debugger): free parser for accepted, processing, rejected, malformed, or missing Bazaar extension response evidence; it never settles, requests wallet credentials, or echoes raw headers.
- [MCP + x402 Agent Catalog Launch Pack](https://ontarioprotocol.com/services/x402-agent-catalog-launch-pack): qualified $199 fixed-scope review that turns one provider's public endpoint, repository, and registry evidence into a launch packet; no ranking, safety, traffic, or registry-acceptance guarantee.
- [x402 Rail Fit Memo](https://ontarioprotocol.com/services/x402-rail-fit-review): qualified $99 one-time review for one endpoint or proposed endpoint; compares current network/facilitator support, payment metadata, agent budget fit, and launch blockers without executing settlement or promising demand.
- [Agent Payment Preflight Review](https://ontarioprotocol.com/services/agent-payment-preflight-review): qualified $49 one-time review for one agent workflow, target endpoint, and spend policy; checks can-pay decisions, HTTP 402 behavior, retry failures, and audit evidence without wallet custody.
- [x402 Readiness Watch](https://ontarioprotocol.com/services/x402-readiness-watch): qualified $99/month pilot for up to five public endpoints with proposed daily evidence, report history, and configured drift alerts; schedule and delivery are confirmed before invoicing and no SLA is implied.
- [x402 Marketplace Trust Feed](https://ontarioprotocol.com/services/x402-marketplace-trust-feed): qualified $199/month pilot for directories, registries, and agent platforms that need signed readiness, warning, freshness, and report-integrity evidence before ranking or listing paid endpoints. No ranking, traffic, listing-acceptance, safety, or revenue guarantee.
- [x402 API Pricing Calculator](https://ontarioprotocol.com/tools/x402-pricing-calculator): free provider utility that models infrastructure cost, retries, facilitator fees, margin, and agent budget before a per-call price is published.
- [x402 Tool Router](https://ontarioprotocol.com/tools/x402-tool-router): free task-to-tool search across fresh strict-ready Ontario paid profiles and public marketplace metadata. Task relevance ranks first; paid publication adds no score, and source activity remains a bounded secondary signal. MCP tool: `find_x402_tool`. HTTP API: `POST /api/tools/x402-tool-router`. Candidates are unverified marketplace listings (the paid finder returns live-checked ones), not recommendations or safety certifications.
- Ontario Free/Paid Purchase Router: MCP tool `ontario_purchase_router` and HTTP API `POST /api/agent/tool-quote`. Use it before selecting a paid Ontario tool. A missing public task returns free examples instead of a guessed purchase; existing providers can ask to refresh an x402 listing after validating eligibility. It never signs or settles.
- [Offline x402 Repository Gate](https://ontarioprotocol.com/static/downloads/ontario-x402-repo-gate.zip): portable local composite Action and CLI that scans the checked-out worktree without transmitting source. [File manifest](https://ontarioprotocol.com/static/downloads/ontario-x402-repo-gate-manifest.json) · [SHA-256](https://ontarioprotocol.com/static/downloads/ontario-x402-repo-gate.zip.sha256).
- [Public GitHub x402 Repository Gate](https://github.com/thom899g/ontario-x402-repo-gate): free reviewed GitHub Action and Python gate; install with `thom899g/ontario-x402-repo-gate@v1`. It emits JSON and SARIF, lists sensitive filenames without reading contents, and does not require a wallet, API key, or Ontario callback.
- [Google AI Search checklist](https://ontarioprotocol.com/docs/google-ai-search-checklist): Ontario's internal SEO/GEO guardrails mapped to Google's official guidance.
- [Search Console indexing playbook](https://ontarioprotocol.com/docs/search-console-indexing-playbook): Ontario's 404, discovered-not-indexed, crawled-not-indexed, and redirect triage workflow.
- [x402 agent discovery guide](https://ontarioprotocol.com/docs/x402-agent-discovery): How providers align manifests, MCP listings, GitHub README evidence, payment challenges, and readiness reports before promotion.
- [Agent payment policy JSON docs](https://ontarioprotocol.com/docs/agent-payment-policy): Publishable policy contract for allow/review/deny before agents pay or invoke payment-capable tools.
- [Core sitemap](https://ontarioprotocol.com/sitemap-core.xml): Highest-value pages for Search Console request-indexing and crawl priority.
- [Evidence sitemap](https://ontarioprotocol.com/sitemap-evidence.xml): Citation receipts, proof pages, benchmark details, and supporting machine-readable evidence.
- [Paid provider sitemap](https://ontarioprotocol.com/sitemap-providers.xml): Dynamic crawl inventory of paid provider profiles only; pending submissions are excluded.
- [x402 verification tools comparison](https://ontarioprotocol.com/compare/x402-verification-tools): Structured pre-payment decision map for agents and answer engines.
- [Agent decision playbooks](https://ontarioprotocol.com/playbooks): Search Console-informed playbooks for pre-payment checks, reject conditions, and Ontario API calls.
- [Agent payment verification API](https://ontarioprotocol.com/docs/agent-payment-verification): idempotent REST API for verifying agent-to-agent x402 payment payloads before settlement.
- [Agent commerce sandbox](https://ontarioprotocol.com/docs/agent-commerce-sandbox): deterministic can-pay fixtures, simulated facilitator endpoints, and sample code for safe x402 agent trials.
- [Agent sandbox demo](https://ontarioprotocol.com/sandbox/demo): browser demo that calls `/api/agent/can-pay` in sandbox mode and shows allow/review/deny responses.
- [Common x402 implementation mistakes](https://ontarioprotocol.com/proof/common-x402-implementation-mistakes): scanner warning classes with fixes.
- [Broken x402 manifest before/after](https://ontarioprotocol.com/proof/broken-x402-manifest-before-after): concrete remediation example.
- [Live x402 endpoint readiness benchmark](https://ontarioprotocol.com/proof/live-x402-endpoint-readiness-benchmark): generated from signed reports and service profiles.
- [Paid API benchmark scoring](https://ontarioprotocol.com/proof/paid-api-benchmark-scoring): how benchmark scores are calculated without paid settlement calls.
- [MCP paid-tool security checklist](https://ontarioprotocol.com/proof/mcp-paid-tool-security-checklist): tool schema, human review, and x402 payment safety checklist.
- [Leaderboard](https://ontarioprotocol.com/leaderboard): Ranked public x402 readiness reports.
- [Reports](https://ontarioprotocol.com/reports): Signed report index and service profiles.
- [Python preflight helper](https://ontarioprotocol.com/static/sdk/ontario_preflight.py)
- [TypeScript preflight helper](https://ontarioprotocol.com/static/sdk/ontario-preflight.ts)
- [SDK README](https://ontarioprotocol.com/static/sdk/README.md)
- CLI in repo: `python3 scripts/ontario.py verify https://example.com/api/paid-endpoint --min-score 85`
- Self-contained GitHub workflow generator: `POST https://ontarioprotocol.com/api/tools/x402-launch-kit`
- Launch kit API: `POST https://ontarioprotocol.com/api/tools/x402-launch-kit`
- GitHub repository scanner API: `POST https://ontarioprotocol.com/api/tools/github-x402-repo-scanner` with `{"repository_url":"https://github.com/owner/repo"}`. Public repositories only; no code execution, private access, or secret-content output.
- MCP Registry readiness API: `POST https://ontarioprotocol.com/api/tools/mcp-registry-readiness` with `{"server_json_url":"https://registry.example/server.json","remote_url":"https://example.com/mcp"}`. Read-only metadata checks; no credentials, payment headers, or tool invocation.
- Agent catalog readiness API: `POST https://ontarioprotocol.com/api/tools/agent-catalog-readiness` with any public `endpoint_url`, `repository_url`, `server_json_url`, or `remote_url`. Combines bounded public checks; no credentials, payment headers, private source, or tool invocation.
- Agent buyer conversion API: `POST https://ontarioprotocol.com/api/tools/agent-buyer-conversion-diagnostic` with `endpoint_url`, one public `buyer_query`, and optional `max_budget_usdc`, `allowed_network`, `agent_policy`, repository, or MCP evidence. Returns the first observed blocker across readiness, activation, retrieval, buyer policy, and demand evidence; no payment, wallet, secret collection, or revenue guarantee. Set `publish_report: true` only for public-safe inputs to receive `share_url`, `report_url`, and `badge_url`.
- Agent Buyer Card API: `POST https://ontarioprotocol.com/api/tools/agent-buyer-card` with public service name, endpoint, exact agent job, required inputs, returned output, USDC price, network, and optional preflight/evidence URLs. Deterministic formatting only; no endpoint fetch, tool call, payment, credential collection, or demand guarantee.
- Bazaar buyer-intent and readiness API: `POST https://ontarioprotocol.com/api/tools/coinbase-bazaar-readiness` with `{"target_url":"https://example.com/api/paid","buyer_query":"verify an x402 endpoint before payment"}`. Returns one bounded CDP semantic-search sample plus read-only metadata and payment-challenge checks; no wallet, signature, settlement, global-rank, catalog-placement, traffic, or revenue guarantee. The same free check is exposed in the full MCP catalog as `bazaar_buyer_intent_gap`.
- Bazaar extension debugger API: `POST https://ontarioprotocol.com/api/tools/x402-bazaar-extension-debugger` with `{"extension_responses":{"bazaar":{"status":"processing"}}}`. Returns normalized status and remediation only; never send private keys, seed phrases, payment signatures, or full payment payloads.
- Free provider launch preflight: `POST https://ontarioprotocol.com/api/x402/list-service/request` validates public metadata but stores and publishes nothing; optional `"verify_now": true` returns a free readiness report summary and machine-ready checkout object. It does not charge or make the service a recommendation.
- x402 pricing calculator API: `POST https://ontarioprotocol.com/api/tools/x402-pricing-calculator` with monthly infrastructure cost, successful call volume, margin, optional retry/fee assumptions, and an optional agent price ceiling. Free, deterministic planning output; no credentials, endpoint fetches, or payment calls.

## SEO distribution pages

- [x402 payment verification guide](https://ontarioprotocol.com/docs/x402-payment-verification): high-intent guide for verifying x402 paid endpoints before agents spend.
- [Autonomous agent commerce](https://ontarioprotocol.com/docs/autonomous-agent-commerce): architecture for discover, verify, decide, pay, settle, and monitor.
- [Enterprise x402 trust](https://ontarioprotocol.com/docs/enterprise-x402-trust): enterprise evidence model for paid AI-agent endpoints.
- [x402 service listing quickstart](https://ontarioprotocol.com/docs/x402-service-listing-quickstart): task-first guide for getting a third-party listing into /listings and eligible for /discover filters.
- [x402 payment verification tool](https://ontarioprotocol.com/tools/x402-payment-verification): repeatable verification workflow for developers and agent operators.
- [Enterprise x402 trust audit](https://ontarioprotocol.com/tools/enterprise-x402-trust-audit): audit workflow for readiness, certification, drift alerts, and settlement health.

## GEO use-case pages

- [AI agent payment preflight](https://ontarioprotocol.com/use-cases/ai-agent-payment-preflight)
- [x402 readiness for developers](https://ontarioprotocol.com/use-cases/x402-readiness-for-developers)
- [Coinbase Bazaar readiness](https://ontarioprotocol.com/use-cases/coinbase-bazaar-readiness)
- [HTTP 402 payment validator](https://ontarioprotocol.com/use-cases/http-402-payment-validator)

## Search-intent answer pages

- [x402 readiness checker](https://ontarioprotocol.com/answers/x402-readiness-checker): direct answer plus verifier API entry point.
- [x402 verifier](https://ontarioprotocol.com/answers/x402-verifier): what agents should require before paying.
- [x402 verifier citation receipt](https://ontarioprotocol.com/answers/x402-verifier/citation-receipt): digest-backed claim, JSON mirror, Markdown receipt, and citation guardrails for the x402 verifier answer.
- [x402 manifest validator](https://ontarioprotocol.com/answers/x402-manifest-validator): /.well-known/x402.json checks.
- [HTTP 402 payment validator](https://ontarioprotocol.com/answers/http-402-payment-validator): payment challenge readiness.
- [AI agent payment preflight](https://ontarioprotocol.com/answers/ai-agent-payment-preflight): can-pay policy decision before wallet spend.
- [Wallet-enabled x402 buyer client](https://ontarioprotocol.com/docs/agent-payment-client): guide for connecting an x402 wallet client or MCP bridge, reading 402 requirements, and retrying with a signed payment.
- [Coinbase Bazaar readiness](https://ontarioprotocol.com/answers/coinbase-bazaar-readiness): Bazaar-style endpoint discovery signals.
- [Paid AI-agent endpoint discovery](https://ontarioprotocol.com/answers/paid-ai-agent-endpoint-discovery): verified services and service profiles.
- [x402 service certification](https://ontarioprotocol.com/answers/x402-service-certification): Ontario Verified and Ontario Certified x402 status.
- [MCP x402 marketplace](https://ontarioprotocol.com/answers/mcp-x402-marketplace): MCP descriptors for paid x402 tools.
- [x402 OpenAPI validator](https://ontarioprotocol.com/answers/x402-openapi-validator): OpenAPI checks for paid APIs.
- [x402 service listing](https://ontarioprotocol.com/answers/x402-service-listing): how to submit a third-party listing and reach /discover readiness.
- [GEO manifest](https://ontarioprotocol.com/.well-known/geo.json): machine-readable map of answer pages, JSON mirrors, OpenAPI, sitemap, and citation policy.
- [Visibility manifest](https://ontarioprotocol.com/.well-known/visibility.json): machine-readable SEO, social preview, and GEO score contract for public pages.
- [Answer pack](https://ontarioprotocol.com/.well-known/answer-pack.json): compact direct-answer bundle for answer engines, with Markdown mirror at https://ontarioprotocol.com/api/geo/answer-pack.md.
- [Citation receipts](https://ontarioprotocol.com/.well-known/citation-receipts.json): short evidence-backed claims with canonical URLs, JSON mirrors, verification steps, and SHA-256 digests for AI citation.
- [Claim index](https://ontarioprotocol.com/.well-known/claims.json): stable per-claim IDs, selectors, receipt URLs, and digests for claim-level agent retrieval. NDJSON mirror: https://ontarioprotocol.com/api/geo/claims.ndjson.
- [Answer evaluation corpus](https://ontarioprotocol.com/.well-known/answer-evals.json): search prompts, expected answers, accepted citation URLs, digest checks, and fail-if rules for answer-engine self-tests.
- [Agent invitation JSON](https://ontarioprotocol.com/.well-known/agent-invite.json): no-payment route map for agents to discover, verify, decide, rehearse, and cite Ontario safely.
- [Agent buyer guide JSON](https://ontarioprotocol.com/.well-known/agent-buyer.json): paid Ontario tools with price and network, 402 probing, x402 retry, and receipt evidence.
- [Agent payment policy JSON](https://ontarioprotocol.com/.well-known/agent-payment-policy.json): the allow, review, and deny rules the free can-pay API applies to payment-capable actions.
- [Answer graph JSON](https://ontarioprotocol.com/api/geo/answers): machine-readable index for LLMs and agents.

## Facilitator (Tier 3 take-rate proxy)

- GET [/facilitator/supported](https://ontarioprotocol.com/facilitator/supported): Returns supported (scheme, network) pairs.
- POST [/facilitator/verify](https://ontarioprotocol.com/facilitator/verify): Verify a signed payment off-chain (pass-through to Coinbase).
- POST [/facilitator/settle](https://ontarioprotocol.com/facilitator/settle): Submit on-chain. 1.5% take rate on third-party listings; everything logged to a public, append-only ledger.
- GET [/treasury](https://ontarioprotocol.com/treasury): Public take-rate dashboard. Audit the ledger live.

## Documentation

- [Docs](https://ontarioprotocol.com/docs): curl, Python, TypeScript examples for the full x402 flow.
- [x402 API finder and Base reads](https://ontarioprotocol.com/docs/x402-api-finder): how candidates are found, ranked and probed, the probe User-Agent, opt-out contact, limits, and when task text goes to TypeSafe.
- [Whitepaper](https://ontarioprotocol.com/whitepaper): Architecture (x402 server, agent discovery, EAS attestations on Base, take-rate proxy).
- [Legal](https://ontarioprotocol.com/legal): Terms, privacy, marketplace fee disclosure.

## Health & metrics (real, not marketing)

- GET [/api/health](https://ontarioprotocol.com/api/health): Live counters (402 responses served, settlements, paid calls, listings).
- GET [/api/treasury/stats](https://ontarioprotocol.com/api/treasury/stats): Treasury wallet balances + ledger totals.
- GET [/api/treasury/ledger](https://ontarioprotocol.com/api/treasury/ledger): Recent ledger rows + 30-day daily breakdown.
- GET [/facilitator/supported](https://ontarioprotocol.com/facilitator/supported): Live supported (scheme, network) pairs (avoid hardcoding).

## Live measurements

- Treasury dashboard: https://ontarioprotocol.com/treasury
- Take-rate defaults: 1.5% on third-party via proxy facilitator · 0% on first-party
- Supported networks/assets: call `/facilitator/supported` and treat as the source of truth
- Facilitator integration: Coinbase CDP Platform API by default (authenticated; confirm current limits in official docs)

## Resources for humans

- [Resources home](https://ontarioprotocol.com/resources/): Programmatic guides, checklists, blog ideas, templates for AI agent topics.
- [Comparisons](https://ontarioprotocol.com/compare/): Side-by-side tool comparisons.
- [Tools](https://ontarioprotocol.com/tools/): Cost calculators and estimators.

## Glossary & reference

- [Glossary](https://ontarioprotocol.com/glossary): Plain-English definitions for x402, EIP-3009, facilitators, USDC on Base, Coinbase Bazaar, MCP, A2A, AP2, EAS, agent reputation. Stable anchors `#term-<slug>` for deep-linking.
- [Glossary JSON](https://ontarioprotocol.com/glossary.json): Same content, machine-readable.
- [Changelog](https://ontarioprotocol.com/changelog): Append-only protocol + site changes.
- [Changelog JSON](https://ontarioprotocol.com/changelog.json), [JSON Feed](https://ontarioprotocol.com/feed.json), [RSS](https://ontarioprotocol.com/feed.xml).
- [Weekly intelligence](https://ontarioprotocol.com/intelligence): Public x402/MCP ecosystem report with JSON and Markdown mirrors.

## Framework integrations (copy-paste tool definitions)

- [Integrations index](https://ontarioprotocol.com/integrations/): OpenAI, Anthropic, MCP, LangChain, CrewAI, AutoGen.
- Per-framework JSON: `/integrations/{openai,anthropic,mcp,langchain,crewai,autogen}.json`.

## Free demo endpoint (no payment required)

- POST [/api/demo/agent-trust-scan/live](https://ontarioprotocol.com/api/demo/agent-trust-scan/live): Free, rate-limited live summary preview before paying for the full trust report.
- MCP `agent_trust_preview` (via [the public MCP endpoint](https://ontarioprotocol.com/mcp)): the same free live summary path for MCP hosts; use `ontario_agent-trust-scan` only when the preview is insufficient.
- POST [/api/demo/agent-trust-scan](https://ontarioprotocol.com/api/demo/agent-trust-scan): Rate-limited (10/hour/IP) sample of the paid endpoint, identical response shape. Validate parsers before paying.

## For AI systems

- [llms.txt](https://ontarioprotocol.com/llms.txt): This file.
- [llms-full.txt](https://ontarioprotocol.com/llms-full.txt): Full content dump including live metrics + glossary + changelog.
- [Agent card (agents.json)](https://ontarioprotocol.com/.well-known/agents.json): A2A-style descriptor.
- [Agent invitation JSON](https://ontarioprotocol.com/.well-known/agent-invite.json): public-safe agent entrypoints and recommended verification flow.
- [Agent buyer guide JSON](https://ontarioprotocol.com/.well-known/agent-buyer.json): public-safe paid-tool decision guide with pay/stop conditions and first paid calls.
- [Visibility manifest](https://ontarioprotocol.com/.well-known/visibility.json): public-safe SEO, SoMe, and GEO score contract.
- [Answer pack](https://ontarioprotocol.com/.well-known/answer-pack.json): compact answer-engine bundle with source URLs, citation receipts, and guardrails.
- [Citation receipts](https://ontarioprotocol.com/.well-known/citation-receipts.json): evidence-backed claim receipts for AI citation.
- [Claim index](https://ontarioprotocol.com/.well-known/claims.json): claim-level retrieval index with an NDJSON mirror at https://ontarioprotocol.com/api/geo/claims.ndjson.
- [Answer evaluation corpus](https://ontarioprotocol.com/.well-known/answer-evals.json): public-safe answer-engine self-test corpus with NDJSON mirror at https://ontarioprotocol.com/api/geo/eval-corpus.ndjson.
- [MCP server (mcp.json)](https://ontarioprotocol.com/.well-known/mcp.json): Live MCP tool descriptors with x402 price metadata.
- [MCP registry server card](https://ontarioprotocol.com/.well-known/mcp/server-card.json): Fallback MCP tool metadata for registry scanners that support static server cards.
- [AI plugin manifest](https://ontarioprotocol.com/.well-known/ai-plugin.json): OpenAPI-discoverable plugin descriptor.
- [Buyer OpenAPI](https://ontarioprotocol.com/.well-known/openapi.json): Compact free-preflight and seven-product x402 contract for agent and registry selection.
- [Full developer OpenAPI](https://ontarioprotocol.com/.well-known/openapi-full.json): Broad machine-readable schema for every public API surface.
- [Security contact](https://ontarioprotocol.com/.well-known/security.txt): RFC 9116.
- [Robots.txt](https://ontarioprotocol.com/robots.txt): Crawler policy (CCBot allowed; GPTBot/ClaudeBot/PerplexityBot allowed).

## Optional Jev Task Matching

- [Task-fit API and consent contract](https://ontarioprotocol.com/api/agent/task-fit): POST a public task; allow_typesafe=true explicitly shares that task with TypeSafe for Jev matching. MCP tool: ontario_task_fit. Returns a callable Ontario tool and its input schema or abstains. Free, quota-limited, deterministic fallback, never authorizes payment. Never submit private content or credentials.

## Contact Details

- General: hello@ontarioprotocol.com
- Security: security@ontarioprotocol.com

## Agent discovery and publication workflows

- [Publish an x402 API profile with a readiness report and badge](https://ontarioprotocol.com/guides/publish-x402-api-profile-readiness-badge): Free validation, optional 0.50 USDC publication, concrete deliverables and explicit limits.
- [MCP Registry, Smithery or Bazaar: build the agent purchase path](https://ontarioprotocol.com/guides/mcp-registry-bazaar-agent-purchase-path): Connect tool discovery to a free-first workflow without confusing catalog presence with paid customer attribution.
- [Can x402 payments be refunded?](https://ontarioprotocol.com/guides/can-x402-payments-be-refunded): Settled USDC transfers are final; what verify-then-settle means for sellers and buyers, and how Ontario's paid routes settle after a result exists.
- [How big is the x402 market?](https://ontarioprotocol.com/guides/how-big-is-the-x402-market): Bazaar index size, the share of listings with one or two payers, and where repeat demand sits, with dated figures.
- [Are cheaper x402 APIs worse?](https://ontarioprotocol.com/guides/are-cheaper-x402-apis-worse): A dearer search reseller with more calls than the original, and the checks that matter more than price.
- [Do Claude or ChatGPT pay for MCP tools?](https://ontarioprotocol.com/guides/do-claude-or-chatgpt-pay-for-mcp-tools): The MCP payment loop, which side holds the wallet, and who the buyers of a paid MCP tool are.
- [Which networks does x402 support?](https://ontarioprotocol.com/guides/which-networks-does-x402-support): CAIP-2 network identifiers, the networks Coinbase's facilitator settles, and how a 402 response states what an endpoint accepts.
- [How do I get my API discovered by AI agents?](https://ontarioprotocol.com/guides/how-to-get-your-api-discovered-by-ai-agents): Coinbase Bazaar indexing, x402scan and directories, and descriptions written for the search box.
- [How do I know an x402 endpoint is legit?](https://ontarioprotocol.com/guides/how-to-tell-if-an-x402-endpoint-is-legit): Three observable checks (live 402, live price against listing, repeat payers) and what Ontario's 0.005 USDC finder reports.

## Smithery client onboarding
- Verified Smithery client starter: https://ontarioprotocol.com/docs/smithery-agent-client.html — downloadable unsigned probe, scoped Connect authentication, and strict payment hook. No signer or purchase is configured.