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
}
]
}社区
证据