Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Buy real goods with Nano (XNO) through escrow. Search, purchase, track orders, get signed receipts.
Pick the AI app you use, then copy the settings.
Passed 3/3 checks · What you ask goes through the maker’s server (api.nagora.shop)
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 2 min
No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
CustomizeConnectors
Copy each value into the field with the same name in Claude, then click Continue
Nagorahttps://api.nagora.shop/mcpLeave Authentication as Claude detected it, then click Add
+ConnectorsNagora
Use Nagora and tell me what you can do for me, then show me one thing✓ If Claude says it is using Nagora or shows a Nagora tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with ChatGPT on business plans only
ChatGPT Business, Enterprise or Edu on the web, added by a workspace admin or owner · On Free, Plus or Pro: your ChatGPT plan cannot connect MCP yet
Plugins+Add custom MCP server
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
Nagorahttps://api.nagora.shop/mcpStart a new chat and pick Nagora from your plugins before typing
Use Nagora and tell me what you can do for me, then show me one thing✓ If ChatGPT says it is using Nagora or shows a Nagora tool in the answer, you are connected
Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Claude Code · about 2 min
No key, nothing to install
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --transport http --scope user nagora https://api.nagora.shop/mcpYou should see Nagora listed as connected
Use Nagora and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Nagora or shows a Nagora tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 2 min
No key, nothing to install
Use Nagora and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Nagora or shows a Nagora tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 2 min
No key, nothing to install
Use Nagora and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Nagora or shows a Nagora tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://api.nagora.shop/mcpJSON settings are under “For developers” below
Claude Code
claude mcp add --transport http --scope user nagora https://api.nagora.shop/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"nagora": {
"url": "https://api.nagora.shop/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"nagora": {
"type": "http",
"url": "https://api.nagora.shop/mcp"
}
}
}Claude Code
claude mcp add --scope user nagora -- npx -y @nagora/mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"nagora": {
"command": "npx",
"args": [
"-y",
"@nagora/mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"nagora": {
"command": "npx",
"args": [
"-y",
"@nagora/mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"nagora": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nagora/mcp"
]
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
npm: @nagora/mcpBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Tool names and descriptions exactly as the server reported them on Nov 9, 2026. The maker wrote them, not us; we show them as plain text.
search_listingsFull-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.
register_agentCreates 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 se
confirm_deliveryConfirms 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
get_orderPolls 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
whoamiVerifies the configured credential and returns the agent's identity, spending caps, callback URL, and webhook secret. Call this first to confirm the credential works.
get_receiptReturns 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.
create_purchasePlaces 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 mo
get_listingFetch 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.
cancel_orderCancels 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.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 12, 2026
The registry name was verified against the domain nagora.shop (the registry checks domain ownership)
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
No sign-in needed
Read 9 tool descriptions and found no hidden instructions to the AI
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
Either way works: install it on your computer or connect to the cloud version.
The GitHub repo last changed –, and the latest version (1.0.1) reached the registry 2 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT Business and above.
In the same category: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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.
| Tool | Auth | What it does |
|---|---|---|
search_listings | none | Full-text search over active listings |
get_listing | none | Full listing detail: variants, delivery options, Nano pricing |
register_agent | none | Create an agent + API key in one call, no account needed; key is stored locally |
whoami | API key | Verify the key; see spending caps and webhook secret |
create_purchase | API key | Place an order; returns the escrow deposit address and amount |
get_order | API key | Poll order and escrow status, tracking, receipt ID |
confirm_delivery | API key | Confirm arrival and release escrow to the seller |
cancel_order | API key | Cancel an order that has not been funded yet |
get_receipt | API key | Fetch the KMS-signed receipt with the on-chain payout block |
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, so
register_agent
returns it once and you pass it as the
apiKeytool argument or pin it with
--header "Authorization: Bearer nag_agt_...". This local package keeps the key
in
~/.nagora/credentials.jsonfor you instead.
claude mcp add nagora -- npx -y @nagora/mcp
In claude_desktop_config.json:
{
"mcpServers": { "nagora": { "command": "npx", "args": ["-y", "@nagora/mcp"] } } }
cd nagora-mcp
npm install npm run build claude mcp add nagora -- node /path/to/nagora-mcp/dist/index.js
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.
| Variable | Default | Notes |
|---|---|---|
NAGORA_API_KEY | unset | Optional. Overrides the stored credential from register_agent |
NAGORA_API_URL | https://api.nagora.shop | Point at http://localhost:5004 for local dev |
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= . The webhookSecret comes from whoami.
Events: order.funded, order.shipped, and friends fire as the order progresses.