Base USDC Receivables Auditor
Dual-RPC Base USDC receivables reconciliation with safe finality and fail-ambiguous matching.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"base-usdc-receivables-auditor": {
"url": "https://base-usdc-receivables-auditor-003.qqqa16521-dce.workers.dev/mcp"
}
}
}Remote endpoints
https://base-usdc-receivables-auditor-003.qqqa16521-dce.workers.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢get_service_info
Free overview of the Base USDC Receivables Auditor, including dual-RPC safe-finality policy, fail-ambiguous matching, scan limits and the per-batch credit cost.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"service": {
"type": "string"
},
"experiment": {
"type": "string"
},
"network": {
"type": "string"
},
"chainId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"asset": {
"type": "string"
},
"reconciliationPolicy": {
"type": "object",
"properties": {
"rpcQuorum": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"finality": {
"type": "string"
},
"failAmbiguous": {
"type": "boolean"
},
"maxExpectedReceivables": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"maxScanBlocks": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"serverSigning": {
"type": "boolean"
}
},
"required": [
"rpcQuorum",
"finality",
"failAmbiguous",
"maxExpectedReceivables",
"maxScanBlocks",
"serverSigning"
],
"additionalProperties": false
},
"reconciliationCostCredits": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"service",
"experiment",
"network",
"chainId",
"asset",
"reconciliationPolicy",
"reconciliationCostCredits"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_payment_info
Free instructions for buying this service's prepaid credits with direct native Base USDC. The funding transfer is separate from receivables being audited.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output 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
}
},
"reconciliationCostCredits": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"reconciliationCredits": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"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",
"reconciliationCostCredits",
"reconciliationCredits",
"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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output 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
}
]
}🔴reconcile_usdc_receivables(receiver, fromBlock, toBlock, expected)
Scan a bounded Base Mainnet block range for native Circle USDC transfers into one receiver, require exact agreement from two public RPCs at safe finality, and compare them with up to 25 expected receivables. Returns matched, missing, underpaid, overpaid, wrong-sender, late, duplicate and needs-review exceptions without fuzzy guessing. Costs 10 credits; RPC or unsafe-range failures refund the charge.
Input Schema
{
"type": "object",
"properties": {
"receiver": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"fromBlock": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"toBlock": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"expected": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"payer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"amountAtomic": {
"type": "string",
"pattern": "^[1-9][0-9]{0,77}$"
},
"notAfterBlock": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
}
},
"required": [
"id",
"payer",
"amountAtomic"
]
}
}
},
"required": [
"receiver",
"fromBlock",
"toBlock",
"expected"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"assured": {
"type": "boolean",
"const": true
},
"report": {
"type": "object",
"properties": {
"receiver": {
"type": "string"
},
"fromBlock": {
"type": "string"
},
"toBlock": {
"type": "string"
},
"safeBlockNumber": {
"type": "string"
},
"rpcAgreement": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"observedTransferCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"matched",
"missing",
"underpaid",
"overpaid",
"wrong_sender",
"late_payment",
"duplicate_payment",
"needs_review"
]
},
"expectedPayer": {
"type": "string"
},
"expectedAmountAtomic": {
"type": "string"
},
"notAfterBlock": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string"
},
"transfers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"txHash": {
"type": "string"
},
"logIndex": {
"type": "string"
},
"blockNumber": {
"type": "string"
},
"blockHash": {
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amountAtomic": {
"type": "string"
}
},
"required": [
"txHash",
"logIndex",
"blockNumber",
"blockHash",
"from",
"to",
"amountAtomic"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"status",
"expectedPayer",
"expectedAmountAtomic",
"notAfterBlock",
"reason",
"transfers"
],
"additionalProperties": false
}
},
"unknownIncoming": {
"type": "array",
"items": {
"type": "object",
"properties": {
"txHash": {
"type": "string"
},
"logIndex": {
"type": "string"
},
"blockNumber": {
"type": "string"
},
"blockHash": {
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amountAtomic": {
"type": "string"
}
},
"required": [
"txHash",
"logIndex",
"blockNumber",
"blockHash",
"from",
"to",
"amountAtomic"
],
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"matched": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"missing": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"underpaid": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"overpaid": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"wrong_sender": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"late_payment": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"duplicate_payment": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"needs_review": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"unknown_incoming": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"matched",
"missing",
"underpaid",
"overpaid",
"wrong_sender",
"late_payment",
"duplicate_payment",
"needs_review",
"unknown_incoming"
],
"additionalProperties": false
}
},
"required": [
"receiver",
"fromBlock",
"toBlock",
"safeBlockNumber",
"rpcAgreement",
"observedTransferCount",
"items",
"unknownIncoming",
"summary"
],
"additionalProperties": false
},
"creditsRemaining": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"assured",
"report",
"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
}
]
}Community
Evidence