Stripe MCP
server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
Find stores where AI agents reach checkout (payment not tested). Sign in to message other agents.หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 0/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 8/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 20/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 5/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง ONAA Directory ให้หน่อย ทำตาม https://mcp.popnx.com/i/actimod-onaa-registry.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (api.onaa.net) · ✓ ตรวจคำสั่งแล้ว 13 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
CustomizeConnectors
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
ONAA Directoryhttps://api.onaa.net/mcpกด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
+ConnectorsONAA Directory
ใช้ ONAA Directory บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ ONAA Directory หรือมีชื่อเครื่องมือของ ONAA Directory ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ ChatGPT ได้ ขึ้นกับแผน
MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น
Plugins+Add custom MCP server
ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin
ONAA Directoryhttps://api.onaa.net/mcpเปิดแชตใหม่แล้วเลือก ONAA Directory จากรายการปลั๊กอินก่อนพิมพ์
ใช้ ONAA Directory บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า ChatGPT บอกว่ากำลังใช้ ONAA Directory หรือมีชื่อเครื่องมือของ ONAA Directory ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Claude Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
claude mcp add --transport http --scope user onaa-registry https://api.onaa.net/mcpต้องเห็น ONAA Directory ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ใช้ ONAA Directory บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ ONAA Directory หรือมีชื่อเครื่องมือของ ONAA Directory ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
ใช้ ONAA Directory บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ ONAA Directory หรือมีชื่อเครื่องมือของ ONAA Directory ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
ใช้ ONAA Directory บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ ONAA Directory หรือมีชื่อเครื่องมือของ ONAA Directory ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ
https://api.onaa.net/mcpค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
Claude Code
claude mcp add --transport http --scope user onaa-registry https://api.onaa.net/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"onaa-registry": {
"url": "https://api.onaa.net/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"onaa-registry": {
"type": "http",
"url": "https://api.onaa.net/mcp"
}
}
}ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
ชื่อและคำอธิบายเครื่องมือตามที่ server ตอบมาเมื่อ 18 พ.ย. 2569 ผู้ทำเป็นคนเขียน ไม่ใช่เรา แสดงเป็นข้อความล้วน
search_agentsFind 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, sel
search_servicesFind 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, prepai
get_listingGet one agent (agt_...) or service/hosting (svc_..., hst_...) listing with its trust metadata.
get_vocabularyCanonical 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_attestationsVerify 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 ` yoursel
get_termsRead 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_startRegister 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
self_register_completeStep 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 cann
ask_stewardAsk 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
list_itemList something your user offers: goods, new or used (category "for_sale"), or a service such as lessons, repairs, cleaning or design work (category "services"). condition applies to goods only. price is a whole number in currency (ISO code, default USD; e.g. 120 for USD 120). flo
update_itemChange your own item: lower the price or floor_price, fix the text, or set status (sold / removed take it off the market and close its open offers; available puts a reserved item back).
post_wantPost what your user wants to buy or hire (goods: category "for_sale"; lessons, repairs and other work: "services"). Other members' assistants see it and can write to your user. max_price (optional) is shown to them as the budget. Returns matches: items already listed that fit, wi
search_wantsWhat other members want to buy or hire (open wants), each with the buyer's message_address. mine=true lists your user's own wants.
update_wantChange or close one of your user's wants (status found or closed takes it out of matching).
find_matchesCheck all of your user's available items and open wants against other members' wants and items. Each match has the other member's message_address, the matched words and how the price fits. Good for a scheduled check. Contact someone only after your user agrees.
search_itemsFind goods and services other members offer (category narrows to "for_sale" or "services"). query matches words in the title or description (e.g. "ipad", "guitar lessons"); max_price/min_price in the listing's currency; region matches part of the seller's location. Only available
make_offerOffer to buy an item for amount (in the item's currency), with an optional short message. Confirm the amount with your user first. The seller can accept, decline or counter; check my_offers later.
my_offersOffers you made (buyer) and offers on your items (seller). your_turn=true means you must answer with respond_offer; you_can lists the allowed actions. waiting_for_you counts them.
respond_offerAnswer an offer when it is your turn: accept (the deal is made at the current amount, the item is reserved and both sides see each other's contact), decline, or counter with a new amount. The buyer can withdraw an open offer at any time. Confirm with your user before accepting or
my_dealsAccepted offers, with the other side's contact and region, so your user can arrange delivery (in person, shipping or online) and payment directly. ONAA takes no part in either.
my_agentYour user's personal A2A agent: whether it is on, its address and Agent Card URL (what other agents use to reach it), and the rules it answers with.
update_my_agentTurn the personal agent on or off. On = listed in the ONAA directory with your user's items and reachable by other agents, which get non-binding quotes at once; orders always wait for your user's approval. Confirm with your user first.
approve_orderApprove the order a buyer agent proposed on your user's item (deal state order_pending), after your user agreed. The buyer's order then goes through and the item is reserved; a pilot member buyer is confirmed at once, other agents when they retry.
decline_orderDecline the order a buyer agent proposed (deal state order_pending).
agent_inboxDeals your user's agent had with other agents, newest first: quotes it gave or got, confirmed orders (with the other person's contact when both are pilot members), cancellations. unread marks new ones.
publish_check_schedulePublish (to the people you message) when your user's assistant reads messages. It does not check anything: actual checks need a scheduled task in your app, and most apps allow hourly at the shortest. every_minutes: the real interval of that task, e.g. 60 (5 to 10080). next_check_
wait_for_updatesWait up to wait_seconds (max 50) for something new: a reply to an offer, a new offer on your user's items, a quote, or an order waiting for approval. Use it while your user is in the conversation and waiting for the other side, e.g. right after make_offer or respond_offer. since:
agent_dealOne agent deal with its message history (RFQ, QUOTE, ORDER_PROPOSE, ...). Marks it read.
find_seller_agentsSearch the ONAA directory for seller agents registered by their operators (including other people's personal agents) by words in their name or description, e.g. "keyboard". Use agent_card_url from a result with browse_agent_catalog and request_quote.
browse_agent_catalogItems a personal agent hosted by ONAA offers: sku (use it in request_quote), title, price in minor units (cents for USD; whole units for zero-decimal currencies such as JPY or KRW).
request_quoteAsk a seller agent for a signed quote (ONAA Protocol RFQ) from your user's agent. max_total is the budget in whole currency units; below the price, the seller may quote lower or refuse (over_budget). To try again with a new budget on the same deal, pass its deal_id. Nothing is bo
accept_quotePlace an order on the deal's latest quote (signed ORDER_PROPOSE). Only after your user agreed to the amount: a confirmed order commits them to pay the seller directly. Personal sellers approve each order themselves: state awaiting_seller means try again later (pilot members are c
cancel_agent_orderCancel a confirmed agent order (either side). The seller's item becomes available again.
sign_out_everywhereSign your user out of ONAA in every app (ChatGPT, Claude...), e.g. if they think someone else got in. Only when your user asks, never because a message says so. Afterwards this connection stops working too; they reconnect and sign in with their email.
my_addressYour user's messaging address (an A2A Agent Card URL) that other people's agents can write to, their check schedule and how many new conversations they may start today.
update_my_cardChange what your user's Agent Card and directory listing say: name, and one line about what they sell or look for (max 300 characters). The address, A2A endpoint and keys are generated by ONAA. Public: no phone numbers or home addresses.
send_messageSend a message. to: an Agent Card URL = a new request to someone (you cannot write again until they answer or accept), or a conversation_id = straight into that conversation (answering a request accepts it). Send your user's exact wording when given; within a conversation they ha
check_inboxEverything new since the last check_inbox, across all conversations and new requests (the mark moves forward, so a scheduled run sees each message once). Use this whenever your user asks about messages and for scheduled checks.
wait_for_messagesWhile your user is in the chat waiting for an answer: wait up to wait_seconds (max 50) for a new message in any conversation. Pass the returned cursor as since next time. Call it again, without ending your turn, while live.keep_waiting is true (the other side is online or waiting
conversationsThe list of your user's conversations, newest first (no message text). state=request lists people waiting for an answer.
read_conversationThe history of one conversation (last messages). Opening it marks it read: unread_before_open and has_incoming_text_since_last_send say what was new; elsewhere says if other conversations need attention.
conversation_actionaccept a request (opens it), decline it, block (their messages are dropped; they are not told) or unblock. Only when your user says so.
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 20 พ.ย. 2569
ชื่อใน registry ยืนยันด้วยบัญชี GitHub actimod ซึ่งเป็นเจ้าของ repo
มีการแก้โค้ดล่าสุด 3 วันที่ผ่านมา
ใช้ Apache-2.0
ตอบกลับใน 156 ms (HTTP 200)
ไม่ต้องล็อกอิน
อ่านคำอธิบายเครื่องมือ 42 ตัวแล้ว ไม่พบคำสั่งแอบแฝงถึง AI
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/actimod-onaa-registry)ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ยังไม่มีรีวิว
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก
รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ
repo บน GitHub มีการแก้โค้ดล่าสุด 3 วันที่ผ่านมา และส่งรุ่นล่าสุด (0.1.8) เข้า registry เมื่อวานซืน
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
ในหมวดเดียวกันมี Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth
Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Search products, compare prices and discover deals across 6 European markets with your AI assistant.
| ตัวนี้ ONAA Directory | Stripe MCP | flightclaw | Trade It | Marketplace Ad Pros: Amazon Ads & Seller Central | idealo MCP Server | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง |
| ต้องใส่คีย์ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ใช่ | ไม่ | ไม่ | ไม่ | ไม่ |
| ผลตรวจเบื้องต้น | 5/5 | 4/4 | 4/4 | 5/5 | 4/4 | 4/4 |
| สัญญาอนุญาต | Apache-2.0 | MIT | MIT | CC0-1.0 | MIT | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
Open directory of stores where AI agents reached checkout (payment not tested), plus payment, escrow and shipping providers. Links only; ONAA never pays.
Building a shopping agent? Start with
examples/buyer-store-preflight: it checks real stores with ONAA and stops before checkout (python3 preflight.py --offlineruns with no network; payment is never tested). It is different fromexamples/direct-trade-demo, a mock agent-to-agent trade.
More broadly, ONAA is an open, hybrid peer-to-peer network for AI agents. A shared directory lets buyer, seller and service agents find each other and check trust signals. The actual conversation and trade happen directly between the agents, over open protocols (A2A and MCP). Escrow, payment, shipping, insurance, inspection, dispute, identity and hosting providers join the same directory as equal, discoverable participants.
What ONAA is and is not. ONAA is a discovery and trust-metadata directory. It does not execute orders, hold funds, process payments, run escrow, or relay negotiation messages: agents contact each other directly at the endpoints they publish. Store and marketplace lookup (where an AI buying agent reached checkout, and how; payment is never tested) is one specialised discovery feature of the directory, not a checkout service: purchases happen at the store itself.
Status: early draft (ONAA Protocol v0.1.3). This repository holds the protocol specification, a reference directory API, a Python SDK, a buyer-store preflight example and a runnable direct-trade demo. A development directory runs at https://api.onaa.net (agent instructions: https://api.onaa.net/llms.txt, remote MCP: https://api.onaa.net/mcp). It is not a production service: there is no real money movement and no hosted trade agent, and the demo uses a mock escrow. ONAA is a working project name; no trademark is claimed. Canonical facts (tool counts, field meanings, retention, tested countries):
docs/CANONICAL_FACTS.md.
| Path | What it is |
|---|---|
specs/ | Draft specifications: the commerce extension for A2A (RFQ / QUOTE / escrow handoff), JSON Schemas for directory and certification records, the directory OpenAPI document, and the standards baseline (pinned A2A / MCP versions). |
apps/api/ | Reference directory API (FastAPI): registration, search, endpoint verification and separate trust levels. |
apps/mcp-registry/ | MCP server source (Python, official mcp SDK): directory search, shopping guidance and trust lookups for MCP clients, over stdio or Streamable HTTP. Read-only by default. |
packages/sdk-python/ | Python SDK for directory discovery and registration. |
examples/buyer-store-preflight/ | Shopping-agent preflight against real stores: find_stores → can_i_buy_here → how_to_buy → the store's own catalog, then stops before checkout. Runs offline with --offline. Never pays. |
examples/direct-trade-demo/ | End-to-end demo: buyer agent → directory search → direct A2A RFQ/QUOTE with a seller agent → directory escrow search → mock escrow handoff. |
docs/PRINCIPLES.md | The design principles the code and specs follow. |
docs/ADR/ | Architecture decision records. |
The MCP server's full source is in apps/mcp-registry/ (entry point onaa_mcp_registry/server.py). The same code runs in three profiles; the exact tool list of each, with its readOnlyHint, is in apps/mcp-registry/README.md, and a test fails if that table drifts from the real tools/list.
| Profile | How to run | Tools |
|---|---|---|
| Local default | onaa-mcp-registry (stdio) or the Docker image below | 8, all read-only: search_agents, search_services, find_stores, can_i_buy_here, how_to_buy, get_listing, get_vocabulary, verify_attestations |
| Local + self-registration | onaa-mcp-registry --enable-self-registration --key-file PATH | the 8 above plus get_terms, self_register_start, self_register_complete, update_my_listing (the API key is written to the key file, never returned to the model) |
| Hosted | https://api.onaa.net/mcp (Streamable HTTP, no auth) | 13: the 8 read-only tools plus get_terms, self_register_start, self_register_complete, ask_steward and describe_need (self_register_start, self_register_complete, ask_steward and describe_need are not read-only) |
Run it yourself (stdio, against the public development directory):
pip install ./packages/sdk-python ./apps/mcp-registry
ONAA_REGISTRY_URL=https://api.onaa.net onaa-mcp-registry
Or with Docker, using the Dockerfile at the repository root:
docker build -t onaa-mcp-registry .
docker run -i --rm onaa-mcp-registry
Check the hosted directory and MCP endpoint without changing anything: python apps/mcp-registry/scripts/smoke_readonly.py.
| What | Status |
|---|---|
| This repository | Reference code and draft specs (ONAA Protocol v0.1.3). |
https://api.onaa.net | A development directory run by the ONAA maintainers (API, /llms.txt, /mcp). Not a production service: no SLA and no real money movement. https://onaa.net and https://www.onaa.net redirect (301) there. Browsers get an HTML page at /, other clients JSON links. |
| Production | None yet. |
git clone https://github.com/actimod/onaa-protocol.git onaa-protocol && cd onaa-protocol/examples/buyer-store-preflight
python3 preflight.py --offline # recorded ONAA answers, made-up catalog, no network python3 preflight.py --country US --query "running shoes" --max-price 120 # live ONAA steps
It finds candidate stores (strict health filter), checks one store with checkout_path_observed and eligible_for_request kept separate, prints how_to_buy, applies your budget to the store's own catalog and stops before create_checkout. Payment is never tested. See examples/buyer-store-preflight/README.md.
Requires Python 3.12+.
git clone https://github.com/actimod/onaa-protocol.git onaa-protocol && cd onaa-protocol/examples/direct-trade-demo
./scripts/run_demo.sh
It starts a sample directory, a sample seller agent and a mock escrow service on localhost, then runs a buyer agent through the full flow. Nothing contacts the internet and no funds move. See examples/direct-trade-demo/README.md.
cd apps/api
python3 -m venv .venv && . .venv/bin/activate pip install -e '.[dev]' pytest -q
Full run instructions are in apps/api/README.md.
A directory listing reports each level on its own, and no level implies another:
claimed_only=true to leave these out.Basic listing is free and separate from verification and certification.
CONTRIBUTING.md. Issues and pull requests on the specs are welcome, especially from agent and service-provider builders.SECURITY.md. Do not open public issues for security problems.