Agentwallet MCP Server

What the code does

We read the source, 6 d ago · rules 995398eba69f

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

  if (Object.keys(process.env).some(k => /^AGENTWALLET_SOLANA_RPC_\d+$/.test(k) && (process.env[k] || '').trim())) {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add agentwallet -- npx -y agentwallet-mcp

{
  "mcpServers": {
    "agentwallet": {
      "command": "npx",
      "args": [
        "-y",
        "agentwallet-mcp"
      ]
    }
  }
}

[mcp_servers.agentwallet]
command = "npx"
args = ["-y", "agentwallet-mcp"]

{
  "mcpServers": {
    "agentwallet": {
      "command": "npx",
      "args": [
        "-y",
        "agentwallet-mcp"
      ]
    }
  }
}

{
  "servers": {
    "agentwallet": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agentwallet-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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)).