3D MCP Cursor Visualization
Tinybird MCP Logo - AI-Powered Development Tool for Cursor IDE

Tinybird MCP

Model Context Protocol Integration

Overview

An MCP server to interact with a Tinybird Workspace from any MCP client. Query data sources, use API endpoints, and push datafiles through natural language interactions.

Tinybird Features

  • Query Tinybird Data Sources using Query API
  • Execute existing Tinybird API Endpoints
  • Push and manage datafiles
  • Support for both SSE and STDIO modes
  • Custom prompt workflows configuration
  • Built-in Tinybird documentation access
  • Performance analysis and optimization suggestions
  • Event tracking and analytics capabilities

Tinybird Setup & Configuration

Requirements

  • Tinybird Account & Workspace
  • Claude Desktop
  • uv package manager
  • Tinybird API URL and Admin Token

Installation Instructions

# Using Smithery (Recommended)
npx @smithery/cli install @tinybirdco/mcp-tinybird --client claude

# Using mcp-get
npx @michaellatman/mcp-get@latest install mcp-tinybird

# SSE Mode
uvx mcp-tinybird sse

Configuration

# Claude Desktop Configuration (MacOS)
~/Library/Application Support/Claude/claude_desktop_config.json

# Claude Desktop Configuration (Windows)
%APPDATA%/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "mcp-tinybird": {
            "command": "uvx",
            "args": [
                "mcp-tinybird",
                "stdio"
            ],
            "env": {
                "TB_API_URL": "<TINYBIRD_API_URL>",
                "TB_ADMIN_TOKEN": "<TINYBIRD_ADMIN_TOKEN>"
            }
        }
    }
}

Tinybird Available Tools

  • list-data-sources
  • list-pipes
  • get-data-source
  • get-pipe
  • request-pipe-data
  • run-select-query
  • append-insight
  • llms-tinybird-docs
  • save-event
  • analyze-pipe
  • push-datafile

Tinybird Required Inputs

TB_API_URL

Type
string
Description
Your Tinybird API URL
Required
Yes

TB_ADMIN_TOKEN

Type
string
Description
Your Tinybird Admin Token
Required
Yes

Tinybird Use Cases

  • Real-time data analytics and querying
  • API endpoint management and monitoring
  • Data source exploration and analysis
  • Performance optimization of data pipelines
  • Custom analytics workflow creation
  • Event tracking and data collection
  • Business intelligence and reporting

Frequently Asked Questions

An MCP server to interact with a Tinybird Workspace from any MCP client. Query data sources, use API endpoints, and push datafiles through natural language interactions.
Tinybird Account & Workspace, Claude Desktop, uv package manager, Tinybird API URL and Admin TokenView detailed requirements
Follow the installation instructions in the setup section above.View installation guide

Tinybird MCP provides the following tools:

  • list-data-sources
  • list-pipes
  • get-data-source
  • get-pipe
  • request-pipe-data
  • run-select-query
  • append-insight
  • llms-tinybird-docs
  • save-event
  • analyze-pipe
  • push-datafile