Privy Server

npm version License: MIT

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:

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

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

{
  "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

Available Tools

Wallet Management

Ethereum Operations

Solana Operations

Policies (Access Control)

Key Quorums (Multi-sig)

Transactions

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

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.