shop.nagoraPublished by nagora.shopOfficial publisherv1.0.1Updated Oct 24, 2026
Buy real goods with Nano (XNO) through escrow. Search, purchase, track orders, get signed receipts.
Nagora lets an AI assistant search a Nano-settled peer-to-peer marketplace, place escrow-protected purchases, track orders and fetch signed receipts.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/shop.nagora%2Fnagora/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"nagora": {
"type": "http",
"url": "https://api.nagora.shop/mcp"
}
}
}The official MCP server for nagora.shop, the P2P marketplace where everything settles in Nano (XNO).
It gives any MCP client (Claude Desktop, Claude Code, or your own agent runtime) tools to search listings, place escrow-protected purchases, track orders, and pull signed receipts. Your AI assistant can shop for you, and escrow protects you while it does: funds are held in a per-order Nano account and only released to the seller after delivery is confirmed.
Zero-install alternative: Nagora also hosts these same tools as a remote MCP server.
claude mcp add --transport http nagora https://api.nagora.shop/mcpand you are done. The trade-off: the hosted server cannot store your key locally, soregister_agentreturns it once and you pass it as theapiKeytool argument or pin it with--header "Authorization: Bearer nag_agt_...". This local package keeps the key in~/.nagora/credentials.jsonfor you instead.
In claude_desktop_config.json:
That's the whole setup. No Nagora account, no key to copy. The first time your assistant needs to buy something, it calls register_agent with a name and a refund Nano address; the API key comes back once and is saved to ~/.nagora/credentials.json (mode 600). Every other tool picks it up automatically from then on.
Self-registered keys get conservative default spending caps (currently 25 XNO per transaction, 100 XNO per day), enforced server-side. Want higher caps, multiple keys, or a dashboard? Create an account at nagora.shop and manage agents under Settings → Agents; keys minted there work the same way via NAGORA_API_KEY.
search_listings / get_listing: find the item, note the Nano total.create_purchase: places the order. The response contains a depositAddress (a per-order escrow account on the Nano network) and amountNano.amountNano to depositAddress from the agent's own Nano wallet. This server deliberately holds no keys and moves no funds; pair it with a wallet tool such as xno-mcp, or fund it manually. Nano transfers are feeless and settle in under a second.AwaitingShipment automatically when funds land. The seller ships and adds tracking.get_order (or webhooks, see below) to watch for Shipped.confirm_delivery once the goods arrive: escrow releases the funds to the seller on-chain.get_receipt: a signed, independently verifiable proof of the whole transaction, including the payout block hash.If the seller never ships, the escrow auto-cancel timer refunds the buyer. If something is wrong with the order, open a dispute from the website; a human reviews it.
Instead of polling get_order, register a callbackUrl on your agent (Settings → Agents). Nagora signs every webhook with HMAC-SHA256: compute HMAC-SHA256("{X-Nagora-Timestamp}.{raw_body}", webhookSecret) and compare it against X-Nagora-Signature: sha256=<hex>. The webhookSecret comes from whoami.
Events: order.funded, order.shipped, and friends fire as the order progresses.
Source: README.md at commit 6b5b1ce
Full-text search over active listings on nagora.shop. No API key required. Returns an items array and total count. Use get_listing for full detail before purchasing.
qcountsortBymaxPriceminPricecategoryIdstartIndexCreates a Nagora agent and mints its API key in one call. No Nagora account or signup required. IMPORTANT: this is a remote server with no local storage, so the key is returned ONCE in the result. Store it securely and pass it as the apiKey argument on subsequent calls in this session; for long-lived setups reconnect with an 'Authorization: Bearer <key>' header instead. Skip this tool if a credential is already configured; check with whoami.
namerequiredcallbackUrlhomepageUrlnanoAddressrequiredcontactEmailConfirms the goods or digital content arrived and releases the escrowed funds to the seller. Requires the order's escrowStatus to be Shipped. Call promptly once delivery is verified: the seller is waiting on this to get paid. If never called, an auto-finalise timer releases funds after the configured window.
apiKeyorderIdrequiredPolls an order placed by this agent. Returns orderStatus, escrowStatus, funding timestamps, tracking info, and the receipt ID once available. Poll after funding the deposit address, and after the seller ships, before calling confirm_delivery. For digital listings, digitalContent holds what was bought once the order is paid.
apiKeyorderIdrequiredVerifies the configured credential and returns the agent's identity, spending caps, callback URL, and webhook secret. Call this first to confirm the credential works.
apiKeyReturns the cryptographically signed receipt for a completed order, including the seller's Nano address, the on-chain payout block hash, and Nagora's KMS signature. Available only after escrow is Released; returns an error while the order is still in progress.
apiKeyorderIdrequiredPlaces an order against a listing. Returns a depositAddress (per-order escrow Nano account) and amountNano. IMPORTANT: the order is not funded by this call. Send exactly amountNano to depositAddress from the agent's Nano wallet to fund escrow. Once funds are detected the order moves to AwaitingShipment automatically. Physical listings require a shippingAddress.
apiKeyquantitylistingIdrequiredvariantIdquotedTotalNanoshippingAddressdeliveryOptionIdFetch a single listing by ID. No API key required. Returns full detail including variants, delivery options, and pricing. Use the returned Nano total as quotedTotalNano when purchasing to guard against exchange-rate drift.
listingIdrequiredCancels an order whose escrow is still Initiated (no on-chain funds sent yet). Restores listing stock. Cannot cancel once escrow is Funded; use the dispute or refund flow on the website instead.
apiKeyorderIdrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
claude mcp add nagora -- npx -y @nagora/mcp{ "mcpServers": { "nagora": { "command": "npx", "args": ["-y", "@nagora/mcp"] } }}cd nagora-mcpnpm installnpm run buildclaude mcp add nagora -- node /path/to/nagora-mcp/dist/index.js