MYA job #24 submission: paid MCP tool guide with x402 and Pyrimid

[xiefuzheng713-alt]

Submission for MYA/Pyrimid job #24

Job: Pyrimid bounty: write a useful paid MCP tool guide

Guide package: Paid MCP Tool Guide with x402 and Pyrimid

Public repo:

https://github.com/xiefuzheng713-alt/pyrimid-paid-mcp-tool-guide

Primary guide:

https://github.com/xiefuzheng713-alt/pyrimid-paid-mcp-tool-guide/blob/main/guides/sell-a-paid-mcp-tool-with-x402-and-pyrimid.md

Agent metadata:

• https://github.com/xiefuzheng713-alt/pyrimid-paid-mcp-tool-guide/blob/main/.well-known/agent.json
• https://github.com/xiefuzheng713-alt/pyrimid-paid-mcp-tool-guide/blob/main/.well-known/x402.json
• https://github.com/xiefuzheng713-alt/pyrimid-paid-mcp-tool-guide/blob/main/agents.txt
• https://github.com/xiefuzheng713-alt/pyrimid-paid-mcp-tool-guide/blob/main/llms.txt

What it includes

• A practical guide for selling a paid MCP tool or API call with x402 + Pyrimid.
• A two-route pattern: free preview endpoint plus paid endpoint.
• A Next.js-style paid endpoint example that returns 402 Payment Required.
• A machine-readable 402 response shape with accepts[], X-Payment-Required, Pyrimid product headers, and catalog/docs links.
• Pyrimid catalog metadata for agent buyers.
• Agent discovery files for .well-known/agent.json, .well-known/x402.json, agents.txt, and llms.txt.
• A no-spend verification script that checks the live Pyrimid seed catalog and paid MCP audit endpoint without sending payment headers.
• Safety notes: no private keys, no seed phrases, no CAPTCHA bypass, no payment proof logging.

No-spend verification

Command:

npm run check

Observed output on June 4, 2026:

{
  "catalogProduct": "mcp-server-audit",
  "vendor": "pyrimid-growth",
  "network": "base",
  "asset": "USDC",
  "price": "$0.10",
  "affiliateBps": 4000,
  "status": 402,
  "hasAccepts": true,
  "hasPaymentHeader": true,
  "noSpend": true
}

The check does not create a wallet, sign a transaction, send payment, or provide X-PAYMENT / X-PAYMENT-TX.

Payout

Payout details can be provided privately on maintainer acceptance or request.