Model Context Protocol (MCP) Server: com.ontarioprotocol/ontario-protocol

The com.ontarioprotocol/ontario-protocol server supports an audit and publishing workflow for x402 API discovery and calling. It identifies why an agent cannot discover or call a provider’s x402 API, and then publishes signed provider profiles with evidence intended for buyer evaluation. It also exposes tooling configuration via an MCP endpoint.

🛠️ Key Features

Audit “buyer discovery” for x402 API access
Publish signed provider profiles
Provide buyer-evaluation evidence
Expose current tools via /.well-known/mcp.json

🚀 Use Cases

Troubleshoot agent discovery and calling failures for x402 APIs
Prepare providers for a launch and evidence publication
Inspect what tools the MCP server currently exposes

⚡ Developer Benefits

Links to a free buyer-discovery audit
Provider quickstart documentation for x402 service listing
Tool inspection for integration debugging

⚠️ Limitations

Described support is specific to x402 buyer discovery and provider profile publishing

Ontario Protocol

Find out why an agent cannot discover or call your x402 API, then publish the evidence a buyer needs to evaluate it.

Run the free buyer-discovery audit | Provider quickstart | Inspect current tools

Install in your agent

Launch multiple x402 endpoints: validate a public services manifest, select up to ten endpoints, and inspect the 0.50 USDC per-endpoint publication quote. The plan does not authorize payment. Use your existing wallet or MCP client and retain each successful receipt.

Catalog Watch is a free customer-run Python kit for scheduled public-profile observations, before/after webhook alerts, and gated refresh jobs after included maintenance. It is not a hosted subscription and never signs or spends.

For API providers preparing a launch:

bash

npx skills add TheTechDevPro/ontario-protocol --skill ontario-provider-launch

For agent builders checking an endpoint before spending:

bash

npx skills add TheTechDevPro/ontario-protocol --skill ontario-x402-preflight

Or install both from the Ontario x402 Toolkit pack:

bash

npx skills add https://skills.sh/p/1i9kLVcmDbP4Zbhz

The pack is a public, unlisted snapshot of these two skills, published September 6, 2026. It is not a leaderboard placement, endorsement, or security certification.

Skills contain inspectable instructions. Installation does not create a wallet, authorize a purchase, or change spending limits.

Connect

The remote uses Streamable HTTP. No Ontario API key is required for free tools. For clients using mcpServers, including Claude Code's .mcp.json:

json

{
  "mcpServers": {
    "ontario-protocol": {
      "type": "http",
      "url": "https://ontarioprotocol.com/mcp"
    }
  }
}

For VS Code, see examples/vscode-mcp.json. The official Registry record and Smithery listing point to the same remote. A connected MCP host still needs a compatible local x402 wallet and explicit spend policy to use paid tools.

Try a useful task

Check whether my public x402 API appears in Bazaar for "return a sourced company filing". Report observable blockers. Do not spend or publish anything.

Or call the free HTTP diagnostic directly:

bash

curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/tools/coinbase-bazaar-readiness \
  -H 'Content-Type: application/json' \
  -d '{"target_url":"https://example.com/api/paid","buyer_query":"return a sourced company filing"}'

Replace the example URL with your own public API. The result separates indexing preflight from sampled buyer-query retrieval, with evidence and timestamps. It does not initiate a settlement or submit your service to another registry.

Free checks and the paid deliverable

Job	Tool or endpoint	Cost
Diagnose retrieval across five buyer queries	`bazaar_buyer_intent_gap`	Free
Inspect x402 endpoint readiness	`x402_readiness_verify`	Free
Decide whether a proposed spend passes policy	`agent_can_pay`	Free
Find task-relevant paid API candidates	`find_x402_tool`	Free
Validate provider publication inputs	`ontario_validate-service`	Free
Publish a signed provider launch profile	`ontario_list-service`	0.50 USDC on Base

The optional publication includes a canonical HTML/JSON profile, readiness evidence, a point-in-time Bazaar retrieval snapshot, a badge, and 30 days of included automatic freshness maintenance. Providers with an MCP server can add MCP Registry and read-only remote-contract evidence to the same purchase.

Publication does not buy Coinbase or MCP Registry placement, ranking, traffic, customers, a better grade, or a safety guarantee. Use the free diagnostic first. The paid route returns HTTP 402 before payment. A challenge is not a receipt; sign locally only under the owner's policy.

Publish from your agent without a browser

Call ontario_validate-service with your public service name, description, endpoint and its per-call price. Fix the returned field errors for free.
Run the free readiness and can-pay checks. Choose publication only when you need the public profile and approve Ontario's separate 0.50 USDC fee.
Call ontario_list-service without payment and inspect the live requirements.
A compatible wallet client signs locally and retries with the PaymentPayload in params._meta["x402/payment"]. Store the profile and result._meta["x402/payment-response"] receipt after success.

Ontario supports the standard x402 MCP payment format. The unpaid MCP result uses HTTP 200 with isError: true and PaymentRequired in both structured content and JSON text. It is not a failed server or a sale. The older _x402_payment argument still works. HTTP-wrapper clients can send X-Ontario-X402-Transport: http for HTTP 402 signaling and retry with PAYMENT-SIGNATURE. No installation or free check authorizes a payment.

Source labels, when available, are coarse client-reported hints. They do not identify a person or prove a marketplace referred a paying customer.

Typed responses and compatibility

All nine tools in the default catalog declare output schemas, documented input parameters, and side-effect annotations. Clients can validate successful structured results instead of inferring their shape from prose. The free launch kit returns drafts only; optional live verification can create a public report; paid publication and evidence refresh remain state-changing operations.

The September 5, 2026 Smithery refresh reports 98/100, with complete schema, description, parameter, annotation, metadata, and configuration coverage. Its remaining deduction is for flat tool names. Existing names and payment contracts are retained for compatibility. This is a listing-quality measure, not a security audit, certification, or evidence of customer demand.

Public distribution check

On September 5, 2026, an explicitly approved, owner-funded 0.50 USDC activation settled and the exact /api/x402/list-service resource appeared in CDP Bazaar and Agentic Market. Smithery's original listing was refreshed to the current nine tools. The operator disclosure and transaction receipt make the test independently inspectable. This was distribution setup, not a new customer, independent revenue, a security certification, or guaranteed traffic.

Additional catalog entries

Ontario on x402scan exposes 21 resources in the public catalog, checked September 6, 2026.
Ontario's Agent402 seller record exposes 20 tools, including eight paid tools. On September 6, 2026, it reported routable: true for crawl readiness but routerDispatchEligible: false with routerDispatchReason: settlement_required. Its paid router's settlement-history threshold is a separate gate; a successful registration does not satisfy it.

Catalog presence is not an endorsement, a paid call, or evidence of customer traffic. Check each hub's current eligibility before relying on it. The direct MCP connection and GitHub skill installation above do not depend on these hubs' routing eligibility. Free checks never authorize a purchase; paid calls still require a compatible wallet and the owner's spending policy.

Machine-readable entry points

Private review handoffs for teams

Ontario Private Agent Handoff is a free self-service kit for teams operating lead-to-reviewer workflows. The local Python kit signs and encrypts selected brief fields, checks a pinned recipient, expiry, replay and local revocation, and returns a payload-free signed acceptance receipt. It makes no network calls and does not execute tools or pay. Keep your own authenticated transport.

The public page includes a rule-based setup assistant, a complete guide, expected results, troubleshooting and a synthetic policy simulator. The assistant adapts to the customer's environment without uploading choices, keys or task data. Unsupported deployments are not marked ready. Run demo.py locally for real encryption, receipt verification and a replay-denial check. No account, wallet, application, invoice or setup call is needed. Guided implementation is no longer offered. No hosted messaging, independent security audit or certification is claimed.

The local kit is not an MCP tool in the public Ontario server: confidential briefs and private keys must never be sent to that server. Read the kit's threat model before using real data. Existing paid provider publication remains unchanged.

Trust boundary

Ontario provides readiness and trust signals based on observable endpoint behavior, manifest metadata, payment challenge behavior, report history, and public evidence. It does not guarantee endpoint safety, service quality, financial outcome, or future behavior.

This repository contains public integration artifacts and skills, not the production backend or its credentials. Contact: hello@ontarioprotocol.com. Security reports: security@ontarioprotocol.com.

free_preflight_complete	boolean	optional	True only after the recommended free check has completed for this task.
max_usdc	any	optional	Optional owner-authorized per-call USDC ceiling from 0 to 1000. Send a JSON number or decimal string such as 0.5, '0.50', '$0.50' or '0.50 USDC'. Omit when no budget is authorized; a budget is only a ceiling and does not grant spending authority. The router never increases it.
network	string	optional	Wallet policy network; Ontario paid tools currently require Base mainnet.
task	string	required	Public task description only; never include credentials or private customer data.
wallet_enabled	boolean	optional	True only when the caller can locally sign an x402 PaymentPayload.

allow_typesafe	boolean	optional	With allow_typesafe=true, your public task and Ontario's public tool descriptions are sent to TypeSafe for Jev inference. Do not supply secrets, personal data, private URLs, or customer content. Ontario does not persist task text here. TypeSafe processing is subject to its policies; zero retention is not promised. Without consent, only Ontario's deterministic router is used.
free_preflight_complete	boolean	optional	True only after the recommended free check has completed for this task.
max_usdc	string	optional	Explicit owner-approved USDC ceiling; never inferred.
network	string	optional	Network permitted by the caller's wallet policy; Ontario paid tools require Base mainnet (eip155:8453).
task	string	required	A public capability request, never private task content.
wallet_enabled	boolean	optional	True only when the caller can locally sign an x402 payment; this flag does not authorize spending.

agent_policy	string	optional	Readiness policy to apply. Use strict unless the operator explicitly permits a different policy.
endpoint	string	required	Public x402 endpoint to evaluate before payment; never include credentials or private query parameters.
max_usdc	string	optional	Caller-approved per-call spending ceiling in decimal USDC, for example 0.01. This check never spends funds.
require_audit_receipt	boolean	optional	Explicitly request the optional paid receipt handoff after an allow decision. This does not submit payment.

buyer_queries	array	optional	Optional explicit portfolio of up to five public buyer phrases. When omitted, Ontario generates four deterministic variants from buyer_query.
buyer_query	string	required	Public task phrase a funded agent could use in CDP Bazaar search; never include credentials or private customer text.
target_url	string	required	Public x402 paid endpoint whose buyer visibility should be measured.

active_only	boolean	optional	When true, require recent source-reported activity or fresh strict-ready Ontario profile evidence.
limit	integer	optional	Maximum number of task-matched candidates to return, from 1 to 10.
max_usdc	string	optional	Optional hard USDC price ceiling for returned candidates.
network	string	optional	Optional network filter, for example eip155:8453 or base.
query	string	required	Public task text only; never include credentials or private customer data.

asset	string	optional	USDC token contract on the declared payment network; omit to use the Base USDC default.
description	string	required	Public description of the task the service performs and the result it returns.
endpoint	string	required	Provider-owned public HTTPS x402 endpoint to prepare for listing.
method	string	optional	HTTP method accepted by the provider endpoint, for example POST.
name	string	required	Public name of the provider's service.
network	string	optional	Payment network accepted by the provider, for example base or eip155:8453.
owner_contact	string	optional	Optional public business contact for generated drafts. Omit private addresses; never supply credentials.
owner_url	string	optional	Public website identifying the service provider.
price_usdc	string	required	The provider's per-call price in decimal USDC, not Ontario's publication fee. Kit generation is free.
tags	string	optional	Comma-separated public capability tags, for example x402,paid-api,agent-tool.

_x402_payment	string	optional	base64 x402 PaymentPayload (USDC on Base); obtain the requirements by calling this tool without it first.
asset	string	optional	Payment token contract accepted by the provider on the declared network.
buyer_query	string	optional	Public task phrase used for the point-in-time Bazaar retrieval audit. It may appear in the public profile.
category	string	optional	Public capability category for the service, not a claim of certification.
description	string	required	Public buyer task, expected result, and important service limitations; do not include confidential text.
endpoint	string	required	Provider-owned public HTTPS x402 endpoint to list. Never include secrets or sensitive query parameters.
mcp_remote_url	string	optional	Optional public MCP remote for read-only initialize and tools/list checks.
mcp_server_json_url	string	optional	Optional public MCP Registry record or exact-search JSON URL.
mcp_server_name	string	optional	Optional exact MCP Registry server name.
method	string	optional	HTTP method used to call the provider's endpoint.
name	string	required	Public service name displayed on the provider profile.
network	string	optional	Provider payment network, for example base or eip155:8453. Ontario publication itself uses Base USDC.
owner_contact	string	optional	Optional provider contact retained for operations and omitted from public profiles. Omit when unnecessary; never send wallet credentials.
owner_url	string	optional	Public website identifying the provider; publication does not verify legal identity.
price_atomic	integer	optional	Optional provider price in six-decimal USDC units: 10000 equals 0.01 USDC. Must match price_usdc when supplied.
price_usdc	string	required	Provider endpoint price in decimal USDC, at most six decimal places. This is separate from Ontario's 2.00 USDC publication fee.
source	string	optional	Privacy-safe aggregate acquisition bucket; never a URL or query.
tags	array	optional	Public capability tags for discovery, up to ten relevant labels.

agent_id	string	optional	Optional stable public agent identifier to associate with the preview.
target_url	string	required	Public HTTPS agent card or endpoint to preview without payment; never include private hosts or credentials.

agent_card_url	string	required	Public HTTPS agent card URL for the listing.
description	string	optional	Public description of the agent's capabilities.
name	string	required	Public name of the agent being listed.
owner_contact	string	optional	Optional owner contact supplied for the listing; do not include secrets.
owner_url	string	optional	Optional public owner website.
tags	array	optional	Capability tags describing the agent.

listing_id	string	required	Existing paid provider profile id.
paid_refresh_tx	string	optional	One-use retry reference only when a settled refresh could not complete.

Model Context Protocol (MCP) Server: com.ontarioprotocol/ontario-protocol

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

ontario_purchase_router

ontario_task_fit

agent_can_pay

x402_readiness_verify

bazaar_buyer_intent_gap

find_x402_tool

x402_launch_kit

ontario_validate-service

ontario_list-service

ontario_refresh-listing

agent_trust_preview

ontario_agent-trust-scan

github_x402_repo_scan

ontario_x402-implementation-audit

ontario_reputation

ontario_agent-pay-query-v2

ontario_x402-demand-authenticity

ontario_list-agent

ontario_validate-agent

ontario_validate-refresh

x402_verification_reports

Ontario Protocol

Install in your agent

Connect

Try a useful task

Free checks and the paid deliverable

Publish from your agent without a browser

Typed responses and compatibility

Public distribution check

Additional catalog entries

Machine-readable entry points

Private review handoffs for teams

Trust boundary

Install

Remote endpoint

Related servers