XGuard

{
  "name": "XGuard",
  "description": "A safety, verification, idempotency, finality, and settlement gateway for x402 v2 payments on Base mainnet. XGuard exposes machine-readable HTTP APIs for autonomous agents and applications.",
  "supportedInterfaces": [
    {
      "url": "https://xguard-mainnet.maqamapp.workers.dev/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "0.3"
    }
  ],
  "version": "0.5.1",
  "documentationUrl": "https://xguard-mainnet.maqamapp.workers.dev/llms-full.txt",
  "providerManifest": "https://xguard-mainnet.maqamapp.workers.dev/.well-known/x402/facilitator.json",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false,
    "x402CompatibilityBridge": true
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "x402-capability-discovery",
      "name": "Discover x402 payment capabilities",
      "description": "Returns the x402 v2 payment kinds, networks, schemes, extensions, and signer capabilities currently exposed by XGuard.",
      "tags": [
        "x402",
        "payments",
        "discovery",
        "base",
        "usdc"
      ],
      "examples": [
        "GET https://xguard-mainnet.maqamapp.workers.dev/supported"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "x402-payment-verification",
      "name": "Verify x402 payment authorization",
      "description": "Validates an x402 v2 payment authorization through XGuard's guarded facilitator route. Requires a merchant Bearer API key.",
      "tags": [
        "x402",
        "verify",
        "payments",
        "security"
      ],
      "examples": [
        "POST https://xguard-mainnet.maqamapp.workers.dev/verify"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "x402-payment-settlement",
      "name": "Settle x402 payment",
      "description": "Submits an x402 v2 settlement through XGuard with duplicate protection, durable coordination, finality tracking, and fee accounting. Requires a merchant Bearer API key and service balance.",
      "tags": [
        "x402",
        "settlement",
        "payments",
        "idempotency",
        "finality"
      ],
      "examples": [
        "POST https://xguard-mainnet.maqamapp.workers.dev/settle"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "mcp-x402-discovery",
      "name": "Discover x402 resources over MCP",
      "description": "Use the public Streamable HTTP MCP server to discover paid x402 HTTP APIs and MCP tools cataloged by XGuard.",
      "tags": [
        "mcp",
        "x402",
        "bazaar",
        "discovery",
        "agents"
      ],
      "examples": [
        "POST https://xguard-mainnet.maqamapp.workers.dev/mcp with MCP-Protocol-Version: 2026-07-28",
        "GET https://xguard-mainnet.maqamapp.workers.dev/discovery/resources",
        "GET https://xguard-mainnet.maqamapp.workers.dev/discovery/search?query=weather"
      ]
    },
    {
      "id": "x402-safe-migration",
      "name": "Generate a safe XGuard migration kit",
      "description": "Generate side-effect-free instructions for a merchant-controlled switch from an observed facilitator path to XGuard without creating payments or changing third-party infrastructure.",
      "tags": [
        "x402",
        "migration",
        "facilitator",
        "safety"
      ],
      "examples": [
        "GET https://xguard-mainnet.maqamapp.workers.dev/.well-known/xguard/migrate?from=cdp&name=my-service"
      ]
    },
    {
      "id": "x402-settlement-truth",
      "name": "Resolve independent x402 settlement truth",
      "description": "Use XGuard's merchant-scoped finality and recovery endpoints to distinguish FINALIZED, PENDING, PROVEN_FAILED, and CONFLICT without blindly resubmitting an ambiguous payment authorization.",
      "tags": [
        "x402",
        "settlement",
        "finality",
        "recovery",
        "payments",
        "safety"
      ],
      "examples": [
        "GET https://xguard-mainnet.maqamapp.workers.dev/v1/settlements/<logicalPaymentKey>/truth",
        "POST https://xguard-mainnet.maqamapp.workers.dev/v1/settlements/<logicalPaymentKey>/resolve"
      ]
    }
  ],
  "xguardDiscovery": {
    "mcp": "https://xguard-mainnet.maqamapp.workers.dev/mcp",
    "mcpManifest": "https://xguard-mainnet.maqamapp.workers.dev/.well-known/mcp/server.json",
    "resources": "https://xguard-mainnet.maqamapp.workers.dev/discovery/resources",
    "search": "https://xguard-mainnet.maqamapp.workers.dev/discovery/search",
    "migration": "https://xguard-mainnet.maqamapp.workers.dev/.well-known/xguard/migrate",
    "settlementTruth": "https://xguard-mainnet.maqamapp.workers.dev/v1/settlements/{logicalPaymentKey}/truth",
    "settlementResolve": "https://xguard-mainnet.maqamapp.workers.dev/v1/settlements/{logicalPaymentKey}/resolve",
    "preferredMcpProtocolVersion": "2026-07-28"
  },
  "protocolVersion": "0.3.0",
  "url": "https://xguard-mainnet.maqamapp.workers.dev/a2a",
  "preferredTransport": "JSONRPC",
  "additionalInterfaces": [
    {
      "url": "https://xguard-mainnet.maqamapp.workers.dev/a2a",
      "transport": "JSONRPC"
    }
  ],
  "provider": {
    "organization": "XGuard",
    "url": "https://github.com/moelayyan90/XGuard"
  },
  "compatibility": {
    "mode": "transaction-compatibility-bridge",
    "canonical": {
      "x402Version": 2,
      "scheme": "exact",
      "network": "eip155:8453"
    },
    "acceptedLegacy": [
      {
        "x402Version": 1,
        "scheme": "exact",
        "network": "base",
        "translation": "maxAmountRequired->amount; base->eip155:8453"
      }
    ],
    "invariant": "The EIP-3009 authorization payload and signature are preserved verbatim; only the x402 protocol envelope is normalized.",
    "endpoints": {
      "verify": "/verify",
      "settle": "/settle",
      "supported": "/supported"
    }
  }
}