Skip to main content
The Flipside MCP (Model Context Protocol) server connects AI assistants like Claude directly to Flipside’s blockchain data. Query blockchain data across 20+ chains without leaving your development environment.

Why Use Flipside MCP?

AI-Native Data Access

Let Claude write SQL, discover tables, and analyze blockchain data through natural conversation

20+ Blockchains

Access data across Ethereum, Solana, Bitcoin, Arbitrum, Base, and more

Cross-Chain Swaps

Execute token swaps across multiple chains directly from your AI assistant

Works Everywhere

Use with Claude Desktop, Claude Code, Cursor, and other MCP-compatible tools

Get Started

Installation Guide

Set up Flipside MCP in Claude Desktop, Claude Code, or Cursor

Key Capabilities

SQL Queries

Execute SQL queries and analyze results with AI assistance

Table Discovery

Find relevant tables using semantic search or name patterns

Automations

Use pre-built analysis automations for common blockchain questions

Cross-Chain Swaps

Get quotes and execute token swaps across multiple chains

Available Tools

The Flipside MCP provides these tools to AI assistants:

Data Querying

ToolDescription
run_queryExecute SQL and wait for results
execute_sqlExecute SQL and save as a named query
get_query_resultsFetch results from a completed query
query_results_with_duckdbAnalyze query results with DuckDB SQL
run_sql_for_downloadExecute SQL and get a download URL

Table Discovery

ToolDescription
find_tablesSemantic search for relevant tables
find_tables_by_nameFind tables by name pattern (regex)
get_table_schemaGet detailed column info for a table

Automations

ToolDescription
find_workflowSearch for pre-built analysis automations
get_workflowGet automation details by ID
plan_workflowGenerate customized steps for an automation

Cross-Chain Swaps

ToolDescription
get_swap_tokensList available tokens for swaps
get_swap_quotePreview pricing for a swap
execute_swapCreate a swap with deposit address
get_swap_statusCheck swap status
submit_deposit_txSpeed up processing with tx hash

Utilities

ToolDescription
search_webSearch the web for information
fetch_web_pageFetch and convert web pages to markdown
publish_htmlPublish HTML dashboards to a public URL

Query Management

ToolDescription
list_queriesList saved queries
list_query_executionsList recent query runs
get_queryGet details of a saved query

Example Conversations

Once connected, you can have conversations like:
You: What were the top 10 NFT collections by volume on Ethereum yesterday? Claude: I’ll query the NFT data for you… [uses find_tables, run_query]
You: Find me tables related to DeFi lending on Arbitrum Claude: Let me search for relevant tables… [uses find_tables]
You: I want to swap 100 USDC from Ethereum to NEAR Claude: I’ll get a quote for that swap… [uses get_swap_quote, execute_swap]

Supported Platforms

PlatformSupport
Claude Desktop✅ Full support
Claude Code✅ Full support
Cursor✅ Full support
Other MCP clients✅ Compatible

Resources

Get API Key

Generate your Flipside API key

Flipspace

Use Flipside’s web interface

CLI

Use the Flipside command-line interface

API Reference

Direct API documentation