Skip to content

docs(catalog): Commerce MCP — sandbox test merchants, get_service requestShape, pay_service method - #411

Draft
r-marques wants to merge 1 commit into
mainfrom
docs/3528-sandbox-test-merchants-mcp
Draft

r-marques wants to merge 1 commit into
mainfrom
docs/3528-sandbox-test-merchants-mcp

Conversation

@r-marques

Copy link
Copy Markdown
Member

Description

Companion to nevermined-io/nvm-monorepo#3547 (issue nevermined-io/nvm-monorepo#3528).

  • products/catalog/mcp.mdx — a Sandbox row in the environments table, a tip on the two free testnet test merchants the sandbox Catalog carries (mpp-dev-paid-ping — MPP, Tempo Moderato, GET, $0.10 testnet pathUSD; x402-org-protected — x402, Base Sepolia, GET, $0.01 testnet USDC), the get_service requestShape block (per-endpoint path / method / price with exact payServiceArgs; bodySchema: null because the Catalog holds no request-body schema), pay_service method resolution (caller → catalog endpoint matching path → POST) and its echoed request block. The stale nativeEndpoint signpost example is corrected: no upstream URL is returned since the opaque broker.
  • discover.mdx, router/quickstart.mdx, from-a-harness.mdx — the "Live-only for payment / nothing payable on sandbox" statements are qualified with the test-merchant exception and a link to the MCP page, so they stop being false the day the seed lands.

⚠️ Merge timing: the two sandbox rows arrive with the nvm-monorepo release that carries #3547's SeedSandboxTestnetMerchants migration. Until that release is deployed to api.sandbox.nevermined.app, the tip describes rows that are not there yet — hold this PR until then (or merge #3547 first and wait for the release).

mintlify broken-links: no broken links found.

🤖 Generated with Claude Code

…uestShape, pay_service method resolution

The sandbox Catalog now carries two free testnet test merchants
(`mpp-dev-paid-ping`, `x402-org-protected`), so the "Live-only for payment,
nothing payable on sandbox" statements are qualified on every page that made
them (MCP, discover, Router quickstart, from-a-harness) and the MCP quickstart
gets a Sandbox row + a tip on how to rehearse the whole loop for free.

`get_service` now returns a `requestShape` (per-endpoint path/method/price with
exact `payServiceArgs`, and an honest `bodySchema: null`); `pay_service` takes
its `method` from the catalog endpoint matching `path` (POST only when the
catalog records none) and echoes a `request` block. The stale `nativeEndpoint`
signpost example is corrected — no upstream URL is returned.

Companion to nevermined-io/nvm-monorepo#3547 (nevermined-io/nvm-monorepo#3528).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant