io.github.LarryLemonBot/boundary-guard-x402

Official6 tools

Boundary Guard x402

MCP tools for x402 readiness, paid-path probes, launch packs, and trust receipts.

Tools for x402 readiness testing, paid-path probes, launch packs, and trust verification.

Captured live from the server via tools/list.

boundary_guard_check

Create a Boundary Guard pre-action checkpoint receipt for an agent request, policy decision, and result summary. Suggested xpay price: $0.03/call.

Parameters (4)

nextStepstring
Optional guidance stored in the receipt.
policyobject
Decision object, e.g. allow/retry/review/block and reason.
requestobjectrequired
Action metadata the agent is about to perform.
resultobject
Optional result or dry-run summary to hash into evidence.

scan_x402_resource

Read-only scan of public x402/OpenAPI metadata and optional marketplace listing staleness. Suggested xpay price: $0.10/call.

Parameters (3)

expected_resourcesinteger
Optional expected resource count.
marketplace_urlstring
Optional marketplace/listing URL to compare against public metadata.
urlstringrequired
Target API/provider base URL to scan.

probe_x402_paid_path

Probe a public x402 endpoint without payment, parse the 402 challenge, compare expected network/asset/price, and return a deterministic health receipt. Suggested xpay price: $0.50/call.

Parameters (4)

expectedobject
Optional expected x402 metadata such as network, asset, and priceUsd.
methodstring
Safe unpaid probe method. Defaults to GET.
modestring
Probe mode for v1. Defaults to unpaid_402.
targetstringrequired
Specific paid endpoint URL to probe without payment.

check_agent_tool_readiness

Check whether an x402/agent-facing tool is ready for agent routing, marketplace listing, and paid-path monitoring, including public agent discovery surfaces (/llms.txt, /agents.txt, /.well-known/mcp.json, /mcp). Tiers: quick $1, deep $5, report $10.

Parameters (7)

expectedobject
Optional expected x402 network/asset/price metadata for paid_path probes.
expected_resourcesinteger
Optional expected resource count.
marketplace_urlstring
Optional marketplace/listing URL to compare against public metadata.
methodstring
Safe unpaid probe method when paid_path is supplied. Defaults to GET.
paid_pathstring
Optional specific paid endpoint to probe without payment for deep/report tiers.
targetstringrequired
Target API/provider base URL to scan.
tierstring
Readiness depth. quick=$1, deep=$5, report=$10. Defaults to quick.

generate_x402_launch_pack

Generate marketplace-safe listing copy, buyer FAQ, launch checklist, approval packet, and claim boundaries for x402/MCP sellers from readiness evidence. Tiers: single $9, service $29, premium $49.

Parameters (11)

audiencestring
Primary buyer/audience for listing copy.
desired_marketplacesarray
Optional marketplace names to include in launch planning.
expectedobject
Optional expected x402 network/asset/price metadata for paid_path probes.
expected_resourcesinteger
Optional expected resource count.
marketplace_urlstring
Optional marketplace/listing URL to compare against public metadata.
methodstring
Safe unpaid probe method when paid_path is supplied. Defaults to GET.
paid_pathstring
Optional paid endpoint to validate via unpaid 402 challenge for service/premium packs.
primary_use_casestring
Primary buyer outcome/use case.
product_namestring
Buyer-facing product title.
targetstringrequired
Target API/provider base URL to package for launch.
tierstring
Launch pack depth. single=$9, service=$29, premium=$49. Defaults to single.

generate_trust_receipt

Generate a deterministic trust receipt from arbitrary request/policy/result/payment evidence. Suggested xpay price: $0.05/call.

Parameters (5)

nextStepstring
Optional receipt next-step guidance.
paymentobject
Optional payment metadata to hash; do not include private keys.
policyobject
Policy or decision evidence to hash.
requestobjectrequired
Request/action evidence to hash.
resultobject
Outcome/result evidence to hash.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "boundary-guard-x402": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://x402-resource-scanner.vercel.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.