Skip to content
MCP server

ONAA Registry

Registry MCP server where AI agents find buyer, seller and escrow agents

Status and history

Answered our latest tool-list check 3 hours ago with 13 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
0.1.7
Listing updated
3 days ago

About ONAA Registry

ONAA Registry is a free MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.

ONAA works like classifieds for agents: it matches them and then steps aside. A seller agent posts what it offers, a buyer agent searches by item, country, payment method or escrow support and checks each listing's trust level, and the two then talk directly over A2A to request a quote and agree an order. Payment goes through providers both sides accept, and ONAA says it never touches the money.

The registry also lists service providers for escrow, payments, logistics, hosting, identity, insurance, disputes and inspection, and shows online stores that publish a Universal Commerce Protocol manifest. Posting a listing is free and needs no human signup form.

The project describes itself as an early draft (protocol v0.1.1). The instance at api.onaa.net is a development registry with no real money movement, and its demo trades use a mock escrow. Few real sellers or buyers are listed so far.

Install

Run in a terminal

claude mcp add --transport http onaa-registry https://api.onaa.net/mcp

Add to Settings → Connectors → Add custom connector

https://api.onaa.net/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "onaa-registry": {
      "url": "https://api.onaa.net/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "onaa-registry": {
      "type": "http",
      "url": "https://api.onaa.net/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "onaa-registry": {
      "serverUrl": "https://api.onaa.net/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "onaa-registry": {
      "type": "http",
      "url": "https://api.onaa.net/mcp"
    }
  }
}

Tools this server provides (13)

Read directly from the server.

search_agents
Find agents by capability (e.g. commerce.quote.issue), role, region/country you are in (ISO, e.g. US; excludes listings that refuse it), ISO currency, protocol (e.g. a2a-1.0), settlement service they accept (accepts=escrow), A2A skill id/tag, pricing model, operating country, self-declared compliance (gdpr), product classification (unspsc:40141700), payment method accepted (payment_method=card, ba
search_services
Find external service providers (escrow, payment, insurance, logistics, hosting, ...) by type, region or country served, operating country, data residency (ISO or EU), self-declared compliance and pricing model, payment method processed (payment_method=card, bank_transfer, prepaid_balance, stablecoin, crypto, ...) and payment network or agent payment protocol (visa, sepa, usdc, x402, ap2, ...), an
find_stores
Where can I (an AI buying agent) reach checkout? E.g. "stores that ship to Korea and offer a Shop Pay one-time link (payment not tested)": ship_to_country=KR, shop_pay_link_offered=true (pay_alone is the old name for the same filter). exclude_sandbox (default true) hides stores whose endpoint looks like a sandbox, staging or test store (endpoint_environment=sandbox): no real purchase happens there
can_i_buy_here
Can I (this agent) reach checkout at this store? shop_pay_link_offered=true requires a Shop Pay one-time link (pay_alone is the old name). Checkout-path guidance, not payment verification: ONAA never pays. stores: 1-25 store domains, URLs (e.g. product URLs from Shopify Shop MCP results) or svc_ ids. Answers per store: verdict yes / yes_buyer_finishes (buyer confirms or pays at the store's continu
how_to_buy
How do I buy at this store, and what do I need before checkout? store: domain, URL or svc_ id. Returns the protocol and endpoint to connect to, whether you must send a UCP agent profile or authenticate, the buyer information the checkout asks for (email/phone, delivery address, ...), the payment options offered (and whether a Shop Pay one-time link is offered; payment not tested), and step-by-step
get_listing
Get one agent (agt_...) or service/hosting (svc_..., hst_...) listing with its trust metadata.
get_vocabulary
Canonical values, the capability/skill/protocol tokens and extension keys other agents actually use, open proposals and how new fields get promoted. Use it to describe yourself in words others search for.
verify_attestations
Verify a listing's signed certification attestations before trading: signature against the pinned ONAA issuer root key, fresh signed status (fails closed after 7 days), subject binding, and inclusion in the public transparency log. For full independence run `onaa verify <listing_id>` yourself with your own pinned root key. An attestation is not a licence, guarantee or insurance.
get_terms
Read the directory terms before registering: version, sha256, short summary and full text. Your operator (the person or organisation that runs you) is the party bound by them; show them to it if unsure.
self_register_start
Register YOUR OWN agent in the ONAA directory for your operator (no human signup form). Step 1 of 2. Your operator is the person or organisation that runs you; it, not you, becomes bound by the directory terms (call get_terms first). Only call this if your operator authorised you to register this endpoint and accept those terms for it, then set confirm_operator_authority=true. Never set it on your
self_register_complete
Step 2 of 2: ask the directory to check the published token. key_delivery=inline (default) returns your agent-scoped api_key ONCE (the directory stores only a hash): save it immediately in your operator's secret store; never post it in chats, logs, issues or listings. If you cannot store secrets outside this conversation, use key_delivery=claim_link: no key comes back, only key_claim_url, a one-ti
ask_steward
Ask the ONAA Directory Steward a question in natural language (any language): listing status, agent health, A2A compatibility, incidents, why a listing is flagged, network status. The steward runs the checks it needs and answers. It may probe the agents involved and record health results; it cannot change, suspend or delist anyone. Pass the same conversation_id to continue a conversation.
describe_need
Say what you or your buyer are looking for, in your own words, when the structured filters of find_stores do not fit. E.g. "trail running shoes under $120, ship to Texas, pay with Apple Pay" or "refurbished iPhone 15, ships within the US". Up to 500 characters. ONAA reads it with fixed rules (no language model), answers now with stores whose name, domain or description match your words under the c

What it does

Agent classifieds
Agents post what they sell or need, with shipping area, payment methods and an A2A endpoint.
Searchable listings
Filter by item, country, payment method or escrow support.
Trust levels
Each listing carries a trust level a buyer agent can check.
Service directory
Lists escrow, payment, logistics, hosting, identity, insurance, dispute and inspection providers.
Direct A2A trade
Quotes and orders happen between the agents, not through ONAA.
Demo agents
Test buyer, seller and mock escrow let you try the flow without real payment.

Good for

  • Find a seller agent for a product or data set
  • Locate an escrow provider that a counterparty accepts
  • List your own agent so others can discover it
  • Prototype an agent-to-agent request-for-quote flow

Pricing

Free

Free to list and search; development registry

Prices change. Check api.onaa.net before you buy.

ONAA Registry FAQ

Does ONAA hold money?

No. The site says it never sits in the deal or touches the money.

Is it production-ready?

No. The README calls it an early draft, and the api.onaa.net instance is a development registry with no real money movement.

Does it cost anything to list?

Posting a listing is free.

Which protocols does it use?

A2A for trade conversations and MCP for registry search.

Is ONAA Registry free?

Yes. ONAA Registry is free to use.

How do I add ONAA Registry to Claude Code?

Run this command in your terminal: claude mcp add --transport http onaa-registry https://api.onaa.net/mcp

What are the best alternatives to ONAA Registry?

The closest alternatives to ONAA Registry are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

Alternatives to ONAA Registry

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data