# Agent Wallet MCP

**Give Claude a Solana wallet.**

An MCP (Model Context Protocol) server that lets Claude send USDC, check balances, and manage transactions on Solana.

## Demo

```
You: "What's my wallet balance?"

Claude: Let me check your wallet balance.

        {
          "sol": 1.5,
          "usdc": 25.00,
          "network": "devnet",
          "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
        }

You: "Send $5 USDC to [address] for the API calls I just used"

Claude: I'll send 5 USDC to that address now.

        {
          "success": true,
          "signature": "5UfgJ3...",
          "recipient": "...",
          "amount": 5,
          "explorer": "https://explorer.solana.com/tx/..."
        }

        Done! Transaction confirmed on Solana devnet.
```

## Installation

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

# Install dependencies
npm install

# Build
npm run build
```

## Setup with Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

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

Then restart Claude Desktop.

## Available Tools

| Tool | Description |
|------|-------------|
| `get_wallet_address` | Get the agent's Solana wallet address |
| `get_balance` | Check USDC and SOL balance |
| `send_usdc` | Send USDC to another address |
| `get_recent_transactions` | View recent transaction history |
| `request_devnet_airdrop` | Get free devnet SOL for fees |

## How It Works

1. **Persistent Wallet**: Creates a keypair stored at `~/.agent-wallet/keypair.json`
2. **Devnet Only**: All transactions happen on Solana devnet (test network)
3. **Real Transactions**: These are actual blockchain transactions, just on testnet

## Getting Devnet USDC

The wallet starts empty. To test sending USDC:

1. Get your wallet address: Ask Claude "What's my wallet address?"
2. Get devnet SOL: Ask Claude "Request a devnet airdrop"
3. Get devnet USDC from [Circle's faucet](https://faucet.circle.com/) or [Solana faucet](https://solfaucet.com/)

## Development

```bash
# Watch mode
npm run dev

# Test with MCP Inspector
npm run inspector
```

## Why This Exists

AI agents will eventually need to pay for things - API calls, compute, services from other agents.

This is a simple demo of what that looks like: Claude with a wallet, making real (testnet) transactions.

## Security Notes

- **Devnet only** - No real money involved
- **Local keypair** - Private key never leaves your machine
- **No mainnet support** - Intentionally limited to devnet for safety

## License

MIT