Onchain Agent Wallets MCP Server

Give an AI agent a real Solana wallet without giving it your money. An MCP server that hands any agent a spending allowance instead of a private key. The funds stay in an account you own. The agent gets a delegation the SPL Token program caps on-chain, plus guardrails you control, plus the ability to pay x402 APIs out of that allowance. You can revoke it in one instruction, and take the money back without asking the…. Its 14 documented tools cover agent, wallet, pay.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-19 · ★ 4 · #141 OF 283 MAINTAINED FINANCE · VERIFIED 2026-08-25

NOASSERTION · JavaScript servers · how we verify → /methodology

01 · Install Onchain Agent Wallets

before you install - you'll need

OAW_NETWORK

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add nirholas-onchain-agent-wallets -- npx -y @three-ws/onchain-agent-wallets

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-08-19 - young repo, little track record yet

license no standard license detected - usage rights unclear; check the repo before commercial use

npm package @three-ws/onchain-agent-wallets - the @three-ws scope differs from the repo owner (nirholas); confirm it's the project's official package

registry namespace io.github.nirholas is GitHub-verified and matches the repo owner

03 · What Onchain Agent Wallets can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can generate the agent's keypair, create the vault, delegate a capped allowance, set guardrails. One call, move tokens into the vault, and SOL to the agent for its fees, send tokens to a recipient, inside the limits, and call an x402 API, paying from the allowance.

Capability map

Tools grouped from the project's README - what Onchain Agent Wallets lets an agent do.

Agent

2 tools - e.g. Send tokens to a recipient, inside the limits.; Live on-chain state, guardrails, 24h and 7d totals, and warnings.

agent_pay · agent_wallet_status

create & write

1 tool - e.g. Generate the agent's keypair, create the vault, delegate a capped allowance, set guardrails. One call.

create_agent_wallet

Fund

1 tool - e.g. Move tokens into the vault, and SOL to the agent for its fees.

fund_agent_wallet

Approve

1 tool - e.g. Raise, lower, or refill the on-chain ceiling. Replaces the previous allowance.

approve_agent_allowance

Withdraw

1 tool - e.g. Take funds back. Works with or without a live delegation.

withdraw_from_vault

Revoke

1 tool - e.g. The kill switch. Optionally sweeps the balance home in the same transaction.

revoke_agent_wallet

run & execute

1 tool - e.g. Broadcast a transaction your wallet signed.

send_signed_transaction

update

1 tool - e.g. per_tx, daily, allow_recipients, allow_hosts, expires_at, confirm_over, paused. Instant, free, no transaction.

set_guardrails

04 · Who maintains Onchain Agent Wallets

Onchain Agent Wallets is maintained by nirholas. We track 66 MCP servers from nirholas - 65 actively maintained, 7,658 combined GitHub stars, oldest repo from Feb 2024. Full record: all servers from nirholas.

05 · Facts

repository: github.com/nirholas/onchain-agent-wallets
website: https://three.ws/
category: finance - ranked #141 of 283 actively-maintained finance servers as of 2026-08-25.
registry: io.github.nirholas/onchain-agent-wallets (active, first published 2026-08-19)
packages: npm:@three-ws/onchain-agent-wallets

06 · Onchain Agent Wallets FAQ

Is Onchain Agent Wallets still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-19. We re-verify nightly.

What can Onchain Agent Wallets do?

How do I install Onchain Agent Wallets?

Run `npx -y @three-ws/onchain-agent-wallets`. The README documents one environment variable (OAW_NETWORK) to set first. You can also paste the ready-made client config above.

Does Onchain Agent Wallets run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Onchain Agent Wallets

Alternatives to Onchain Agent Wallets

Maintained finance servers if Onchain Agent Wallets isn't the fit.

Pairs well with

Servers that cover what Onchain Agent Wallets doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Pump SDK MCP Server · Hood MCP · Robinhood Crypto · Sperax OS · Universal Blockchain MCP

More JavaScript MCP servers · x402 Universal Payer · three.ws 3D Agent Tools · three.ws Activity · three.ws AgenC · Agent Sniper · see all