---
name: phantom-wallet-mcp
description: >
  Execute wallet operations through the Phantom MCP server. Use when the user
  wants to interact with their Phantom wallet directly — get addresses, transfer
  SOL or SPL tokens, buy/swap tokens, sign transactions, and sign messages across
  Solana, Ethereum, Bitcoin, and Sui. Requires the @phantom/mcp-server to be
  configured as an MCP server.
license: MIT
metadata:
  author: phantom
  version: "1.0"
  homepage: https://github.com/phantom/phantom-connect-cursor-plugin
---

# Phantom Wallet MCP

Use the `phantom` MCP server to interact with the user's Phantom wallet directly — no SDK integration code needed.

## Setup

Add the Phantom MCP server to your MCP configuration:

```json
{
  "mcpServers": {
    "phantom": {
      "command": "npx",
      "args": ["-y", "@phantom/mcp-server"],
      "env": {
        "PHANTOM_APP_ID": "<your-app-id>"
      }
    }
  }
}
```

Get your `PHANTOM_APP_ID` from [Phantom Portal](https://portal.phantom.com). On first use, the server opens a browser for OAuth authentication via Google or Apple login.

## Available Tools

| Tool | Description |
|------|-------------|
| `get_wallet_addresses` | Get blockchain addresses (Solana, Ethereum, Bitcoin, Sui) for the connected wallet |
| `transfer_tokens` | Transfer SOL or SPL tokens on Solana — builds, signs, and sends the transaction |
| `buy_token` | Fetch Solana swap quotes from Phantom API; optionally sign and send |
| `sign_transaction` | Sign a transaction (base64url for Solana, RLP hex for Ethereum) |
| `sign_message` | Sign a UTF-8 message with automatic chain-specific routing |

## Supported Networks

| Chain | Networks | CAIP-2 Examples |
|-------|----------|-----------------|
| Solana | mainnet, devnet, testnet | `solana:mainnet`, `solana:devnet` |
| Ethereum | Mainnet, Sepolia, Polygon, Base, Arbitrum | `eip155:1`, `eip155:137` |
| Bitcoin | Mainnet | `bip122:000000000019d6689c085ae165831e93` |
| Sui | Mainnet, Testnet | `sui:mainnet` |

## Examples

### Get wallet addresses

Retrieve the user's wallet addresses across all supported chains:

```
Use the phantom MCP's get_wallet_addresses tool to list the user's addresses.
```

Returns addresses for each connected chain (Solana, Ethereum, Bitcoin, Sui).

### Transfer SOL

Send SOL to a recipient address:

```
Use the phantom MCP's transfer_tokens tool:
- token: "SOL"
- recipientAddress: "<recipient>"
- amount: "0.1"
- network: "solana:mainnet"
```

The MCP handles transaction building, signing, and submission.

### Transfer SPL tokens

Send any SPL token by its mint address:

```
Use the phantom MCP's transfer_tokens tool:
- token: "<token-mint-address>"
- recipientAddress: "<recipient>"
- amount: "10"
- network: "solana:mainnet"
```

### Buy / swap tokens

Get a swap quote and optionally execute it:

```
Use the phantom MCP's buy_token tool:
- tokenMint: "<token-mint-to-buy>"
- amount: "1000000"  (in lamports for SOL input)
- network: "solana:mainnet"
```

### Sign a message

Sign a UTF-8 message for verification or authentication:

```
Use the phantom MCP's sign_message tool:
- message: "Hello, verifying ownership"
- network: "solana:mainnet"
```

The MCP routes to the correct chain-specific signing based on the network parameter.

## Important Notes

- **Preview software** — use a separate wallet with minimal funds for testing
- Sessions persist locally in `~/.phantom-mcp/session.json`
- The MCP server runs via stdio transport (launched by `npx -y @phantom/mcp-server`)
- Token transfers on Solana support both native SOL and any SPL token
- Swap quotes come from Phantom's API and include fee and slippage info