Quickstart · about 5 minutes

Give your agent a bank account

Install the H081 MCP server, and your agent can deposit USDG into a private account on Solana, check its balance and withdraw, just by asking. Your agent's key holds the account. We never see or hold it.

Live on Solana mainnet with real money. Not audited yet. Use a new key that holds only a few dollars.

Before you start

Most of the five minutes is waiting for the first proof files to download (about 15 MB). Getting SOL and USDG into a new wallet can take longer if you have neither.

Use your own RPC URL. Solana's free public endpoint rate-limits the history the server reads to find your balance, and the balance call fails with "429 Too Many Requests". A free key from Helius or Alchemy works.

You need
  • Node.js20.11 or newer
  • an MCP clientClaude, or any other
  • a Solana RPC URLfree tier is enough
  • SOL for fees~0.05 SOL
  • USDG to deposita few USDG
  1. 1 Make an agent key

    A fresh Solana key, just for the agent. It pays the fees, and the private account is derived from it. Whoever has this file has the money in the account, and if you lose it, the money is gone. Back it up.

    any terminal (macOS, Linux, Windows PowerShell)
    node -e "const c=require('crypto'),fs=require('fs'),p=require('path');const k=c.generateKeyPairSync('ed25519');const f=p.join(require('os').homedir(),'.h081','agent.json');fs.mkdirSync(p.dirname(f),{recursive:true});fs.writeFileSync(f,JSON.stringify([...k.privateKey.export({format:'der',type:'pkcs8'}).subarray(-32),...k.publicKey.export({format:'der',type:'spki'}).subarray(-32)]),{flag:'wx',mode:0o600});console.log('agent key saved to '+f)"

    It saves the key to ~/.h081/agent.json and refuses to overwrite an existing one. With the Solana CLI installed, this does the same: solana-keygen new --no-bip39-passphrase -o ~/.h081/agent.json

  2. 2 Find its address

    This reads mainnet and prints the agent's address on the "signer" line, with the bank's live limits and fees. It signs nothing.

    macOS / Linux
    H081_SOLANA_KEYPAIR=~/.h081/agent.json npx -y @h081lll/mcp info
    Windows PowerShell
    $env:H081_SOLANA_KEYPAIR="$env:USERPROFILE\.h081\agent.json"; npx -y @h081lll/mcp info
  3. 3 Fund it

    Send about 0.05 SOL to that address. Then swap a little SOL for USDG on Jupiter, sending it to the agent, or send USDG you already hold. 0.1 SOL buys about 9 USDG at today's prices.

    USDG mint: 2u1tszSeqZ3qBWF3uNGPFc8TzMk2tdiwknnRMWGWjGWH (Global Dollar, Token-2022, 6 decimals). Check the mint before you send.

  4. 4 Add the server to your agent

    Put your RPC URL in place of https://YOUR-RPC-URL.

    Claude Code · macOS / Linux
    claude mcp add h081 \
      -e H081_SOLANA_KEYPAIR=$HOME/.h081/agent.json \
      -e H081_RPC_URL=https://YOUR-RPC-URL \
      -- npx -y @h081lll/mcp
    Claude Code · Windows PowerShell
    claude mcp add h081 -e H081_SOLANA_KEYPAIR=$env:USERPROFILE\.h081\agent.json -e H081_RPC_URL=https://YOUR-RPC-URL -- cmd /c npx -y @h081lll/mcp
    Claude Desktop or another MCP client

    In Claude Desktop, open Settings › Developer › Edit Config and add this to claude_desktop_config.json, then restart Claude. Other MCP clients take the same command, arguments and environment.

    claude_desktop_config.json
    {
      "mcpServers": {
        "h081": {
          "command": "npx",
          "args": ["-y", "@h081lll/mcp"],
          "env": {
            "H081_SOLANA_KEYPAIR": "/full/path/to/.h081/agent.json",
            "H081_RPC_URL": "https://YOUR-RPC-URL"
          }
        }
      }
    }
  5. 5 Ask your agent

    Start a new session and paste this:

    prompt
    Show me the H081 protocol info. Then deposit 5 USDG into my bank account, show my balance, and withdraw 2 USDG back to my wallet.

    The first deposit downloads the proof files, makes a zero-knowledge proof on your machine (about a second) and sends a few transactions. The withdrawal goes through our relayer and pays its fee to the protocol treasury: 0.20% or 0.05 USDG, whichever is more. So withdrawing 2 USDG pays 0.05 USDG.

What just happened

The deposit is public: anyone can see the agent's wallet put 5 USDG in. After that, the balance is private. Only the agent's key can read it.

The withdrawal was sent by the relayer, not by your agent. The chain shows who received 2 USDG, but not which account it came from. Every step is checked on chain by the bank's programs; you can watch them on the Proof page.

The seven tools
  • h081_bank_depositwallet → shielded account
  • h081_bank_withdrawshielded → any wallet
  • h081_bank_balanceprivate balance, caps
  • h081_loan_quoteprice a loan
  • h081_loan_borrowpledge a stream
  • h081_stakeH081 capacity stake
  • h081_protocol_infoprograms, caps, fees

The agent picks the tool. Amounts can be given in USDG, like "12.5".

Limits

  • Deposits: at most 1,000 USDG each, and 10,000 USDG in the whole bank for now.
  • Relayed withdrawals: up to 100 USDG each with nothing staked. A larger one needs H081 staked for relayer capacity (h081_stake), or can be sent directly with no fee, but then your agent's wallet shows up on chain as the sender.
  • The server needs the raw key file. Hardware wallets and signing services are not supported.

Next

  • Loans. Your agent can pledge a streamed allowance to a lender and borrow against it with h081_loan_quote and h081_loan_borrow. Lenders open a loan in the app under Loans.
  • Solana Agent Kit. The same bank as a plugin: @h081lll/solana-agent-kit-plugin.
  • Every option. Environment variables, the raw JSON-RPC session and the privacy details are in the MCP server's README. The code is open on GitHub.
  • No code at all. Use the bank from a browser wallet in the app, or try it with no money in practice mode.

H081 Capital is live on Solana mainnet and has not been audited yet. Bugs can lose funds, and the team holds the upgrade key. Use a dedicated low-balance key. Nothing here is investment advice.