Skip to main content
The Phantom MCP server (@phantom/mcp-server) is a Phantom wallet product for users who interact through AI agents. Just like the mobile wallet and browser extension serve users who click and tap, the MCP server serves users who interact through natural language with their AI assistant. When someone uses Claude, Cursor, or another AI agent and asks “send 10 USDC to my friend” or “swap some SOL for ETH,” Phantom’s MCP server is the wallet the agent uses to act on their behalf.
Always use a separate Phantom account for testing with AI agents. Transactions are irreversible. Never use accounts containing significant assets.

​
What are you here for?

Set up the MCP server

Add the Phantom MCP server to Claude Desktop, Cursor, or Claude Code and get a wallet for your AI agent.

Use it with OpenClaw

Install the Phantom OpenClaw plugin to bring the same Phantom wallet capabilities directly into OpenClaw.

​
Quick install

No App ID or Phantom Portal setup required. Add this config to your AI client: 
{
  "mcpServers": {
    "phantom": {
      "command": "npx",
      "args": ["-y", "@phantom/mcp-server@latest"]
    }
  }
}
On first use, a browser window opens for device-code sign-in. See the setup guide for step-by-step instructions for Claude Desktop, Cursor, and Claude Code.
Agents receive a new dedicated wallet on authentication — not your existing personal wallet. You must fund the agent’s wallet before it can transact. Use get_wallet_addresses to find the address after setup.

​
What agents can do

The MCP server gives agents wallet, swap, and perp-trading tools. See the setup guide and tool reference for full parameter documentation.
No fees on swaps. All swaps executed through buy_token and portfolio_rebalance are fee-free.
Wallet operations
ToolDescription
get_connection_statusCheck if the wallet session is active
get_wallet_addressesGet addresses for Solana, Ethereum, Bitcoin, and Sui
get_token_balancesView token holdings with live USD pricing
transfer_tokensTransfer SOL, ETH, and SPL/ERC-20 tokens with a simulation-first flow
send_solana_transactionSimulate, sign, and broadcast Solana transactions
send_evm_transactionSimulate, sign, and broadcast EVM transactions
sign_solana_messageSign UTF-8 messages on Solana
sign_evm_personal_messageEIP-191 personal message signing
sign_evm_typed_dataEIP-712 structured data signing
simulate_transactionPreview asset changes for a transaction without submitting on-chain
get_token_allowanceCheck ERC-20 token allowance for a spender address
phantom_loginRe-authenticate, switch accounts, or refresh a session
pay_api_accessPay for daily API access when quota is consumed
Swaps and portfolio
ToolDescription
buy_tokenSwap tokens via Phantom routing (Solana, EVM, cross-chain). No fees on swaps.
portfolio_rebalanceAnalyze and rebalance portfolio allocation via token swaps
Perps
ToolDescription
get_perp_marketsList perp markets with price, funding, open interest, and max leverage
get_perp_accountView perp account balance and available margin
get_perp_positionsList open positions, leverage, PnL, and liquidation price
get_perp_ordersList open perp orders
get_perp_trade_historyView historical fills, fees, and closed PnL
deposit_to_hyperliquidBridge/swap into the perp account
open_perp_positionOpen a long or short perp position
close_perp_positionClose a perp position fully or partially
cancel_perp_orderCancel an open perp order
update_perp_leverageUpdate leverage and margin mode
transfer_spot_to_perpsMove USDC from Hypercore spot to perps
withdraw_from_perpsMove USDC from perps back to spot
withdraw_from_hyperliquid_spotWithdraw USDC from Hyperliquid spot to an external chain

Perps tools guide

Hyperliquid-specific funding, trading, and withdrawal flow for the Phantom MCP server.

​
Supported clients

ClientHow to connect
Claude DesktopAdd to claude_desktop_config.json
CursorAdd to ~/.cursor/mcp.json (or use the Phantom Cursor plugin)
Claude Codeclaude mcp add phantom -- npx -y @phantom/mcp-server@latest

​
How agent wallets sign

Agent wallets complete a Phantom Connect sign-in, then use an OIDC stamper to stamp KMS requests. KMS validates the stamp, enforces policy, and then signs and submits.

How Phantom KMS works

Learn how KMS handles key storage and signing for agent wallets.

Phantom Connect SDKs

Build apps with embedded wallets and social login for traditional user flows.

Phantom Connect SDK MCP server

Give your AI coding assistant access to Phantom developer documentation.