Skip to main content
Connect Flipside’s blockchain data to your AI assistant using the Model Context Protocol (MCP).

​
Prerequisites

Before setting up the MCP server, you’ll need:
  • A Flipside API key (Get your API key)
  • One of the supported applications: Claude Desktop, Claude Code, or Cursor

​
Getting Your API Key

  1. Visit Flipspace Settings → API Keys
  2. Sign in or create an account
  3. Generate a new API key (it will start with fv_)
  4. Copy the key for use in the configuration below
Keep your API key secure. Never commit it to version control or share it publicly. If your key is compromised, revoke it immediately and generate a new one.

​
Configuration

​
Option 1: CLI Command

Run this command in your terminal (must be on a single line):
claude mcp add flipside -- npx mcp-remote https://mcp.flipsidecrypto.xyz/mcp --header "x-api-key:YOUR_API_KEY"
Replace YOUR_API_KEY with your actual Flipside API key (starts with fv_).
When pasting this command, ensure it stays on a single line. If the terminal breaks the line, the command will fail. Use the settings file method below instead.
To remove or update the server, use claude mcp remove flipside or edit your settings file directly.

​
Option 2: Edit Settings File

1

Open Claude Code Settings

You can configure the MCP at either:
  • Project-level: Create or edit .claude/settings.json in your project root
  • User-level: Edit ~/.claude/settings.json for MCPs you want everywhere
2

Add MCP Configuration

Add the following configuration to your settings file:
{
  "mcpServers": {
    "flipside": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.flipsidecrypto.xyz/mcp",
        "--header",
        "x-api-key:YOUR_API_KEY"
      ]
    }
  }
}
Replace YOUR_API_KEY with your actual Flipside API key (starts with fv_).
3

Restart Claude Code

Restart Claude Code to apply the changes. You can verify by running /mcp to see connected servers.

​
Verifying Your Setup

After configuring the MCP server, verify it’s working:
  1. In Claude Code: Run /mcp to see connected servers, then ask “What Flipside tools do you have access to?”
  2. In Claude Desktop: Start a new conversation and ask “Can you query Flipside blockchain data?”
  3. In Cursor: The MCP server should appear in your available tools when working with code.

​
Troubleshooting

  • Verify your API key is correct and active
  • Check that the configuration JSON is valid (no syntax errors)
  • Ensure you’ve restarted the application after making changes
  • Check the application’s logs for error messages
  • Verify your internet connection - Ensure your API key hasn’t been revoked or expired - Try regenerating your API key if issues persist
  • For Claude Desktop: Use the “Edit Config” button in Settings → Developer - For Cursor: The config file may need to be created manually in the globalStorage directory - Ensure you have write permissions to the configuration directory
The mcp-remote package requires Node.js 18 or later. Check your version:
node --version
If you’re using nvm and have an old default, update it:
nvm alias default 20

​
Next Steps

SQL Queries

Learn how to query blockchain data

Table Discovery

Find the right tables for your analysis