How do I install Agentwallet?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Agentwallet need an API key?

The publisher lists these environment variables: AGENTWALLET_USER, AGENTWALLET_PASS, AGENTWALLET_API_URL, AGENTWALLET_WALLET_ID, AGENTWALLET_DASHBOARD_URL, AGENTWALLET_PRIVATE_KEY, AGENTWALLET_KEYFILE, AGENTWALLET_SOLANA_KEY, AGENTWALLET_SOLANA_KEYFILE, AGENTWALLET_RPC_URL, AGENTWALLET_RPC_ , AGENTWALLET_SOLANA_RPC, AGENTWALLET_SOLANA_RPC_ , AGENTWALLET_CHAIN_ID, AGENTWALLET_MAX_TX_NATIVE, AGENTWALLET_MAX_TX_TOKEN, AGENTWALLET_MAX_TX_SOL, AGENTWALLET_ALLOW_UNKNOWN_TOKEN_CALLS, AGENTWALLET_ALLOW_UNLIMITED_APPROVAL, AGENTWALLET_TOKEN_DECIMALS, AGENTWALLET_MAX_AUTOPAY, AGENTWALLET_MAX_AUTOPAY_PER_HOUR, AGENTWALLET_AUTOPAY_ASSETS, AGENTWALLET_X402_MAX_TIMEOUT, AGENTWALLET_APPROVALS, AGENTWALLET_PERMIT2_AUTO_APPROVE, AGENTWALLET_TOKEN_RISK, AGENTWALLET_LEGACY_PAYWALL_ORIGINS, AGENTWALLET_MAX_FEE_NATIVE, AGENTWALLET_POLICY, AGENTWALLET_LEDGER, AGENTWALLET_WEBHOOK_URL, AGENTWALLET_WEBHOOK_SECRET, AGENTWALLET_KEYFILE_PASSPHRASE, AGENTWALLET_KEYFILE_PASSPHRASE_FILE.

What transport does Agentwallet use?

Agentwallet runs locally over stdio.

When was Agentwallet last checked?

Last checked 2026-11-09. Wallet infrastructure for Ai agents. EVM + Solana. x402 payments. No KYC.

Agentwallet MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

AGENTWALLET_USER — Hosted mode: your hifriendbot.com username
AGENTWALLET_PASS — Hosted mode: an AgentWallet application password from hifriendbot.com/wallet/
AGENTWALLET_API_URL — Hosted mode: the API base (default https://hifriendbot.com/wp-json/agentwallet/v1); must be https, or http on localhost
AGENTWALLET_WALLET_ID — Hosted mode: wallet id that pays hosted billing 402s automatically (POST /wallets, /sign, /send only); unset means never
AGENTWALLET_DASHBOARD_URL — Hosted mode: dashboard link shown in tool text
AGENTWALLET_PRIVATE_KEY — Local (self-custody) mode: 0x-prefixed EVM private key; signing then happens in this process
AGENTWALLET_KEYFILE — Local mode: path of a file holding the EVM private key (instead of AGENTWALLET_PRIVATE_KEY; not both)
AGENTWALLET_SOLANA_KEY — Local mode for Solana: secret key as a JSON array, base58 or base64
AGENTWALLET_SOLANA_KEYFILE — Local mode for Solana: path of a key file (instead of AGENTWALLET_SOLANA_KEY; not both)
AGENTWALLET_RPC_URL — Local mode: one EVM RPC for every chain
AGENTWALLET_RPC_<chainId> — Local mode: EVM RPC per chain, e.g. AGENTWALLET_RPC_8453; eth_chainId is checked
AGENTWALLET_SOLANA_RPC — Local mode: one Solana RPC for every cluster
AGENTWALLET_SOLANA_RPC_<chainId> — Local mode: Solana RPC per cluster (900 mainnet, 901 devnet, 902 testnet); the genesis hash is checked
AGENTWALLET_CHAIN_ID — Local mode: default EVM chain when a call names none (default 8453)
AGENTWALLET_MAX_TX_NATIVE — Local mode: per-transaction ceiling in native units
AGENTWALLET_MAX_TX_TOKEN — Local mode: per-transaction ceiling for ERC-20 and SPL transfers and approvals, in token units
AGENTWALLET_MAX_TX_SOL — Local mode: per-transaction ceiling in SOL (also charged for a recipient token account the send creates)
AGENTWALLET_ALLOW_UNKNOWN_TOKEN_CALLS — Local mode: 1 lets calldata the token cap cannot price reach a token contract (refused by default)
AGENTWALLET_ALLOW_UNLIMITED_APPROVAL — 1 lets an unlimited ERC-20 allowance or an NFT operator grant through while no spend policy is set (refused by default, and always refused under a policy)
AGENTWALLET_TOKEN_DECIMALS — Pin decimals for tokens outside the registry, e.g. 8453:0x<token>=6,<mint>=9; used for amounts and caps instead of the RPC answer
AGENTWALLET_MAX_AUTOPAY — Per-payment x402 ceiling in stablecoin units (default 1); the agent cannot raise it
AGENTWALLET_MAX_AUTOPAY_PER_HOUR — Hosted mode: how many internal 402 auto-payments an hour (default 20; 0 disables)
AGENTWALLET_AUTOPAY_ASSETS — Assets pay_x402 may pay in beyond registry stablecoins, e.g. 8453:native,0x<token>
AGENTWALLET_X402_MAX_TIMEOUT — Longest x402 authorization window in seconds (default 3600; 60 to 31536000)
AGENTWALLET_APPROVALS — Hosted mode: 0 disables emailing the wallet owner for an over-cap payment
AGENTWALLET_PERMIT2_AUTO_APPROVE — Hosted mode: 1 approves exactly an upto payment maximum to Permit2 for registry stablecoins
AGENTWALLET_TOKEN_RISK — 0 skips the GoPlus lookup approve_token performs
AGENTWALLET_LEGACY_PAYWALL_ORIGINS — Comma-separated https origins whose legacy-shaped 402 may be paid by an on-chain transfer proved by hash (the API host always may)
AGENTWALLET_MAX_FEE_NATIVE — Local mode: the most a transaction may burn in fees (gas x max fee per gas), in native units; default 0.01
AGENTWALLET_POLICY — Path of a spend policy JSON file: rolling dollar and native budgets, host, recipient, chain, asset and tool lists, and a human-approval threshold, enforced from a hash-chained ledger
AGENTWALLET_LEDGER — Path of the append-only ledger the policy is enforced from (default: agentwallet-ledger.jsonl beside the policy file)
AGENTWALLET_WEBHOOK_URL — https URL (or http on localhost) that receives every ledger line as it is written
AGENTWALLET_WEBHOOK_SECRET — HMAC-SHA256 key for the X-AgentWallet-Signature header on webhook posts
AGENTWALLET_KEYFILE_PASSPHRASE — Passphrase that opens an encrypted keyfile (made with `agentwallet-mcp encrypt-keyfile`)
AGENTWALLET_KEYFILE_PASSPHRASE_FILE — Path of a file holding the keyfile passphrase (instead of AGENTWALLET_KEYFILE_PASSPHRASE; not both)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1AGENTWALLET_USER=<value> AGENTWALLET_PASS=<secret> AGENTWALLET_API_URL=<value> AGENTWALLET_WALLET_ID=<value> AGENTWALLET_DASHBOARD_URL=<value> AGENTWALLET_PRIVATE_KEY=<secret> AGENTWALLET_KEYFILE=<value> AGENTWALLET_SOLANA_KEY=<secret> AGENTWALLET_SOLANA_KEYFILE=<value> AGENTWALLET_RPC_URL=<value> AGENTWALLET_RPC_<chainId>=<value> AGENTWALLET_SOLANA_RPC=<value> AGENTWALLET_SOLANA_RPC_<chainId>=<value> AGENTWALLET_CHAIN_ID=<value> AGENTWALLET_MAX_TX_NATIVE=<value> AGENTWALLET_MAX_TX_TOKEN=<value> AGENTWALLET_MAX_TX_SOL=<value> AGENTWALLET_ALLOW_UNKNOWN_TOKEN_CALLS=<value> AGENTWALLET_ALLOW_UNLIMITED_APPROVAL=<value> AGENTWALLET_TOKEN_DECIMALS=<value> AGENTWALLET_MAX_AUTOPAY=<value> AGENTWALLET_MAX_AUTOPAY_PER_HOUR=<value> AGENTWALLET_AUTOPAY_ASSETS=<value> AGENTWALLET_X402_MAX_TIMEOUT=<value> AGENTWALLET_APPROVALS=<value> AGENTWALLET_PERMIT2_AUTO_APPROVE=<value> AGENTWALLET_TOKEN_RISK=<value> AGENTWALLET_LEGACY_PAYWALL_ORIGINS=<value> AGENTWALLET_MAX_FEE_NATIVE=<value> AGENTWALLET_POLICY=<value> AGENTWALLET_LEDGER=<value> AGENTWALLET_WEBHOOK_URL=<value> AGENTWALLET_WEBHOOK_SECRET=<secret> AGENTWALLET_KEYFILE_PASSPHRASE=<secret> AGENTWALLET_KEYFILE_PASSPHRASE_FILE=<value> claude mcp add io.github.hifriendbot-agentwallet -- npx -y agentwallet-mcp@1.14.14

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.hifriendbot-agentwallet": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "AGENTWALLET_USER": "<value>",11        "AGENTWALLET_PASS": "<secret>",12        "AGENTWALLET_API_URL": "<value>",13        "AGENTWALLET_WALLET_ID": "<value>",14        "AGENTWALLET_DASHBOARD_URL": "<value>",15        "AGENTWALLET_PRIVATE_KEY": "<secret>",16        "AGENTWALLET_KEYFILE": "<value>",17        "AGENTWALLET_SOLANA_KEY": "<secret>",18        "AGENTWALLET_SOLANA_KEYFILE": "<value>",19        "AGENTWALLET_RPC_URL": "<value>",20        "AGENTWALLET_RPC_<chainId>": "<value>",21        "AGENTWALLET_SOLANA_RPC": "<value>",22        "AGENTWALLET_SOLANA_RPC_<chainId>": "<value>",23        "AGENTWALLET_CHAIN_ID": "<value>",24        "AGENTWALLET_MAX_TX_NATIVE": "<value>",25        "AGENTWALLET_MAX_TX_TOKEN": "<value>",26        "AGENTWALLET_MAX_TX_SOL": "<value>",27        "AGENTWALLET_ALLOW_UNKNOWN_TOKEN_CALLS": "<value>",28        "AGENTWALLET_ALLOW_UNLIMITED_APPROVAL": "<value>",29        "AGENTWALLET_TOKEN_DECIMALS": "<value>",30        "AGENTWALLET_MAX_AUTOPAY": "<value>",31        "AGENTWALLET_MAX_AUTOPAY_PER_HOUR": "<value>",32        "AGENTWALLET_AUTOPAY_ASSETS": "<value>",33        "AGENTWALLET_X402_MAX_TIMEOUT": "<value>",34        "AGENTWALLET_APPROVALS": "<value>",35        "AGENTWALLET_PERMIT2_AUTO_APPROVE": "<value>",36        "AGENTWALLET_TOKEN_RISK": "<value>",37        "AGENTWALLET_LEGACY_PAYWALL_ORIGINS": "<value>",38        "AGENTWALLET_MAX_FEE_NATIVE": "<value>",39        "AGENTWALLET_POLICY": "<value>",40        "AGENTWALLET_LEDGER": "<value>",41        "AGENTWALLET_WEBHOOK_URL": "<value>",42        "AGENTWALLET_WEBHOOK_SECRET": "<secret>",43        "AGENTWALLET_KEYFILE_PASSPHRASE": "<secret>",44        "AGENTWALLET_KEYFILE_PASSPHRASE_FILE": "<value>"45      }46    }47  }48}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Agentwallet