fireblocks-mcp

🔥 Fireblocks MCP Server

A comprehensive Model Context Protocol (MCP) server for Fireblocks digital asset platform integration

Connect your AI assistants (Claude, Cursor) directly to Fireblocks APIs for seamless digital asset management, transaction processing, and wallet operations.

🚀 Quick Start

Installation

# Install globally via npm
npm install -g fireblocks-mcp

# Or run directly with npx
npx fireblocks-mcp

Basic Configuration

• Get your Fireblocks API credentials from the Fireblocks Console
• Configure your AI client (see Client Setup below)
• Start using Fireblocks tools in your AI conversations!

✨ Features

🏦 Vault Management Create & manage vault accounts Activate assets for vaults Balance monitoring & refresh Vault account lifecycle control 💸 Transaction Operations Create transfers, mints, burns Transaction status tracking Fee estimation & optimization Transaction history & filtering 📍 Address Management Generate deposit addresses Address validation & verification Multi-asset address support

💰 Asset Management 500+ supported cryptocurrencies Real-time balance tracking Asset activation & management Spendable amount calculations 👛 Wallet Integration External wallet management Multi-asset wallet support Wallet-to-vault connections 👥 User Administration User listing & management Role & permission tracking Workspace user overview

📋 Prerequisites

• Fireblocks Account with API access
• AI Client (Claude Desktop or Cursor)
• Node.js 16+ (automatically handled by npx)

🚀 Installation & Configuration

Step 1: Get Your Fireblocks API Credentials

• Login to Fireblocks Console
• Navigate to Settings → API Users
• Create a new API user (or use existing)
• Download the private key file
• Copy the API Key from the console

Step 2: Configure Your AI Client

Choose your preferred AI client and follow the setup instructions:

🎯 Claude Desktop Setup

1. Locate your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the Fireblocks MCP server configuration:

{
  "mcpServers": {
    "fireblocks": {
      "command": "npx",
      "args": ["fireblocks-mcp"],
      "env": {
        "FIREBLOCKS_API_KEY": "your_api_key_here",
        "FIREBLOCKS_SECRET_KEY": "-----BEGIN PRIVATE KEY-----\nyour_private_key_content_here\n-----END PRIVATE KEY-----",
        "FIREBLOCKS_BASE_URL": "https://api.fireblocks.io"
      }
    }
  }
}

3. Replace the credentials:

• Replace your_api_key_here with your actual API key
• Replace the private key content with your downloaded private key
• For sandbox testing, use https://sandbox-api.fireblocks.io

4. Restart Claude Desktop

🎯 Cursor Setup

1. Open Cursor Settings:

• Press Cmd/Ctrl + , or go to Cursor → Settings

2. Navigate to MCP Servers:

• Go to Features → MCP Servers
• Click "Add new global MCP server"

3. Add the configuration:

{
  "mcpServers": {
    "fireblocks-mcp": {
      "command": "npx", 
      "args": ["fireblocks-mcp"],
      "env": {
        "FIREBLOCKS_API_KEY": "your_api_key_here",
        "FIREBLOCKS_SECRET_KEY": "-----BEGIN PRIVATE KEY-----\nyour_private_key_content_here\n-----END PRIVATE KEY-----",
        "FIREBLOCKS_BASE_URL": "https://api.fireblocks.io"
      }
    }
  }
}

4. Replace the credentials:

• Replace your_api_key_here with your actual API key
• Replace the private key content with your downloaded private key
• For sandbox testing, use https://sandbox-api.fireblocks.io

5. Save and restart Cursor

🔧 Alternative Installation Methods

Manual Installation (Advanced Users)

Global NPM Installation

npm install -g fireblocks-mcp
fireblocks-mcp

From Source

git clone https://github.com/nitaiaharoni1/fireblocks-mcp.git
cd fireblocks-mcp
npm install && npm run build
npm start

Environment File Setup (Optional)

cp env.example .env
# Edit .env with your credentials

✅ That's it! The npx fireblocks-mcp command automatically downloads and runs the latest version - no manual installation required!

🎉 You're Ready!

Once configured, you can start using Fireblocks tools directly in your AI conversations:

• "List my vault accounts"
• "Create a new vault account called 'Trading'"
• "Show me the BTC balance in vault 1"
• "Create a transfer of 0.1 BTC from vault 1 to vault 2"
• "Get all supported assets"

🛠️ Available Tools

🏦 Vault Management

• list_vault_accounts - List all vault accounts with filtering
• create_vault_account - Create new vault accounts
• rename_vault_account - Rename existing vault accounts
• hide_vault_account - Hide/unhide vault accounts from UI
• activate_asset_for_vault - Activate assets for vault accounts

💰 Asset Management

• get_supported_assets - Get all 500+ supported cryptocurrencies
• get_vault_asset_balance - Check asset balances in vaults
• refresh_vault_asset_balance - Refresh asset balance data
• get_max_spendable_amount - Calculate maximum spendable amounts

💸 Transaction Operations

• create_transaction - Create transfers, mints, burns, and more
• list_transactions - List and filter transaction history
• get_transaction_by_id - Get detailed transaction information
• estimate_transaction_fee - Estimate network and gas fees
• cancel_transaction - Cancel pending transactions
• freeze_transaction - Freeze/unfreeze transactions

📍 Address Management

• create_vault_asset_address - Generate new deposit addresses
• list_vault_asset_addresses - List all addresses for vault assets
• validate_address - Validate blockchain addresses

👛 Wallet Integration

• create_external_wallet - Create external wallet connections
• list_external_wallets - List all external wallets
• add_asset_to_external_wallet - Add assets to external wallets
• delete_external_wallet - Remove external wallet connections

👥 User Management

• list_users - Get all workspace users and their roles

📖 Detailed Tool Documentation

Example Usage

Create a Vault Account

create_vault_account({
  "name": "Trading Vault",
  "autoFuel": true
})

Transfer Bitcoin

create_transaction({
  "operation": "TRANSFER",
  "source": {"type": "VAULT_ACCOUNT", "id": "1"},
  "destination": {"type": "VAULT_ACCOUNT", "id": "2"},
  "assetId": "BTC",
  "amount": "0.1"
})

Check Balance

get_vault_asset_balance({
  "vaultAccountId": "1",
  "assetId": "BTC"
})

🔒 Security & Best Practices

• 🔐 Keep credentials secure - Never commit private keys to version control
• 🧪 Use sandbox for testing - Set FIREBLOCKS_BASE_URL=https://sandbox-api.fireblocks.io
• 📊 Monitor API usage - Track your API calls and set appropriate limits
• 🛡️ Implement access controls - Use proper permissions in your Fireblocks workspace

📚 Resources

• Fireblocks API Documentation - Official API reference
• Fireblocks Console - Manage your account and API keys
• GitHub Issues - Report bugs and request features
• NPM Package - View package details

🤝 Contributing

We welcome contributions! Please:

• Fork the repository
• Create a feature branch
• Add tests for new functionality
• Submit a pull request

📄 License

MIT License - see LICENSE file for details.

⚠️ Disclaimer

This is an unofficial MCP server for Fireblocks. Not affiliated with or endorsed by Fireblocks Ltd.

Use at your own risk and ensure you understand the implications of all operations.