Packages
MCP server reference
Every environment variable, tool and resource in @zanora/mcp, for both the buyer and seller profiles.
Terminal
npx -y @zanora/mcp # stdio. stdout carries the protocol; logs go to stderrEnvironment
| Variable | Profile | Required | Default | Meaning |
|---|---|---|---|---|
ZANORA_ROLE | both | no | buyer | buyer or seller. Never guessed from other variables |
ZANORA_API_KEY | both | yes¹ | — | workspace key (buyer) or provider key (seller) |
ZANORA_GATEWAY_URL | both | no | https://api.zanora.dev | |
ZANORA_AGENT_KEY_FILE | buyer | yes² | — | path to the wallet's ed25519 private key PEM |
ZANORA_AGENT_KEY | buyer | yes² | — | the PEM inline (escaped \n accepted) |
ZANORA_WALLET_ID | buyer | no | derived | needed only if the workspace has several agent wallets |
ZANORA_AGENT_ID | buyer | no | the agent's name (its wallet's owner id), else the wallet id | the agent name on payment proofs and approvals |
ZANORA_MAX_PRICE_MICROS | buyer | no | none | per-call ceiling in micro-dollars. 5.00 is rejected; write 5000000 for $5.00. The old ZANORA_MAX_PRICE_MINOR (cents) is refused at startup |
ZANORA_APPROVAL_ELICITATION | buyer | no | on | off to never prompt the user about held spends |
ZANORA_ALLOW_LOCAL_PACKAGES | buyer | no | none | comma-separated packages this agent may run, e.g. @acme/ocr-mcp,@acme/tts@2.1.0. Packages aren't payable yet, so this doesn't affect purchases |
ZANORA_SELLER_HEADERS | buyer | no | — | JSON keyed by seller origin: {"https://seller.example":{"authorization":"Bearer …"}} |
ZANORA_SALES_POLL_MS | seller | no | 20000 | how often to check for changes while a resource is subscribed. Minimum 5000 |
ZANORA_HOME | buyer | no | ~/.zanora | where setup stored the agent's credentials. Read whenever ZANORA_API_KEY isn't set, which supplies the key, wallet, agent name, key file and gateway |
¹ Required on any real deployment, unless npx -y @zanora/mcp setup stored credentials in ZANORA_HOME (buyer only). Without either, every tool returns UNAUTHORIZED. ² One of the two, or the stored credentials. The seller profile refuses a wallet key.
Every value is checked at startup. A bad value fails immediately with the variable's name.
Buyer tools
| Tool | Arguments | Spends |
|---|---|---|
zanora_discover | query?, category?, protocol?, maxPriceMicros?, maxLatencyMs?, limit? | |
zanora_capability | capabilityId | |
zanora_invoke | capabilityId, body (the request body; for MCP, the tool's arguments), method?, maxPriceMicros? (can only lower the ceiling). endpoint? and tool? only for an id this session hasn't seen; prefer zanora_capability | ✓ |
zanora_wallet_balance | — | |
zanora_wallet_ledger | limit?: the most recent N entries (1–200, default 20) | |
zanora_purchases | limit?, after? | |
zanora_receipt | receiptId | |
zanora_rate_provider | providerId, transactionId, rating (1–5) | |
zanora_deposit_addresses | — | |
zanora_request_funding | amountMicros (string micro-dollars). Creates a one-time card payment link for a person to pay; moves no money itself | |
zanora_approval_status | approvalId |
Resources: zanora://wallet, zanora://purchases.
Seller tools
| Tool | Does |
|---|---|
zanora_provider_status | verification, suspension, reputation, and why nothing is selling |
zanora_request_verification | asks to be verified (note?, contact?) |
zanora_publish_capability | publishes one capability (endpoint, or runsLocally for a package listing that isn't payable) |
zanora_publish_capabilities | publishes several at once |
zanora_update_capability | edits the price, wording, tags, schema or latency |
zanora_list_capabilities | your listings, including deprecated ones |
zanora_deprecate_capability | withdraws a capability |
zanora_sales | receipts for your sales (limit?, after?) |
zanora_earnings | settlement wallet balance |
zanora_payout_destinations | reads your payout destinations |
zanora_rail_transactions | your payouts, where each was sent, and their state |
Resources, all subscribable: zanora://sales, zanora://earnings, zanora://catalogue.
Protocol details
- Every tool declares an
outputSchemaand returnsstructuredContent. Errors carry no structured content. zanora_invokesends four named progress steps when the client provides a progress token.- Long lists page with
afterand returnnextCursor. - Where the client supports elicitation,
zanora_invokecan ask the user to approve a held spend, or to fund an empty wallet.
Embedding it
TypeScript
import { createZanoraMcpServer, loadConfigFromEnv } from "@zanora/mcp";
const { server } = createZanoraMcpServer(await loadConfigFromEnv());
await server.connect(myTransport);
// Seller profile: createZanoraSellerMcpServer(loadSellerConfigFromEnv())