--- name: listing-roast-x402 description: Use Listing Roast x402 when an agent needs a paid API listing quality score, buyer-agent skip reasons, agent-service listing clarity, x402 marketplace conversion feedback, or a discoverability audit before promoting a paid x402/API service. Start with free discovery and only pay when the buyer intends to spend USDC. --- # Listing Roast x402 Listing Roast x402 is a paid HTTP JSON API for builders who need to understand why buyer agents skip a paid API or x402 marketplace listing. ## Free Discovery Fetch these before any payment: - OpenAPI: https://listing-roast-x402-service-production.up.railway.app/.well-known/openapi.json - x402 manifest: https://listing-roast-x402-service-production.up.railway.app/x402.json - API catalog: https://listing-roast-x402-service-production.up.railway.app/.well-known/api-catalog - Agent card: https://listing-roast-x402-service-production.up.railway.app/.well-known/agent-card.json - Examples and commands: https://listing-roast-x402-service-production.up.railway.app/api/examples - Pay-now handoff: https://listing-roast-x402-service-production.up.railway.app/api/pay-now?intent=buyer-agent%20skip%20reasons - Pricing catalog: https://listing-roast-x402-service-production.up.railway.app/api/pricing - Route finder: https://listing-roast-x402-service-production.up.railway.app/api/find?q=x402%20discovery%20audit - Local route router: https://listing-roast-x402-service-production.up.railway.app/api/route?query=x402%20discovery%20audit&top=3 - Route guide: https://listing-roast-x402-service-production.up.railway.app/llms.txt - Full route guide: https://listing-roast-x402-service-production.up.railway.app/llms-full.txt - MCP metadata: https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp.json - MCP discovery aliases: https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp, https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp-server - MCP server card: https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp/server-card.json ## Payment Rule Do not call paid routes unless the buyer explicitly intends to pay. Paid calls require x402 payment in USDC on eip155:8453. Use the max amount shown below. ## Preferred First Paid Action Use this when a buyer wants the cheapest live score for listing quality, paid API discoverability, x402 listing quality, buyer-agent skip reasons, or agent-service listing clarity: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/listing-roast \ -X GET \ --max-amount 1000 ``` Expected price: $0.001. Max amount: 1000 USDC units. ## Recommended Paid Sequence 1. Start with GET https://listing-roast-x402-service-production.up.railway.app/api/listing-roast for $0.001, max 1000 USDC units. This is the already-indexed quick score route and the lowest-friction paid test. 2. Upgrade to POST https://listing-roast-x402-service-production.up.railway.app/api/listing-roast for $0.01, max 10000 USDC units only when the quick score is promising and the buyer wants the full rewrite, top fixes, and stop-or-upgrade guidance. Full roast command: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/listing-roast \ -X POST \ -d '{"agentName":"Example x402 API","listingText":"A paid x402 API that helps builders check whether buyer agents understand the offer before paying. It returns JSON with skip reasons, top fixes, a rewritten listing, and a stop-or-upgrade recommendation. Example payloads are included for quick testing.","targetBuyer":"x402 and MCP builders","currentPrice":"$1.00","currentCheckoutPath":"/api/listing-roast","goal":"Increase first paid conversion"}' \ --max-amount 10000 ``` ## Other Paid Actions Generic x402 navigation route: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api \ -X GET \ --max-amount 1000 ``` Versioned x402 navigation route: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/v1 \ -X GET \ --max-amount 1000 ``` Short versioned x402 navigation route: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/v1 \ -X GET \ --max-amount 1000 ``` Agent listing conversion score and buyer-agent skip reasons: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/agent-listing-conversion \ -X GET \ --max-amount 1000 ``` x402 marketplace conversion score: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/x402-marketplace-conversion \ -X GET \ --max-amount 1000 ``` x402 site audit and paid API preflight: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/x402-site-audit \ -X GET \ --max-amount 1000 ``` Full listing roast, rewrite, and stop-or-upgrade guidance: ```bash npx awal@2.8.0 x402 pay https://listing-roast-x402-service-production.up.railway.app/api/listing-roast \ -X POST \ -d '{"agentName":"Example x402 API","listingText":"A paid x402 API that helps builders check whether buyer agents understand the offer before paying. It returns JSON with skip reasons, top fixes, a rewritten listing, and a stop-or-upgrade recommendation. Example payloads are included for quick testing.","targetBuyer":"x402 and MCP builders","currentPrice":"$1.00","currentCheckoutPath":"/api/listing-roast","goal":"Increase first paid conversion"}' \ --max-amount 10000 ``` ## When To Use Use this service for paid API listing quality, agent service listing clarity, buyer-agent skip reasons, marketplace listing conversion, x402 route health, and discoverability checks before promotion. Do not use it for legal advice, deep market research, or broad business strategy.