Skip to main content
The Flipside MCP (Model Context Protocol) server lets you access Flipside blockchain data directly from Claude Desktop, Claude Code, and Cursor. Once configured, you can query Flipside data without leaving your development environment.

​
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

​
Configuration

The setup process varies slightly by application. Select your platform below:
1

Open Claude Desktop

Launch the Claude Desktop application on your computer.
2

Access Settings

Click on your profile icon and select Settings.
3

Navigate to Developer

Click on the Developer tab in the settings sidebar.
4

Open Config File

Click Edit Config. This will open the folder where the claude_desktop_config.json file is located.
5

Edit Configuration

Open the claude_desktop_config.json file in a text editor. Add the following configuration to your mcpServers section:
"flipside": {
  "type": "http",
  "url": "https://mcp.flipsidecrypto.xyz/mcp?apiKey=API_KEY"
}
Replace API_KEY with your actual Flipside API key.
6

Save and Restart

Save the file and restart Claude Desktop to apply the changes.
Your claude_desktop_config.json file should have a structure like this:
{
  "mcpServers": {
    "flipside": {
      "type": "http",
      "url": "https://mcp.flipsidecrypto.xyz/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

​
Verifying Your Setup

After configuring the MCP server, you can verify it’s working by:
  1. In Claude Desktop: Start a new conversation and ask about Flipside data. The MCP server should be available as a tool.
  2. In Claude Code: Use the MCP tools in your code editor to query Flipside data.
  3. In Cursor: The MCP server should appear in your available tools when working with code.

​
Getting Your API Key

If you don’t have a Flipside API key yet:
  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 and use it in your MCP configuration
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.

​
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 - Check that the URL is correct: https://mcp.flipsidecrypto.xyz/mcp?apiKey=YOUR_KEY - 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

​
What You Can Do with MCP

Once connected, you can:
  • Query Flipside blockchain data directly from your editor
  • Access data across 30+ networks and 7+ trillion data points
  • Get real-time blockchain intelligence without switching applications
  • Integrate Flipside data into your development workflow

​
Next Steps

Get your API key

Generate a Flipside API key to get started

Explore FlipsideAI

Learn how to use FlipsideAI in the web interface

API Documentation

Explore the full Flipside API reference

Troubleshooting

Get help with common issues