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:

hljs language-bash

npx @privy-io/mcp-server

Option 2: Global Install

hljs language-bash

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

Option 3: From Source

hljs language-bash

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)

hljs language-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)

hljs language-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)

hljs language-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

hljs language-vbnet

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.

hljs language-vbnet

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:

hljs language-bash

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

Contributing

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

License

MIT - see LICENSE for details.

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:

hljs language-bash

npx @privy-io/mcp-server

Option 2: Global Install

hljs language-bash

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

Option 3: From Source

hljs language-bash

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)

hljs language-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)

hljs language-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)

hljs language-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

hljs language-vbnet

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.

hljs language-vbnet

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:

hljs language-bash

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

Contributing

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

License

MIT - see LICENSE for details.

privy-mcp-server

Privy MCP Server

Installation

Option 1: npx (Recommended)

Option 2: Global Install

Option 3: From Source

Quick Start

1. Get Your Credentials

2. Configure Your MCP Client

3. Start Using!

Supported Chains

Available Tools

Wallet Management

Ethereum Operations

Solana Operations

Policies (Access Control)

Key Quorums (Multi-sig)

Transactions

Example Conversations

Environment Variables

Testing

Security Best Practices

Resources

Contributing

License

Similar Packages

privy-mcp-server

Privy MCP Server

Installation

Option 1: npx (Recommended)

Option 2: Global Install

Option 3: From Source

Quick Start

1. Get Your Credentials

2. Configure Your MCP Client

3. Start Using!

Supported Chains

Available Tools

Wallet Management

Ethereum Operations

Solana Operations

Policies (Access Control)

Key Quorums (Multi-sig)

Transactions

Example Conversations

Environment Variables

Testing

Security Best Practices

Resources

Contributing

License

Similar Packages