Buy real goods with Nano (XNO) through escrow. Search, purchase, track orders, get signed receipts.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancels 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.
Order ID to cancel
Agent API key (nag_agt_...). Omit when connected with an Authorization header
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Cancels 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.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | null | Agent API key (nag_agt_...). Omit when connected with an Authorization header |
| orderId* | string | Order ID to cancel |
{
"type": "object",
"required": [
"orderId"
],
"properties": {
"apiKey": {
"type": [
"string",
"null"
],
"default": null,
"description": "Agent API key (nag_agt_...). Omit when connected with an Authorization header"
},
"orderId": {
"type": "string",
"format": "uuid",
"description": "Order ID to cancel"
}
}
}Confirms 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.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | null | Agent API key (nag_agt_...). Omit when connected with an Authorization header |
| orderId* | string | Order ID to confirm |
{
"type": "object",
"required": [
"orderId"
],
"properties": {
"apiKey": {
"type": [
"string",
"null"
],
"default": null,
"description": "Agent API key (nag_agt_...). Omit when connected with an Authorization header"
},
"orderId": {
"type": "string",
"format": "uuid",
"description": "Order ID to confirm"
}
}
}Places 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.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | null | Agent API key (nag_agt_...). Omit when connected with an Authorization header |
| quantity | integer | Quantity, default 1 |
| listingId* | string | Listing to purchase |
| variantId | string | null | Variant ID from get_listing, when the listing has variants |
| quotedTotalNano | number | null | Total in XNO from a recent get_listing call. Rejected if more than 2% off the live rate; omit to skip the guard |
| shippingAddress | object | null | Required for physical delivery; omit for digital listings |
| deliveryOptionId | integer | null | Delivery option ID from get_listing, when the listing offers several |
{
"type": "object",
"required": [
"listingId"
],
"properties": {
"apiKey": {
"type": [
"string",
"null"
],
"default": null,
"description": "Agent API key (nag_agt_...). Omit when connected with an Authorization header"
},
"quantity": {
"type": "integer",
"default": 1,
"description": "Quantity, default 1"
},
"listingId": {
"type": "string",
"format": "uuid",
"description": "Listing to purchase"
},
"variantId": {
"type": [
"string",
"null"
],
"format": "uuid",
"default": null,
"description": "Variant ID from get_listing, when the listing has variants"
},
"quotedTotalNano": {
"type": [
"number",
"null"
],
"default": null,
"description": "Total in XNO from a recent get_listing call. Rejected if more than 2% off the live rate; omit to skip the guard"
},
"shippingAddress": {
"type": [
"object",
"null"
],
"default": null,
"required": [
"fullName",
"line1",
"line2",
"city",
"state",
"postalCode",
"countryCode",
"phone"
],
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"line1": {
"type": [
"string",
"null"
]
},
"line2": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"fullName": {
"type": [
"string",
"null"
]
},
"postalCode": {
"type": [
"string",
"null"
]
},
"countryCode": {
"type": [
"string",
"null"
]
}
},
"description": "Required for physical delivery; omit for digital listings"
},
"deliveryOptionId": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Delivery option ID from get_listing, when the listing offers several"
}
}
}Fetch 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.
| Argument | Type | Description |
|---|---|---|
| listingId* | string | Listing ID from search_listings |
{
"type": "object",
"required": [
"listingId"
],
"properties": {
"listingId": {
"type": "string",
"format": "uuid",
"description": "Listing ID from search_listings"
}
}
}Polls 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.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | null | Agent API key (nag_agt_...). Omit when connected with an Authorization header |
| orderId* | string | Order ID returned by create_purchase |
{
"type": "object",
"required": [
"orderId"
],
"properties": {
"apiKey": {
"type": [
"string",
"null"
],
"default": null,
"description": "Agent API key (nag_agt_...). Omit when connected with an Authorization header"
},
"orderId": {
"type": "string",
"format": "uuid",
"description": "Order ID returned by create_purchase"
}
}
}Returns 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.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | null | Agent API key (nag_agt_...). Omit when connected with an Authorization header |
| orderId* | string | Order ID to fetch the receipt for |
{
"type": "object",
"required": [
"orderId"
],
"properties": {
"apiKey": {
"type": [
"string",
"null"
],
"default": null,
"description": "Agent API key (nag_agt_...). Omit when connected with an Authorization header"
},
"orderId": {
"type": "string",
"format": "uuid",
"description": "Order ID to fetch the receipt for"
}
}
}Creates 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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Agent name, e.g. 'claude-shopper' (max 64 chars) |
| callbackUrl | string | null | Optional webhook URL; Nagora POSTs signed order state-change events to it |
| homepageUrl | string | null | Optional homepage describing the agent |
| nanoAddress* | string | Nano (XNO) address refunds should be sent to: the wallet this agent pays from |
| contactEmail | string | null | Optional contact email for order issues |
{
"type": "object",
"required": [
"name",
"nanoAddress"
],
"properties": {
"name": {
"type": "string",
"description": "Agent name, e.g. 'claude-shopper' (max 64 chars)"
},
"callbackUrl": {
"type": [
"string",
"null"
],
"default": null,
"description": "Optional webhook URL; Nagora POSTs signed order state-change events to it"
},
"homepageUrl": {
"type": [
"string",
"null"
],
"default": null,
"description": "Optional homepage describing the agent"
},
"nanoAddress": {
"type": "string",
"description": "Nano (XNO) address refunds should be sent to: the wallet this agent pays from"
},
"contactEmail": {
"type": [
"string",
"null"
],
"default": null,
"description": "Optional contact email for order issues"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| q | string | null | Free-text search query, e.g. 'mechanical keyboard' |
| count | integer | null | Page size 1-100, default 20 |
| sortBy | string | null | Sort order: newest, price_asc, or price_desc. Default newest |
| maxPrice | number | null | Maximum price filter |
| minPrice | number | null | Minimum price filter |
| categoryId | integer | null | Numeric category filter |
| startIndex | integer | null | Pagination offset, default 0 |
{
"type": "object",
"properties": {
"q": {
"type": [
"string",
"null"
],
"default": null,
"description": "Free-text search query, e.g. 'mechanical keyboard'"
},
"count": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Page size 1-100, default 20"
},
"sortBy": {
"type": [
"string",
"null"
],
"default": null,
"description": "Sort order: newest, price_asc, or price_desc. Default newest"
},
"maxPrice": {
"type": [
"number",
"null"
],
"default": null,
"description": "Maximum price filter"
},
"minPrice": {
"type": [
"number",
"null"
],
"default": null,
"description": "Minimum price filter"
},
"categoryId": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Numeric category filter"
},
"startIndex": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Pagination offset, default 0"
}
}
}Verifies the configured credential and returns the agent's identity, spending caps, callback URL, and webhook secret. Call this first to confirm the credential works.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | null | Agent API key (nag_agt_...). Omit when connected with an Authorization header |
{
"type": "object",
"properties": {
"apiKey": {
"type": [
"string",
"null"
],
"default": null,
"description": "Agent API key (nag_agt_...). Omit when connected with an Authorization header"
}
}
}