Boundary Guard x402
MCP tools for x402 readiness, paid-path probes, launch packs, and trust receipts.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"boundary-guard-x402": {
"url": "https://x402-resource-scanner.vercel.app/mcp"
}
}
}リモートエンドポイント
https://x402-resource-scanner.vercel.app/mcpstreamable-httpできること
ツール一覧
ツール(6)
🟢boundary_guard_check(nextStep, policy, request, result)
Create a deterministic, read-only pre-action receipt from request, policy, and optional result evidence. Use before an agent posts, spends, lists, or writes so the decision can be audited; no external action is executed.
入力スキーマ
{
"type": "object",
"properties": {
"nextStep": {
"description": "Optional guidance stored in the receipt.",
"type": "string"
},
"policy": {
"description": "Decision object, e.g. allow/retry/review/block and reason.",
"type": "object"
},
"request": {
"description": "Action metadata the agent is about to perform.",
"type": "object"
},
"result": {
"description": "Optional result or dry-run summary to hash into evidence.",
"type": "object"
}
},
"required": [
"request"
],
"additionalProperties": true
}出力スキーマ
{
"type": "object",
"properties": {
"claimBoundary": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"decision": {
"type": "string"
},
"evidenceHash": {
"type": "string"
},
"marketplacePositioning": {
"type": "object"
},
"nextStep": {
"type": "string"
},
"receiptId": {
"type": "string"
}
},
"required": [
"receiptId",
"createdAt",
"decision",
"evidenceHash",
"claimBoundary"
],
"additionalProperties": true
}🟢scan_x402_resource(expected_resources, marketplace_url, url)
Read-only scan of a public API/provider URL for x402, OpenAPI, pricing, and agent-discovery metadata. Pass url, and optionally marketplace_url plus expected_resources, to get a readiness score, issues, and fixes; no private endpoints are called.
入力スキーマ
{
"type": "object",
"properties": {
"expected_resources": {
"description": "Optional expected resource count.",
"type": "integer"
},
"marketplace_url": {
"description": "Optional marketplace/listing URL to compare against public metadata.",
"type": "string"
},
"url": {
"description": "Target API/provider base URL to scan.",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"issues": {
"items": {
"type": "string"
},
"type": "array"
},
"marketplacePositioning": {
"type": "object"
},
"nextSteps": {
"items": {
"type": "string"
},
"type": "array"
},
"prices": {
"items": {
"type": "object"
},
"type": "array"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"target": {
"type": "string"
}
},
"required": [
"target",
"score",
"issues",
"nextSteps"
],
"additionalProperties": true
}🟢probe_x402_paid_path(expected, method, mode, target)
Probe a public x402 paid endpoint without signing or paying, then parse the HTTP 402 challenge. Pass target plus optional expected network/asset/price to verify payment metadata and receive a deterministic health receipt.
入力スキーマ
{
"type": "object",
"properties": {
"expected": {
"additionalProperties": true,
"description": "Optional expected x402 metadata such as network, asset, and priceUsd.",
"properties": {
"asset": {
"type": "string"
},
"network": {
"type": "string"
},
"priceUsd": {
"type": "string"
}
},
"type": "object"
},
"method": {
"description": "Safe unpaid probe method. Defaults to GET.",
"enum": [
"GET",
"HEAD",
"OPTIONS"
],
"type": "string"
},
"mode": {
"description": "Probe mode for v1. Defaults to unpaid_402.",
"enum": [
"unpaid_402",
"metadata_only"
],
"type": "string"
},
"target": {
"description": "Specific paid endpoint URL to probe without payment.",
"type": "string"
}
},
"required": [
"target"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"checks": {
"type": "object"
},
"healthy": {
"type": "boolean"
},
"issues": {
"items": {
"type": "string"
},
"type": "array"
},
"observed": {
"type": "object"
},
"receipt": {
"type": "object"
},
"recommendedFixes": {
"items": {
"type": "string"
},
"type": "array"
},
"target": {
"type": "string"
}
},
"required": [
"target",
"healthy",
"checks",
"observed",
"issues",
"recommendedFixes",
"receipt"
],
"additionalProperties": true
}🟢check_agent_tool_readiness(expected, expected_resources, marketplace_url, method, paid_path, ...)
GateCheck 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). Pass target plus optional tier, marketplace_url, expected_resources, and paid_path; deep/report tiers add unpaid 402 probing when paid_path is supplied. Tiers: quick $1, deep $5, report $10.
入力スキーマ
{
"type": "object",
"properties": {
"expected": {
"additionalProperties": true,
"description": "Optional expected x402 network/asset/price metadata for paid_path probes.",
"type": "object"
},
"expected_resources": {
"description": "Optional expected resource count.",
"type": "integer"
},
"marketplace_url": {
"description": "Optional marketplace/listing URL to compare against public metadata.",
"type": "string"
},
"method": {
"description": "Safe unpaid probe method when paid_path is supplied. Defaults to GET.",
"enum": [
"GET",
"HEAD",
"OPTIONS"
],
"type": "string"
},
"paid_path": {
"description": "Optional specific paid endpoint to probe without payment for deep/report tiers.",
"type": "string"
},
"target": {
"description": "Target API/provider base URL to scan.",
"type": "string"
},
"tier": {
"description": "Readiness depth. quick=$1, deep=$5, report=$10. Defaults to quick.",
"enum": [
"quick",
"deep",
"report"
],
"type": "string"
}
},
"required": [
"target"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"checks": {
"type": "object"
},
"healthProbe": {
"type": [
"object",
"null"
]
},
"issues": {
"items": {
"type": "string"
},
"type": "array"
},
"priceUsd": {
"type": "string"
},
"product": {
"type": "string"
},
"ready": {
"type": "boolean"
},
"recommendedFixes": {
"items": {
"type": "string"
},
"type": "array"
},
"report": {
"type": "object"
},
"scan": {
"type": "object"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"target": {
"type": "string"
},
"tier": {
"enum": [
"quick",
"deep",
"report"
],
"type": "string"
}
},
"required": [
"product",
"target",
"tier",
"priceUsd",
"ready",
"score",
"checks",
"issues",
"recommendedFixes"
],
"additionalProperties": true
}🟢generate_x402_launch_pack(audience, desired_marketplaces, expected, expected_resources, marketplace_url, ...)
Generate marketplace-safe launch assets for an x402/MCP seller: listing copy, buyer FAQ, checklist, approval packet, and claim boundaries. Pass target plus optional product_name, audience, primary_use_case, marketplace_url, and paid_path; service/premium tiers include readiness evidence. Tiers: single $9, service $29, premium $49.
入力スキーマ
{
"type": "object",
"properties": {
"audience": {
"description": "Primary buyer/audience for listing copy.",
"type": "string"
},
"desired_marketplaces": {
"description": "Optional marketplace names to include in launch planning.",
"items": {
"type": "string"
},
"type": "array"
},
"expected": {
"additionalProperties": true,
"description": "Optional expected x402 network/asset/price metadata for paid_path probes.",
"type": "object"
},
"expected_resources": {
"description": "Optional expected resource count.",
"type": "integer"
},
"marketplace_url": {
"description": "Optional marketplace/listing URL to compare against public metadata.",
"type": "string"
},
"method": {
"description": "Safe unpaid probe method when paid_path is supplied. Defaults to GET.",
"enum": [
"GET",
"HEAD",
"OPTIONS"
],
"type": "string"
},
"paid_path": {
"description": "Optional paid endpoint to validate via unpaid 402 challenge for service/premium packs.",
"type": "string"
},
"primary_use_case": {
"description": "Primary buyer outcome/use case.",
"type": "string"
},
"product_name": {
"description": "Buyer-facing product title.",
"type": "string"
},
"target": {
"description": "Target API/provider base URL to package for launch.",
"type": "string"
},
"tier": {
"description": "Launch pack depth. single=$9, service=$29, premium=$49. Defaults to single.",
"enum": [
"single",
"service",
"premium"
],
"type": "string"
}
},
"required": [
"target"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"approvalRequiredBeforeDistribution": {
"type": "boolean"
},
"claimBoundary": {
"type": "string"
},
"launchPack": {
"type": "object"
},
"priceUsd": {
"type": "string"
},
"product": {
"type": "string"
},
"productName": {
"type": "string"
},
"readiness": {
"type": "object"
},
"readinessScore": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"readyForDistribution": {
"type": "boolean"
},
"report": {
"type": "object"
},
"target": {
"type": "string"
},
"tier": {
"enum": [
"single",
"service",
"premium"
],
"type": "string"
}
},
"required": [
"product",
"target",
"tier",
"priceUsd",
"productName",
"readinessScore",
"approvalRequiredBeforeDistribution",
"launchPack"
],
"additionalProperties": true
}🟢generate_trust_receipt(nextStep, payment, policy, request, result)
Generate a deterministic trust receipt from sanitized request/policy/result/payment summaries. Do not submit raw auth headers, cookies, API keys, private keys, payment signatures, payment response headers, customer prompts, customer documents, or payer-identifying evidence.
入力スキーマ
{
"type": "object",
"properties": {
"nextStep": {
"description": "Optional receipt next-step guidance.",
"type": "string"
},
"payment": {
"description": "Optional sanitized payment summary or caller-provided hashes only; do not include raw payment signatures, raw payment response headers, private keys, API keys, cookies, payer-identifying evidence, or wallet secrets.",
"type": "object"
},
"policy": {
"description": "Sanitized policy or decision summary to hash.",
"type": "object"
},
"request": {
"description": "Sanitized request/action summary to hash; omit raw prompts, documents, credentials, cookies, auth headers, signatures, and secrets.",
"type": "object"
},
"result": {
"description": "Sanitized outcome/result summary to hash; omit customer data and secret-like values.",
"type": "object"
}
},
"required": [
"request"
],
"additionalProperties": true
}出力スキーマ
{
"type": "object",
"properties": {
"claimBoundary": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"decision": {
"type": "string"
},
"evidenceHash": {
"type": "string"
},
"marketplacePositioning": {
"type": "object"
},
"nextStep": {
"type": "string"
},
"receiptId": {
"type": "string"
}
},
"required": [
"receiptId",
"createdAt",
"decision",
"evidenceHash",
"claimBoundary"
],
"additionalProperties": true
}コミュニティ
エビデンス