ClawPay MCP — Non-Custodial x402 Payments for AI Agents

Non-custodial x402 payments for AI agents.

Connector by up2itnow0822 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 8

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/up2itnow0822-clawpay-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Non-custodial x402 payments for AI agents. Sign locally, spend limits, Base network.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 14 read · 13 write · 0 delete
Secrets: 1 (API keys, tokens or passwords)
Install scripts: None found
Runs as: Node.js package

Tools by what they do 27

Read from the source code; the running server may list different tools.

Read 14 · Look things up without changing anything.

check_budget
check_spend_limit
get_balances
get_reputation
get_transaction_history
get_wallet_info
list_chain_tokens
lookup_token
otel_budget_status
otel_evaluate_spend
verify_agent_identity
verify_agent_uaid

Show 2 more tools

x402_session_fetch
x402_session_status

Write 13 · Create, change, send or run things.

add_custom_token
bridge_usdc
create_escrow
deploy_wallet
otel_register_budget_policy
queue_approval
send_payment
send_token
set_spend_policy
swap_tokens
x402_pay
x402_session_end

Show 1 more tools

x402_session_start

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

AGENT_PRIVATE_KEY

Other settings (environment variables or headers).

BASE_RPC_URL

Tools (27)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

add_custom_token
Register a custom ERC-20 token in the global token registry so it can be used by send_token, get_balances, and swap_tokens. Refuses to overwrite an existing symbol+chain entry or to alias an already-registered contract with different decimals (including built-ins such as USDC) because a wrong decimals value would silently overpay on later transfers and swaps.
bridge_usdc
Bridge USDC across chains using Circle's CCTP V2 protocol. Supported chains: base, ethereum, optimism, arbitrum, polygon, avalanche, linea, unichain, sonic, worldchain. The bridge approves USDC, burns on source, polls Circle IRIS for attestation, then mints on destination. Identical retries replay the original burn/mint; pass idempotencyKey to distinguish two equal bridges. An RPC drop after broadcast fail-closes instead of burning a second time.
check_budget
Check the remaining on-chain budget for the Agent Wallet. Returns per-transaction limit and period remaining. Optionally include any configured spend policy details.
check_spend_limit
Check whether a proposed payment amount is within the wallet's autonomous spend limits. Returns a clear yes/no with remaining budget details. Use this before send_payment to avoid surprise queuing.
create_escrow
Create a mutual-stake escrow vault between the Agent Wallet (buyer) and a counterparty (seller). Both parties lock collateral (equal to payment amount) ensuring aligned incentives. Uses USDC as the payment token. Requires FACTORY_ADDRESS env var or factoryAddress param.
deploy_wallet
Deploy a new AgentAccountV2 wallet via the factory contract. The wallet is deterministically addressed (CREATE2) and owned by an NFT. Returns the wallet address and deployment transaction hash. Requires FACTORY_ADDRESS and NFT_CONTRACT_ADDRESS env vars (or pass them as arguments).
get_balances
Get all ERC-20 token balances for the configured Agent Wallet address. Uses the global token registry to enumerate tokens for the given chain.
get_reputation
Get the on-chain reputation score for an agent. Resolves agent ID from owner address via ERC-8004, then queries the Reputation Registry for score and feedback.
get_transaction_history
Retrieve the wallet's recent on-chain transaction history from event logs, plus process-lifetime x402_pay settlements (tx hash, payee, amount, token, URL, replay count). Shows executions, queued transactions, approvals, cancellations, spend policy updates, and operator changes. Filter by event type or block range for targeted queries. x402 settlement rows appear when event_type is all.
get_wallet_info
Get comprehensive wallet information including address, on-chain balance, spend limits, remaining period allowance, and queue depth. Use token parameter to check budget for a specific ERC20 (defaults to ETH).
list_chain_tokens
List all tokens registered for a given chain ID in the global token registry.
lookup_token
Look up a token by symbol and chain ID from the global token registry. Returns the token address, decimals, and metadata if found.
otel_budget_status
Get the current budget status for an AgentCore agent, including accumulated spend, remaining budget, utilization percentage, and optional decision history. Useful for dashboards and audit trails.
otel_evaluate_spend
Evaluate a spend event from an OTel span against registered budget policies. Returns a budget decision (allow/warn/block/kill) with utilization details. The decision is also formatted as OTel event attributes for re-emission into the AgentCore telemetry pipeline.
otel_register_budget_policy
Register a budget policy for an AWS AgentCore agent or task. When OTel spans report costs exceeding this budget, agentpay-mcp will enforce the configured action (warn/block/kill circuit-breaker). This fills the gap left by AgentCore Policy Controls which provide observability but no native per-agent spend caps.

Show 12 more tools

queue_approval
Manage over-limit transactions queued for owner review. Use action="list" to see pending transactions, "approve" to approve one by ID, or "cancel" to cancel one by ID. Approve/cancel require the agent key to have owner privileges.
send_payment
Send ETH or ERC20 tokens from the Agent Wallet. If the amount is within the configured spend limits, it executes immediately and returns the tx hash. If it exceeds limits, the transaction is queued for owner approval (use queue_approval to manage). Always check spend limits first with check_spend_limit to avoid surprises.
send_token
Send any ERC-20 token from the Agent Wallet to a recipient. Resolves the token address and decimals from the global registry, then calls agentTransferToken through the AgentAccountV2 contract. Subject to configured spend limits. Identical retries replay the original tx; pass idempotencyKey to distinguish two equal invoices. An RPC drop after broadcast fail-closes instead of sending a second transfer.
set_spend_policy
Configure the Agent Wallet spend policy. Sets a daily limit, per-transaction cap, and optional recipient allowlist. The policy is enforced in-process for the lifetime of the MCP server; policies from all scopes are enforced together (union).
swap_tokens
Swap one ERC-20 token for another using Uniswap V3. Resolves token addresses from the registry, executes the swap via SwapModule. Supported chains: base (8453), arbitrum (42161), optimism (10), polygon (137). Identical retries replay the original tx; pass idempotencyKey to distinguish two equal swaps. An RPC drop after broadcast fail-closes instead of sending a second swap.
verify_agent_identity
Verify an agent's on-chain identity using ERC-8004. Looks up the agent by owner address and returns identity details including agent ID, URI, and registration file.
verify_agent_uaid
Verify an agent's identity using a Universal Agent Identifier (UAID). Works across all chains — EVM (ERC-8004), Hedera, Solana, and off-chain agents. Returns identity details, payment address, and trust score from the HOL Registry.
x402_pay
Use when an agent needs one capped x402 paid HTTP request and has already verified the URL, price, payTo, asset, and Base network. Automatically handles HTTP 402 Payment Required responses with the x402 v2.11 Payment-Signature flow. If an active x402 V2 session covers this URL, the session token is used instead of making a new payment. Identical retries replay the original paid result; pass idempotencyKey to distinguish two equal fetches. An RPC drop after payment fail-closes instead of signing a second settlement. Do not use when the endpoint is an uninitialized Streamable HTTP MCP session, t…
x402_session_end
Close an x402 V2 session locally before it expires naturally: this server discards its stored copy of the session token and x402_session_fetch will return an error for the closed session. This is NOT server-side revocation — the signed bearer token cannot be revoked once issued, and any copy already sent to (or intercepted en route to) the remote endpoint remains technically valid there until the expiry baked into the token. If you suspect the token leaked, treat it as live until that expiry and notify the endpoint operator. Still useful hygiene: it stops further use from this process and scru…
x402_session_fetch
Use after x402_session_start returns a valid session_id. Injects the stored session token and makes a covered request without a new payment. Do not use before initialize/session creation, as a payment bypass, after expiry, or for URLs outside the session scope.
x402_session_start
Use when a paid endpoint supports a reusable x402 session or entitlement. Makes one capped payment, stores a non-custodial signed session token, and returns a session_id for x402_session_fetch. If an active local session already covers the endpoint, the existing session_id is returned and no new payment is signed. Do not use for providers without session semantics, unknown networks, missing spend caps, or calls where the buyer cannot store and audit the returned mcp-session-id/session_id.
x402_session_status
Check the status of x402 V2 payment sessions. Without arguments, lists all active sessions with TTL remaining. With a session_id, shows full details for that session including call count, payment info, and the signed session token.

Compare and alternatives

Featured in

Signals

Stars: 8
Forks: 4
Open issues: 25
Last commit: Oct 24, 2026 (4 days ago)
Last release: Oct 11, 2026 (17 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.up2itnow0822/clawpay-mcp
Version: 1.2.0
Auth: API key
Packages: npm clawpay-mcp
License: MIT
Repository: github.com/up2itnow0822/clawpay-mcp
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

More from up2itnow0822

Cite this page

ClawPay MCP — Non-Custodial x402 Payments for AI Agents. Agent Mart. https://agentmart.dev/connectors/up2itnow0822-clawpay-mcp (last updated 2026-10-24)