Skip to main content
Glama
Privy MCP Server
by privy-io

Privy MCP 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

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

Related MCP server: AgentWallet MCP Server

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

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

Contributing

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

License

MIT - see LICENSE for details.

Available Tools

24 tools
add_rule_to_policyC

Adds a new rule to an existing policy.

Inputs: name (required), action (required), method (required), policy_id (required), +1 more.

create_policyB

Create a new wallet policy with rules governing transaction behavior.

Inputs: name (required), rules (required), chain_type (required).

create_walletB

Creates a new app-owned wallet. App-owned wallets are fully managed by your Privy app.

Inputs: chain_type, policy_ids.

delete_policyB

Deletes a policy by its ID.

Inputs: policy_id (required).

delete_policy_ruleB

Deletes a specific rule from a policy.

Inputs: rule_id (required), policy_id (required).

eth_sendTransactionB

Sign and broadcast a transaction to the blockchain network.

Inputs: caip2 (required), walletId (required), transaction (required), sponsor, +1 more.

eth_signTransactionC

Sign a transaction using the eth_signTransaction method with a specified wallet.

Inputs: walletId (required), transaction (required).

eth_signTypedData_v4C

Sign EIP-712 typed data using eth_signTypedData_v4 method.

Inputs: walletId (required), typed_data (required).

get_policyA

Retrieves a policy by its ID.

Inputs: policy_id (required).

get_policy_ruleB

Retrieves a specific rule from a policy.

Inputs: rule_id (required), policy_id (required).

get_transactionB

Retrieves transaction details by transaction ID.

Inputs: transaction_id (required).

get_wallet_balanceA

Retrieves the balance of a wallet for a specific asset and chain.

Inputs: asset (required), chain (required), walletId (required), includeCurrency.

get_wallet_detailsB

Retrieves details for a specific wallet by its ID.

Inputs: walletId (required).

get_walletsB

Retrieves a list of wallets associated with the Privy application.

Inputs: limit, chain_type.

get_wallet_transactionsC

Retrieves transaction history for a specific wallet.

Inputs: asset (required), chain (required), walletId (required), limit, +1 more.

personal_signB

Sign a message using the personal_sign method with a specified wallet.

Inputs: message (required), walletId (required), encoding.

raw_signA

Sign a raw hash using the wallet's private key along the blockchain's cryptographic curve.

Inputs: hash (required), walletId (required).

secp256k1_signC

Sign a hash using the secp256k1 method.

Inputs: hash (required), walletId (required).

solana_signAndSendTransactionC

Sign and broadcast a transaction with a Solana wallet.

Inputs: caip2 (required), walletId (required), transaction (required), sponsor, +1 more.

solana_signMessageC

Sign a message with a Solana wallet.

Inputs: message (required), walletId (required), encoding.

solana_signTransactionA

Sign a transaction with a Solana wallet without broadcasting it.

Inputs: walletId (required), transaction (required), encoding.

update_policyB

Updates an existing policy by its ID.

Inputs: policy_id (required), name, rules.

update_policy_ruleB

Updates an existing rule within a policy.

Inputs: name (required), action (required), method (required), rule_id (required), +2 more.

update_walletC

Updates a wallet's policies.

Inputs: walletId (required), policyIds.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 24 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: wallet CRUD, different signing methods (Ethereum vs Solana, various formats), policy management, and transaction retrieval. No two tools overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (e.g., create_wallet, delete_policy_rule). Even longer names like solana_signAndSendTransaction adhere to this convention without mixing styles.

    Tool Count4/5

    With 24 tools, the server is on the upper end of the 'heavy' range, but each tool serves a specific need in wallet management, multi-chain signing, and policy administration. No obvious redundancy or bloat.

    Completeness3/5

    The tool set covers wallet CRUD (except deletion), extensive signing operations, and full policy lifecycle management. The absence of a delete_wallet tool is a notable gap, though other core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Provides permissionless wallet infrastructure for AI agents to manage wallets, sign transactions, and handle tokens across Solana and all EVM-compatible chains. It includes 29 specialized tools for on-chain operations, featuring built-in security guards and automated x402 payment processing without KYC requirements.
      40
      1,180 npm
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to check balances and send transactions across multiple blockchains with automatic spending limit protection and policy enforcement.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to perform blockchain operations like wallet management, token info, DeFi swaps, cross-chain bridging, and price checking across Ethereum, BNB Chain, and Solana.
      ISC