Base Payment Assurance
Dual-RPC Base USDC payment assurance with safe finality and exact transfer matching.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"base-payment-assurance": {
"url": "https://base-payment-assurance-002.qqqa16521-dce.workers.dev/mcp"
}
}
}遠端端點
https://base-payment-assurance-002.qqqa16521-dce.workers.dev/mcpstreamable-http它能做什麼
工具清單
工具(7)
🟢get_service_info
Free overview of the Base Payment Assurance service. Use this to learn the supported chain/token, dual-RPC quorum, safe-finality requirement, exact-transfer policy, fail-closed behavior, and per-call credit cost. This tool does not inspect a transaction and does not require a bearer token.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"service": {
"type": "string"
},
"experiment": {
"type": "string"
},
"network": {
"type": "string"
},
"chainId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"asset": {
"type": "string"
},
"assurancePolicy": {
"type": "object",
"properties": {
"rpcQuorum": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"finality": {
"type": "string"
},
"exactTransferMatching": {
"type": "boolean"
},
"failClosed": {
"type": "boolean"
},
"serverSigning": {
"type": "boolean"
}
},
"required": [
"rpcQuorum",
"finality",
"exactTransferMatching",
"failClosed",
"serverSigning"
],
"additionalProperties": false
},
"protectedToolsCostCredits": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"service",
"experiment",
"network",
"chainId",
"asset",
"assurancePolicy",
"protectedToolsCostCredits"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_payment_info
Free instructions for buying this service's prepaid API credits with direct native Base USDC. Returns the exact receiver, package amount, credit quantity and self-service purchase path. This funding payment is separate from any transaction that you later ask the assurance tools to inspect.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"scheme": {
"type": "string"
},
"network": {
"type": "string"
},
"chainId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"asset": {
"type": "string"
},
"assetDecimals": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"receiver": {
"type": "string"
},
"packages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"amountAtomic": {
"type": "string"
},
"credits": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"amountAtomic",
"credits"
],
"additionalProperties": false
}
},
"buyerPaysGas": {
"type": "boolean"
},
"facilitatorRequired": {
"type": "boolean"
},
"x402Compatible": {
"type": "boolean"
},
"purchasePath": {
"type": "string"
},
"redeemFlow": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"scheme",
"network",
"chainId",
"asset",
"assetDecimals",
"receiver",
"packages",
"buyerPaysGas",
"facilitatorRequired",
"x402Compatible",
"purchasePath",
"redeemFlow"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_credit_balance
Check the remaining prepaid credits for the bearer token configured on this MCP connection. This call is free and does not consume credits.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"credits": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"credits"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": false
}
]
}🔴get_safe_head
Return the conservative Base Mainnet safe head after consulting both configured public RPCs. If the RPC quorum is unavailable or inconsistent, the call fails closed and the spent credit is refunded. Costs 1 credit.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"safeBlockNumber": {
"type": "string"
},
"rpcSafeHeads": {
"type": "array",
"items": {
"type": "string"
}
},
"rpcAgreement": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"creditsRemaining": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"safeBlockNumber",
"rpcSafeHeads",
"rpcAgreement",
"creditsRemaining"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"status": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"creditsRemaining": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"error",
"status",
"creditsRemaining"
],
"additionalProperties": false
}
]
}🔴get_transaction_status(txHash)
Check whether a Base Mainnet transaction is not found, confirmed, safe, or failed using two independent RPCs. No payment assumptions are made. RPC quorum/inconsistency failures refund the credit. Costs 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"txHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
}
},
"required": [
"txHash"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"txHash": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"not_found",
"confirmed",
"safe",
"failed"
]
},
"blockNumber": {
"type": [
"string",
"null"
]
},
"safeBlockNumber": {
"type": "string"
},
"receiptStatus": {
"type": [
"string",
"null"
]
},
"rpcAgreement": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"creditsRemaining": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"txHash",
"state",
"blockNumber",
"safeBlockNumber",
"receiptStatus",
"rpcAgreement",
"creditsRemaining"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"status": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"creditsRemaining": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"error",
"status",
"creditsRemaining"
],
"additionalProperties": false
}
]
}🔴decode_usdc_transfers(txHash)
Decode all native Circle USDC Transfer logs from a Base transaction only after dual-RPC receipt agreement and safe finality. A not-found, failed, or not-yet-safe transaction is returned as an assurance result; RPC infrastructure failures refund the credit. Costs 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"txHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
}
},
"required": [
"txHash"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"assured": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"txHash": {
"type": "string"
},
"blockNumber": {
"type": [
"string",
"null"
]
},
"safeBlockNumber": {
"type": [
"string",
"null"
]
},
"transfers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amountAtomic": {
"type": "string"
}
},
"required": [
"from",
"to",
"amountAtomic"
],
"additionalProperties": false
}
},
"rpcAgreement": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"creditsRemaining": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"assured",
"reason",
"txHash",
"blockNumber",
"safeBlockNumber",
"transfers",
"rpcAgreement",
"creditsRemaining"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"status": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"creditsRemaining": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"error",
"status",
"creditsRemaining"
],
"additionalProperties": false
}
]
}🔴verify_usdc_payment(txHash, expectedPayer, expectedReceiver, expectedAmountAtomic)
Assure that a specific Base transaction contains an exact native Circle USDC Transfer from the expected payer to the expected receiver for the exact atomic amount. Verification requires two-RPC receipt agreement and safe finality. Use a decimal atomic amount string (USDC has 6 decimals). RPC infrastructure failures refund the credit. Costs 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"txHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
},
"expectedPayer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"expectedReceiver": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"expectedAmountAtomic": {
"type": "string",
"pattern": "^[1-9][0-9]{0,77}$"
}
},
"required": [
"txHash",
"expectedPayer",
"expectedReceiver",
"expectedAmountAtomic"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"verified": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"txHash": {
"type": "string"
},
"expectedPayer": {
"type": "string"
},
"expectedReceiver": {
"type": "string"
},
"expectedAmountAtomic": {
"type": "string"
},
"blockNumber": {
"type": [
"string",
"null"
]
},
"safeBlockNumber": {
"type": [
"string",
"null"
]
},
"finality": {
"type": [
"string",
"null"
]
},
"rpcAgreement": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"creditsRemaining": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"verified",
"reason",
"txHash",
"expectedPayer",
"expectedReceiver",
"expectedAmountAtomic",
"blockNumber",
"safeBlockNumber",
"finality",
"rpcAgreement",
"creditsRemaining"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"status": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"creditsRemaining": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"error",
"status",
"creditsRemaining"
],
"additionalProperties": false
}
]
}社群
證據