Privy MCP Server

Give your AI agent a wallet with Privy. This MCP (Model Context Protocol) server enables Claude and other AI assistants to create wallets, sign transactions, and manage blockchain operations.

Installation

Option 1: npx (Recommended)

Run directly without installation:

npx @privy-io/mcp-server

Option 2: Global Install

npm install -g @privy-io/mcp-server
privy-mcp-server

Option 3: From Source

git clone https://github.com/privy-io/privy-mcp-server.git
cd privy-mcp-server
npm install && npm run build

Quick Start

1. Get Your Credentials

From the Privy Dashboard:

• App ID & Secret: Settings → Basics

2. Configure Your MCP Client

Add to your MCP client configuration:

Claude Desktop (~/.config/claude/claude_desktop_config.json)

{
  "mcpServers": {
    "privy": {
      "command": "npx",
      "args": ["@privy-io/mcp-server"],
      "env": {
        "PRIVY_APP_ID": "your-app-id",
        "PRIVY_APP_SECRET": "your-app-secret"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "privy": {
      "command": "npx",
      "args": ["@privy-io/mcp-server"],
      "env": {
        "PRIVY_APP_ID": "your-app-id",
        "PRIVY_APP_SECRET": "your-app-secret"
      }
    }
  }
}

Claude Code (project .mcp.json)

{
  "privy": {
    "command": "npx",
    "args": ["@privy-io/mcp-server"],
    "env": {
      "PRIVY_APP_ID": "your-app-id",
      "PRIVY_APP_SECRET": "your-app-secret"
    }
  }
}

3. Start Using!

Ask Claude to create a wallet:

"Create an Ethereum wallet for me"

Supported Chains

Chain	Type	Status
Ethereum (+ all EVM)	ethereum	✅ Full support
Solana	solana	✅ Full support
Cosmos	cosmos	✅ Supported
Stellar	stellar	✅ Supported
Sui	sui	✅ Supported
Aptos	aptos	✅ Supported
Tron	tron	✅ Supported
Bitcoin (SegWit)	bitcoin-segwit	✅ Supported
Near	near	✅ Supported
TON	ton	✅ Supported
Starknet	starknet	✅ Supported

Available Tools

Wallet Management

Tool	Description
create_wallet	Create a new wallet on any supported chain
get_wallet_details	Get wallet info by ID
get_wallets	List all wallets
get_wallet_balance	Check balance (ETH, USDC, etc.)
get_wallet_transactions	Get transaction history
update_wallet	Update wallet policies

Ethereum Operations

Tool	Description
eth_sendTransaction	Sign and broadcast (supports gas sponsorship)
personal_sign	Sign a message (EIP-191)
eth_signTransaction	Sign without broadcasting
eth_signTypedData_v4	Sign EIP-712 typed data
secp256k1_sign	Sign a hash directly
raw_sign	Sign raw data

Solana Operations

Tool	Description
solana_signAndSendTransaction	Sign and broadcast
solana_signMessage	Sign a message
solana_signTransaction	Sign without broadcasting

Policies (Access Control)

Tool	Description
create_policy	Create transaction policies
get_policy / update_policy / delete_policy	Manage policies
add_rule_to_policy	Add rules to control transactions
get_policy_rule / update_policy_rule / delete_policy_rule	Manage rules

Key Quorums (Multi-sig)

Tool	Description
create_key_quorum	Create a key quorum for multi-sig
get_key_quorum / update_key_quorum / delete_key_quorum	Manage quorums

Transactions

Tool	Description
get_transaction	Get transaction details by ID

Example Conversations

You: Create a wallet and check its balance

Claude: I'll create an Ethereum wallet and check the balance.
🔧 create_wallet → { id: "wallet-abc", address: "0x742d35Cc..." }
🔧 get_wallet_balance → { balance: "0 ETH" }

Done! Your wallet 0x742d35Cc... has been created with 0 ETH.

You: Send 0.01 ETH to 0x123... on Base

Claude: I'll send 0.01 ETH to that address on Base.
🔧 eth_sendTransaction → { hash: "0xabc123...", status: "pending" }

Transaction submitted! Hash: 0xabc123...

Environment Variables

Variable	Required	Description
PRIVY_APP_ID	Yes	Your Privy App ID
PRIVY_APP_SECRET	Yes	Your Privy App Secret
PRIVY_AUTHORIZATION_PRIVATE_KEY	No	For signing ops on owner-controlled wallets
PRIVY_API_BASE_URL	No	Custom API URL (default: https://api.privy.io/v1)

Testing

Use the MCP Inspector to test tools interactively:

npm run inspector

Security Best Practices

• Never commit credentials - Use environment variables
• Use policies to restrict what transactions your agent can execute
• Set up key quorums for high-value operations requiring multiple approvals
• Monitor transactions via Privy Dashboard webhooks

Resources

• Privy Documentation
• Agentic Wallets Guide
• Privy Dashboard
• MCP Protocol Specification

Contributing

Contributions welcome! Please read our contributing guidelines and submit PRs to the main branch.

License

MIT - see LICENSE for details.