Skip to content
onelayer.
All tools

Tool detail

list-service

Publishes a provider's x402 endpoint to Ontario Protocol's directory with a readiness report and 30 days of listing maintenance.

Categories: Tool discovery

Use when

  • list my x402 API for agent discovery
  • publish a readiness report for my paid endpoint

Not for

  • not a guarantee of placement, ranking, buyers, or safety
  • not for discovering other providers' tools (this only publishes your own)

Inputs

POST JSON body: { name, description, endpoint (uri), price_usdc } (required); optional: method, category, tags, network, buyer_query, mcp_* fields, owner contact/url

Admitted input schema

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096
    },
    "buyer_query": {
      "type": "string",
      "minLength": 3,
      "maxLength": 160,
      "description": "One public buyer task used to generate the five-query Bazaar retrieval audit. Never include credentials or private customer text."
    },
    "category": {
      "type": "string",
      "minLength": 0,
      "maxLength": 80
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Factual buyer-facing description of the paid outcome."
    },
    "endpoint": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "uri",
      "description": "Provider-owned public HTTPS x402 endpoint."
    },
    "mcp_remote_url": {
      "type": "string",
      "minLength": 0,
      "maxLength": 500,
      "format": "uri",
      "description": "Optional public MCP remote. Ontario runs read-only initialize and tools/list; it does not invoke tools or send credentials or payment headers."
    },
    "mcp_server_json_url": {
      "type": "string",
      "minLength": 0,
      "maxLength": 500,
      "format": "uri",
      "description": "Optional public MCP Registry record or exact-search JSON URL. Queries are stripped from public evidence."
    },
    "mcp_server_name": {
      "type": "string",
      "minLength": 0,
      "maxLength": 180,
      "description": "Optional exact MCP Registry server name used to select one record."
    },
    "method": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
      ],
      "default": "POST"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Public service name shown on the provider profile."
    },
    "network": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Public endpoint network, for example base or eip155:8453."
    },
    "owner_contact": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional private operator contact; never published."
    },
    "owner_url": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "uri"
    },
    "price_atomic": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "price_usdc": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^[0-9]+(?:\\.[0-9]{1,6})?$",
      "description": "Public endpoint price in USDC."
    },
    "source": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "coinbase_bazaar",
        "direct_or_unknown",
        "github",
        "google_search",
        "internal_navigation",
        "mcp_registry",
        "other_search"
      ],
      "description": "Optional privacy-safe acquisition bucket used only for aggregate funnel attribution; URLs and search queries are not retained."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 48
      },
      "minItems": 0,
      "maxItems": 12
    }
  },
  "required": [
    "name",
    "description",
    "endpoint",
    "price_usdc"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://ontarioprotocol.com/api/x402/list-service

Payment

Protocol
x402
Listed price
0.5 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://ontarioprotocol.com/api/x402/list-service
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z