Analytics agents¶

Every Tinybird workspace is a fully managed remote MCP server you can instantly connect to LLMs, agents and other MCP clients such as Cursor, Windsurf or Claude.

The Tinybird remote MCP server enables AI agents to connect directly to your workspace to use endpoints as tools or execute queries. The Model Context Protocol gives AI assistants access to your analytics APIs, data sources, and endpoints through a standardized interface.

This integration is ideal when you want AI agents to autonomously query your data, call your analytics endpoints, or build data-driven applications without requiring manual API integration.

Before you start¶

Before connecting to the Tinybird MCP server, ensure:

• You have a Tinybird account and workspace
• Find your Auth Token with appropriate scopes for your use case. Details below.
• Your MCP client supports either Streamable HTTP or can use the mcp-remote bridge

Authentication and Token Requirements¶

You'll need an Auth Token with the following scopes depending on which tools you want to access:

Static tokens

Use the admin token to access to all available tools or resource-scoped tokens for granular access to endpoint tools.

Copy your static tokens from the dashboard

JSON Web tokens (JWTs)

Use them to have granular access to endpoint tools, multi-tenancy, concurrency control and more.

Quickstart¶

Get a token and use this URL in your MCP client or agent framework:

https://mcp.tinybird.co?token=TINYBIRD_TOKEN

Replace TINYBIRD_TOKEN with your actual Auth Token. Use resource-scoped static tokens or JWTs for fine-grained access control.

MCP Clients Requiring Bridge (Cursor, Windsurf, Claude Desktop)¶

For clients that don't support Streamable HTTP natively:

// Get your TINYBIRD_TOKEN from https://cloud.tinybird.co/tokens
{
  "mcpServers": {
    "tinybird": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tinybird.co?token=TINYBIRD_TOKEN"
      ]
    }
  }
}

See also¶

• Learn about the MCP server tools
• Check some example snippets
• Learn about best practices to use MCP server for analytics agents.