Skip to main content
Everything below talks to real infrastructure — real Stellar testnet, a real facilitator, a real LLM. There’s no offline/mocked mode, by design.

​
Prerequisites

  • Node.js 18+ and pnpm
  • A free OpenRouter API key (no card required for :free models) — powers the summarization resource
  • An OZ Channels API key — the real x402 facilitator this project uses (not the www.x402.org/facilitator URL some older x402 docs reference)
If you skip the OZ Channels API key, nymor-resources crashes at startup with no supported payment kinds loaded from any facilitator. This is a known pitfall in the Stellar agentic-payments skill — the facilitator requires Bearer auth on both testnet and mainnet.

​
Get started

1

Install and generate accounts

2

Fund the accounts (by hand — this can't be automated)

  1. Fund both accounts with testnet XLM at the Stellar Lab friendbot
  2. Establish a USDC trustline on both — testnet USDC issuer: GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5
  3. Get testnet USDC into the buyer account from the Circle faucet
3

Run the seller and the MCP server

.mcp.json at the repo root already wires nymor-server up for Claude Code (project-scoped, points at packages/server/dist/index.js — run pnpm build first). Restart your MCP client after adding/changing .mcp.json, then ask it “what paid resources does nymor know about?” — it should call nymor.discover and list both resources.
4

Run the dashboard (optional — for humans, not agents)

You’ll need a Freighter wallet with a testnet USDC trustline to use the “Try it yourself” panel — see Dashboard.

​
Verify it’s real

The integration tests move real testnet USDC and print a settled transaction hash you can check on Stellar Expert — that’s deliberate. See Where things stand for exact tx hashes already on record.
Going to mainnet is a deliberately separate, later step — see Roadmap. Nothing in this quickstart touches mainnet.