Agent Wallet

Provides a Solana devnet wallet that can check balances, transfer USDC, and manage transactions for testing with Claude.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "noah-ing-agent-wallet-mcp": {
      "command": "node",
      "args": [
        "/path/to/agent-wallet-mcp/dist/index.js"
      ]
    }
  }
}

You can run an MCP server that lets Claude interact with a Solana wallet on devnet. It enables you to check balances, transfer USDC, view recent transactions, and manage devnet funds in a safe, test-only environment. This practical setup is designed for experimentation and learning how automated agents can perform real blockchain actions without risking mainnet assets.

How to use

You communicate with the MCP server through your MCP client to perform wallet actions. Start by checking balances to confirm SOL and USDC are available in the devnet wallet. Then you can request a devnet SOL airdrop to cover transaction fees, obtain your wallet address, and send USDC to another address. You can also review recent transactions to verify activity and confirm successful transfers.

Practical usage patterns include: asking for your wallet address, querying your balances, initiating a USDC transfer to a specified address, inspecting recent transactions, and requesting devnet SOL for fees. All actions run on Solana’s devnet to keep testing isolated from real funds.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

# Clone the repository
git clone https://github.com/noah-ing/agent-wallet-mcp.git
cd agent-wallet-mcp

# Install dependencies
npm install

# Build the project
npm run build

Setup with Claude Desktop

{
  "mcpServers": {
    "agent-wallet": {
      "command": "node",
      "args": ["/path/to/agent-wallet-mcp/dist/index.js"]
    }
  }
}

Notes on running and testing

After building, run the server locally and configure Claude Desktop to point to the built index file. The server operates on Solana devnet, and all transactions are test transactions. You can test by requesting a devnet airdrop, obtaining your wallet address, and performing a USDC transfer within the devnet environment.

Additional configuration and security

Security considerations include using a local keypair stored on your machine and restricting activity to the devnet. There is no mainnet support in this demo.

Development and testing commands

# Watch mode for development (if provided by the project)
npm run dev

# Test with MCP Inspector (if provided by the project)
npm run inspector

Available tools

get_wallet_address

Fetch the Solana wallet address managed by the MCP server.

get_balance

Retrieve SOL and USDC balances for the wallet on Solana devnet.

send_usdc

Send a specified amount of USDC to a target Solana address.

get_recent_transactions

List recent transactions associated with the wallet.

request_devnet_airdrop

Request free devnet SOL to cover transaction fees.