x402 Facilitator Compatibility Diff

Checks whether a caller-supplied facilitator capability document covers one normalized scheme, network, asset, and extension set. It never contacts a facilitator, verifies a payment, or transfers funds.

Use when

A supplied facilitator capability document must be matched to one x402 requirement.
Scheme, network, asset, or extension coverage must be checked locally.

Do not use when

Live facilitator availability, verification, or settlement must be tested.
The capability document is untrusted and requires independent discovery.
Future network compatibility or facilitator support must be guaranteed.

Invocation contract

HTTP: /v1/tools/x402-facilitator-compatibility-diff
Version: 0.1.0
Mode: lookup
Idempotency: not required
Retention: The supplied requirement and capability document are compared in memory and are not retained.
Tested with: x402 v2 capability documents, CAIP-2 networks

Positive and negative examples

{
  "input": {
    "requirement": {
      "scheme": "exact",
      "network": "eip155:8453",
      "asset": "USDC",
      "extensions": [
        "payment-identifier"
      ]
    },
    "facilitator": {
      "schemes": [
        "exact"
      ],
      "networks": [
        "eip155:8453"
      ],
      "assets": [
        "USDC"
      ],
      "extensions": [
        "payment-identifier"
      ]
    }
  },
  "output": {
    "compatible": true,
    "scheme_supported": true,
    "network_supported": true,
    "asset_supported": true,
    "missing_extensions": []
  },
  "negative": [
    {
      "scenario": "Live facilitator availability, verification, or settlement must be tested.",
      "expected_error": "INVALID_INPUT",
      "charged": false
    }
  ]
}

Deterministic errors

Code	Retry	Charged	Recovery
INVALID_INPUT	false	false	Correct the request to match input_schema.
TOOL_PAUSED	true	false	Wait for the operator to resume the tool.
RATE_LIMITED	true	false	Retry after the response Retry-After interval.
DEPENDENCY_UNAVAILABLE	true	false	Retry with the same idempotency identity.

Full machine manifest

The HTTP, OpenAPI, MCP, llms.txt, and ARD descriptions are generated from this same registry record.

Open JSON manifest →