Skip to content
MCP server

MCP Agentic Wallet — open-source session management for x402

Open-source wallet sessions letting AI agents pay for paid MCP tool calls in USDC

Pricing
Open source
Platforms
API, self-hosted
Version
1.0.1
Listing updated
today

Similar MCP servers

About MCP Agentic Wallet — open-source session management for x402

MCP Agentic Wallet — open-source session management for x402 is an open-source MCP server for finance and payments. It is available on API and self-hosted.

The README says the project lets a person authorize an AI agent's spending with a single signed EIP-2612 Permit rather than issuing API keys or recurring billing. The human signs the permit from a crypto wallet, the server checks the signature and returns a session token, and the agent then sends that token with MCP requests. Each tool call draws down a budget that the server settles on Base through a USDC transferFrom.

The core package, @mcp-agentic-wallet/core, is a TypeScript library built on viem. It provides an in-memory session store that can be swapped for a key-value or Redis backend, permit verification, settlement, allowance and rate-limit checks, and a helper that strips permit signatures from client-facing session data. A Next.js reference server with a /wallet page is included for trying the flow locally.

The project suits developers who run MCP servers and want to charge per call on-chain without managing accounts or card billing. The README also describes its own sim-racing use case, where the same session flow pays entry fees into an escrow contract.

What it does

Permit-based session authorization
A human signs one gasless EIP-2612 Permit, which the server verifies on-chain before issuing a session token.
Per-call USDC settlement
Each tool call consumes budget from the session and is settled on Base with a transferFrom to a treasury address.
Reusable core library
The framework-agnostic @mcp-agentic-wallet/core package exposes store, verification, settlement and rate-limit helpers.
Built-in safety limits
Sessions cap allowance at $100 USDC and deadlines at 30 days, rate-limit authorizations, and can be revoked by the human.
Settlement debt tracking
Sessions are suspended after three failed settlements, as described in the security section.

Good for

  • Charge AI agents per tool call on a paid MCP server without issuing API keys
  • Add USDC payment gating to a Next.js or other MCP server using the core library
  • Let a user pre-authorize a capped spending budget for an agent's tool usage
  • Run the reference server to test an x402-style payment flow on Base

Pricing

Open source

MIT-licensed open-source code; the README mentions no paid plan.

MCP Agentic Wallet — open-source session management for x402 FAQ

Does it require API keys or recurring charges?

The README says it has no API keys and no recurring charges, and that the signed permit serves as the spending policy.

Which blockchain and token does it use?

Payments are made in USDC on Base Mainnet (chainId 8453), per the tech stack section.

Is the code open source?

Yes, the README states the project is MIT licensed.

What environment variables are needed to run the reference server?

TREASURY_ADDRESS, HOT_WALLET_PRIVATE_KEY and NEXT_PUBLIC_TREASURY_ADDRESS are required; BASE_RPC_URL is optional and defaults to the public Base RPC.

Is MCP Agentic Wallet — open-source session management for x402 free?

Yes. MCP Agentic Wallet — open-source session management for x402 is open source, so you can use and self-host it for free.

What are the best alternatives to MCP Agentic Wallet — open-source session management for x402?

The closest alternatives to MCP Agentic Wallet — open-source session management for x402 are Universal Blockchain MCP, WarpPay402 MCP Gateway, Agent Wallet MCP, MoneyTools payment-safety suite and XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.

How AIPoweredBot checks servers