# AGENTS.md

Listing Roast x402 is a paid API for agents and builders who need a quick x402 listing-quality score, buyer-agent skip-reason check, or service-discovery audit.

## Safety

- Free discovery routes may be fetched without payment.
- Do not call paid routes unless the buyer explicitly intends to pay USDC through x402.
- No OAuth, account registration, API key, agent registration, ACP, UCP, or MPP endpoint is supported.
- Use the HTTP 402 challenge and x402 payment header flow for paid routes.

## Best First Paid Route

- Method: GET
- URL: https://listing-roast-x402-service-production.up.railway.app/api/listing-roast
- Price: $0.001
- Max amount: 1000 USDC units
- Use it for the fastest paid score from the already-indexed listing-roast URL.

```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
```

## Generic Paid Entry Points

- GET https://listing-roast-x402-service-production.up.railway.app/api for agents that start at /api first.
- GET https://listing-roast-x402-service-production.up.railway.app/api/v1 for agents that start at /api/v1 first.
- GET https://listing-roast-x402-service-production.up.railway.app/v1 for agents that start at /v1 first.

Each generic entrypoint costs $0.001, max 1000 USDC units, and returns the paid route map after x402 payment.

## Free Discovery

- Docs: https://listing-roast-x402-service-production.up.railway.app/docs
- API docs: https://listing-roast-x402-service-production.up.railway.app/api-docs
- OpenAPI: https://listing-roast-x402-service-production.up.railway.app/openapi.json
- Versioned OpenAPI alias: https://listing-roast-x402-service-production.up.railway.app/api/v1/openapi.json
- Swagger JSON alias: https://listing-roast-x402-service-production.up.railway.app/swagger.json
- x402 manifest: https://listing-roast-x402-service-production.up.railway.app/x402.json
- llms.txt: https://listing-roast-x402-service-production.up.railway.app/llms.txt
- Full guide: https://listing-roast-x402-service-production.up.railway.app/llms-full.txt
- Examples: https://listing-roast-x402-service-production.up.railway.app/api/examples
- 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=buyer-agent%20skip%20reasons
- 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
- Agent Skills: https://listing-roast-x402-service-production.up.railway.app/.well-known/agent-skills/index.json
- MCP metadata: https://listing-roast-x402-service-production.up.railway.app/.well-known/mcp.json

## Other Paid Routes

- GET https://listing-roast-x402-service-production.up.railway.app/api/instant-listing-score for an instant listing score.
- GET https://listing-roast-x402-service-production.up.railway.app/api/agent-listing-conversion for agent listing conversion and buyer-agent skip reasons.
- GET https://listing-roast-x402-service-production.up.railway.app/api/x402-marketplace-conversion for x402 marketplace conversion.
- GET https://listing-roast-x402-service-production.up.railway.app/api/x402-site-audit for a no-spend x402 site audit.
- GET https://listing-roast-x402-service-production.up.railway.app/api/x402-ping for a paid x402 rail ping.
- POST https://listing-roast-x402-service-production.up.railway.app/api/listing-score for a custom-body listing score.
- POST https://listing-roast-x402-service-production.up.railway.app/api/x402-discovery-audit for a custom-body x402 discovery audit.
- POST https://listing-roast-x402-service-production.up.railway.app/api/listing-roast for the full listing roast.