Skip to content
MCP server

Onchain Agent Wallets

Give an AI agent a Solana spending allowance instead of your key. Chain-enforced cap…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.1
Listing updated
5 days ago

About Onchain Agent Wallets

Onchain Agent Wallets is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Give an AI agent a Solana spending allowance instead of your key. Chain-enforced cap, x402.

Install

Run in a terminal

claude mcp add onchain-agent-wallets --env OWNER_SECRET_KEY='<OWNER_SECRET_KEY>' -- npx -y @three-ws/onchain-agent-wallets

Add to claude_desktop_config.json

{
  "mcpServers": {
    "onchain-agent-wallets": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/onchain-agent-wallets"
      ],
      "env": {
        "OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "onchain-agent-wallets": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/onchain-agent-wallets"
      ],
      "env": {
        "OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "onchain-agent-wallets": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/onchain-agent-wallets"
      ],
      "env": {
        "OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "onchain-agent-wallets": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/onchain-agent-wallets"
      ],
      "env": {
        "OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "onchain-agent-wallets": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/onchain-agent-wallets"
      ],
      "env": {
        "OWNER_SECRET_KEY": "<OWNER_SECRET_KEY>"
      }
    }
  }
}

Configuration

  • OWNER_SECRET_KEYOwner secret key, base58 or a JSON byte array. Optional: without it every owner action is returned as an unsigned transaction for Phantom, Solflare, Backpack, or a Ledger to sign.
  • OAW_NETWORKCluster: mainnet or devnet. Defaults to mainnet. State is kept per network, so a devnet rehearsal never touches mainnet agents.
  • SOLANA_RPC_URLHTTPS Solana RPC endpoint. Defaults to the public endpoint for the configured network; bring your own (Helius / Quicknode / Triton) for production.
  • OAW_STATE_DIRWhere agent keypairs, guardrails, and the spend ledger are stored. Defaults to ~/.onchain-agent-wallets, written 0600 inside a 0700 directory.
  • REQUIRE_CONFIRMRefuse to broadcast anything that moves value until the call is re-issued with confirm:true. Default true.

Pricing

Open source

Prices change. Check three.ws before you buy.

Onchain Agent Wallets FAQ

Is Onchain Agent Wallets free?

Yes. Onchain Agent Wallets is open source, so you can use and self-host it for free.

How do I add Onchain Agent Wallets to Claude Code?

Run this command in your terminal: claude mcp add onchain-agent-wallets --env OWNER_SECRET_KEY='<OWNER_SECRET_KEY>' -- npx -y @three-ws/onchain-agent-wallets