The Payment Layer for AI Agents — MCP server for USDC payments, micropayments, and cross-chain settlement
AgentPay defines 7 tools with clear verb-noun naming (agentpay_*) and reasonable descriptions (avg 140 chars). All tools have Zod schemas with typed parameters and descriptions. However, output schemas are entirely undocumented, no tool declares what fields it returns, forcing LLMs to infer structure. Error handling is absent: no guidance on retryability, user-fixable vs fatal errors, or recovery paths. Parameter descriptions lack constraints (e.g., 'amount' accepts any string; no min/max, no format validation). Missing idempotency hints for write operations (send, open_channel, micropay, close_channel). No pagination support despite potential for large balance/resolution results.
Get the agent's wallet addresses (EOA and Smart Account).
Check USDC balance across all supported chains. Returns unified balance via Circle Gateway.
Close a state channel and settle on-chain. Final balances are paid out.
Send an instant micropayment through an open channel. No gas, no on-chain tx.
Open a state channel for instant micropayments. Off-chain, gas-free after opening.
Look up an ENS name or address. Forward resolution (name → address) and reverse resolution (address → name). Returns full ENS profile: avatar, description, URL, and social records (Twitter, GitHub, Discord).
No output schemas documented. Tools return text responses (handleBalance, handleSend, etc.) but LLMs cannot see what fields are in the response. This forces LLMs to parse unstructured text and guess at field names for downstream tool calls.
Write operations (send, open_channel, micropay, close_channel) lack idempotency hints and error recovery guidance. No indication whether retrying is safe or will cause duplicate charges/channels. No confirmation step for irreversible operations.
Parameter descriptions lack format constraints. 'amount' accepts any string but should specify: numeric format (e.g., '10.50'), min/max bounds, and decimal precision. 'chain' has no enum of valid chains (base, ethereum, polygon, etc.).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Send USDC to an address. Gas-free via Circle Paymaster.
No error handling or recovery guidance. Tools return text responses but no indication of error categories (retryable, user-fixable, fatal). LLMs cannot determine next steps on failure.
agentpay_resolve returns 'full ENS profile' but output schema is undocumented. LLMs cannot know which fields (avatar, description, URL, Twitter, GitHub, Discord) are present or how to extract them.