@marupelkar/wallet-mcp

@marupelkar/wallet-mcp

Stdio MCP server for the wallet agent payment system. Lets an MCP client (Codex CLI, opencode, or any other stdio MCP host) pay x402- and MPP-protected APIs on the user's behalf.

Install

// mcp.json
{ "mcpServers": { "wallet": { "command": "npx", "args": ["-y", "@marupelkar/wallet-mcp"] } } }

On the first tool call the shim opens a browser tab pointed at the wallet's OAuth authorize endpoint. After you approve, a refresh token is written to ${env-paths.config}/wallet/credentials with 0o600 mode and reused across sessions.

Configuration (optional)

Env var	Default	Purpose
WALLET_BACKEND_URL	https://wallet-gray-zeta.vercel.app	Backend origin (override for self-hosting / preview deploys).
WALLET_DEBUG	unset	Set to 1 to print the OAuth authorize URL to stderr.
WALLET_NON_INTERACTIVE	unset	Set to 1 to suppress the automatic browser open (you still get the URL on stderr).

CLI commands

wallet-mcp logout       # forget local credentials
wallet-mcp reauthorize  # re-run the OAuth flow (e.g. to add scopes)

Tools exposed to the agent

• pay(target, max_amount_cents) — pay an MPP-enabled URL.
• logout — same as the CLI command.
• reauthorize — same as the CLI command.

The tool list is proxied from the backend, so new server-side tools appear without a shim upgrade.

Revoking a grant

Visit /connected-apps on the wallet, find the connection, and click Disconnect. The next time the agent makes a request, the shim re-enters the OAuth flow.