{
  "specVersion": "1.0",
  "host": {
    "displayName": "grug402 — x402 Marketplace",
    "identifier": "did:web:grug402.dev",
    "description": "A reference catalog of 96 HTTP 402 (x402) payment endpoints — 20 fully-compliant and 76 intentional protocol quirks — on the Radius eip155:72344 testnet. Built for developers and AI agents to test an x402 payment client. Built by people at Radius (https://radiustech.xyz) — Built for Radius workshop. Stablecoin-native settlement infrastructure for the agentic internet.",
    "url": "https://grug402.dev/"
  },
  "_dns": {
    "note": "Optional DNS TXT record for domain-based ARD discovery (set by domain owner)",
    "record": "_catalog._agents.grug402.dev",
    "value": "url=https://grug402.dev/.well-known/ai-catalog.json"
  },
  "entries": [
    {
      "identifier": "urn:air:grug402.dev:x402-catalog-api",
      "displayName": "x402 Scenario Catalog API",
      "type": "api",
      "url": "http://127.0.0.1:8080/api/x402/catalog",
      "capabilities": [
        "rest",
        "x402-payment",
        "paid-api",
        "json"
      ],
      "description": "JSON REST API returning all 96 x402 payment scenarios (20 fully-compliant, 76 intentional protocol quirks) on the Radius eip155:72344 testnet (chain 72344). Each entry carries the HTTP method, full URL, price in SBC, payment network, facilitator, and a markdown documentation link. Call any endpoint with a signed x402 payment to receive the resource. Asset: SBC (6 decimals) at 0x33ad9e4BD16B69B5BFdED37D8B5D9fF9aba014Fb. Facilitator: https://facilitator.testnet.radiustech.xyz.",
      "representativeQueries": [
        "What x402 payment endpoints are available on grug402?",
        "How do I find a compliant x402 endpoint to test my client against?",
        "What are the prices and networks for the x402 test scenarios?",
        "Which endpoints expose intentional x402 protocol quirks for client testing?",
        "How do I call a paid x402 endpoint and pay for it with SBC?"
      ]
    },
    {
      "identifier": "urn:air:grug402.dev:mcp-server",
      "displayName": "grug402 MCP Server",
      "type": "mcp",
      "url": "https://grug402.dev/.well-known/mcp/server-card.json",
      "capabilities": [
        "mcp",
        "streamable-http",
        "tools",
        "x402-payment",
        "stateless"
      ],
      "description": "Stateless Streamable HTTP MCP server (no API key required) exposing the grug402 x402 catalog as agent tools. Transport endpoint: http://127.0.0.1:8080/api/mcp. Tools: list_scenarios (browse all scenarios with optional filters), get_scenario (full detail + radius-cli command), call_scenario (trigger a real x402 402→pay→settle flow and return the decoded challenge), list_bug_classes (taxonomy of protocol-deviation types), list_categories (protocol-area categories with counts). Add with: claude mcp add grug402 --transport http http://127.0.0.1:8080/api/mcp",
      "representativeQueries": [
        "How do I connect to grug402 as an MCP tool server?",
        "What MCP tools does grug402 expose for x402 testing?",
        "Can I browse or filter x402 scenarios using MCP tools?",
        "How do I trigger a real x402 payment flow via the MCP call_scenario tool?"
      ]
    },
    {
      "identifier": "urn:air:grug402.dev:agent-skills",
      "displayName": "x402 Payments Agent Skill",
      "type": "skill",
      "url": "https://grug402.dev/.well-known/agent-skills/index.json",
      "capabilities": [
        "skill-discovery",
        "x402-payment",
        "agent-skills-rfc-v0.2.0"
      ],
      "description": "Agent Skills Discovery index (RFC v0.2.0) listing the x402-payments SKILL.md — a structured skill document that teaches an agent the complete x402 payment loop: protocol flow (402 challenge → sign → retry → settle), supported payment clients (radius-cli, viem script), network and asset details, and a linked index of every scenario.",
      "representativeQueries": [
        "How does an AI agent pay for an x402 endpoint on grug402?",
        "What agent skills does grug402 expose for autonomous x402 payment?",
        "Where is the machine-readable skill document for x402 payments?"
      ]
    },
    {
      "identifier": "urn:air:grug402.dev:openapi",
      "displayName": "x402 Marketplace OpenAPI 3.1 Document",
      "type": "api-description",
      "url": "https://grug402.dev/openapi.yaml",
      "capabilities": [
        "openapi-3.1",
        "rest",
        "x402-payment",
        "kong-deck-importable"
      ],
      "description": "Enriched OpenAPI 3.1 document describing all 96 x402 endpoints grouped by protocol category — real paths, methods, request bodies, 402-challenge schema, and per-scenario tags. Importable into Kong/decK, Postman, Insomnia, and any OpenAPI-compatible tool.",
      "representativeQueries": [
        "Where can I get the OpenAPI specification for the grug402 x402 API?",
        "How do I import the grug402 endpoints into Postman or Kong?",
        "What is the schema for the x402 402-challenge response?"
      ]
    },
    {
      "identifier": "urn:air:grug402.dev:discovery-docs",
      "displayName": "Agent Readiness & Discovery Surfaces",
      "type": "documentation",
      "url": "https://grug402.dev/agent-ready",
      "capabilities": [
        "discovery",
        "llms-txt",
        "agent-readiness",
        "sitemap"
      ],
      "description": "Human and machine-readable index of every agent-discovery surface on grug402: llms.txt, sitemap.xml, robots.txt (with Agentmap directive), OpenAPI 3.1, ACP discovery, UCP commerce profile, MCP server card, agent-skills (RFC v0.2.0), and this ARD ai-catalog — all derived from the live x402 catalog so they never drift from the endpoints.",
      "representativeQueries": [
        "What discovery surfaces does grug402 expose for AI agent crawlers?",
        "How is grug402 designed to be machine-readable and agent-accessible?",
        "Where can I find the llms.txt, sitemap, or MCP server card for grug402?"
      ]
    }
  ]
}