Fireblocks MCP Server

A Model Context Protocol (MCP) server implementation for the Fireblocks API, enabling AI assistants to interact with Fireblocks services through a standardized protocol.

Overview

This MCP server provides secure access to Fireblocks functionality, allowing AI assistants to:

• Query and create transactions
• Retrieve and manage vault accounts and assets
• Access exchange account information
• Query network connections and policies
• Query blockchain information and whitelisted IP addresses
• Query external and internal wallets
• Query and filter workspace users

Prerequisites

Node.js (v18 or higher) - Download here

Installation

Step 1: Create an API key

To get started, you’ll need a Fireblocks API Key and its corresponding secret key file.

1. Follow the Fireblocks guide on creating an API key.

🔒 Security Note: When configuring an API user for the MCP server, it is critical to grant only the minimum permissions required for its specific tasks. For example, for read-only tasks like viewing transaction history, the “Viewer” role is the most secure option. For a detailed guide on user roles, please refer to the best practices for choosing user roles.

2. Once created, securely store both the API Key and the secret key file (e.g., fireblocks-secret.key). You will need both for the next steps.

Step 2: Configure your MCP Client

For Claude Desktop

1. Open Claude Desktop.
2. Go to Settings → Developer → Edit Config to open the claude_desktop_config.json file.
3. Add a new server with this configuration:

{
  "mcpServers": {
    "fireblocks": {
      "command": "npx",
      "args": ["@fireblocks/mcp-server"],
      "env": {
        "FIREBLOCKS_API_KEY": "your-api-key",
        "FIREBLOCKS_PRIVATE_KEY_PATH": "your-fireblocks-api-secret-key-filepath",
        "ENABLE_WRITE_OPERATIONS": "false",
        "FIREBLOCKS_API_BASE_URL": "https://api.fireblocks.io/v1"
      }
    }
  }
}

For Cursor

1. Open Cursor.
2. Go to Settings → Cursor Settings → Tools & Integrations.
3. Select MCP Tools and click Add Custom MCP to open the mcp.json file.
4. Add a new server with this configuration:

{
  "mcpServers": {
    "fireblocks": {
      "command": "npx",
      "args": ["@fireblocks/mcp-server"],
      "env": {
        "FIREBLOCKS_API_KEY": "your-api-key",
        "FIREBLOCKS_PRIVATE_KEY_PATH": "your-fireblocks-api-secret-key-filepath",