[01]
[02]
A remote, hosted MCP server that allows your AI agents to connect directly to your Tinybird workspace.
// Get your TB_TOKEN from https://cloud.tinybird.co/tokens
// Configure your client with the Tinybird MCP server URL and a token
{
"mcpServers":{
"tinybird":{
"url":"https://mcp.tinybird.co?token=TB_TOKEN"
}
}
}
from agno.agent import Agent
from agno.models.anthropic import Claude
from agno.tools.mcp import MCPTools
import asyncio
import os
tinybird_api_key = os.getenv("TINYBIRD_TOKEN")
tinybird_host = os.getenv("TINYBIRD_HOST")
async def main():
async with MCPTools(
transport="streamable-http",
url=f"https://mcp.tinybird.co?token={tinybird_api_key}&host={tinybird_host}",
timeout_seconds=120) as mcp_tools:
agent = Agent(model=Claude(id="claude-4-opus-20250514"), tools=[mcp_tools])
await agent.aprint_response("top 5 pages with more visits in the last 24 hours", stream=True)
if __name__ == "__main__":
asyncio.run(main())
MCP never exposes more than the underlying credentials allow.
/ 01
Access Control Built In
Tinybird MCP leverages your existing Tinybird static tokens and JWTs.
/ 02
RBAC for your MCPs
Give precise access with row-level authorization.
Every tool call is tracked and stored in Tinybird service data sources, so you have detailed observability about how AI is using your resources.
Any agent, IDE, or client SDK can interact with Tinybird via Streamable HTTP.
[03]
Includes default prompts to monitor the health of your Tinybird cluster.
Choose to be notified via Slack, Email, or both. Run it on GitHub Actions, as a cron job, or on demand.
Clone the repo and build your own analytics agent in a few minutes.
[See the Birdwatcher repo]# Clone the repo
git clone git@github.com:tinybirdco/ai.git
cd ai/agents/birdwatcher
# Fill in the required environment variables for your Tinybird account and LLMs.
# Optionally, provide your Slack or Resend API keys to enable notifications
cp .env.example .env
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync
# Run the agent
uv run python birdwatcher.py \
--prompt "analyse website visits and notify me on #tmp-birdwatcher" \
--mission base
Includes default prompts to monitor the health of your Tinybird cluster.
If you are a Tinybird customer, simply add it to your Slack workspace and configure your tokens.
Clone the repo, define a new mission, and deploy it. It's that simple.
[See the Birdwatcher repo][04]
Dig into your data without knowing its schema. Tinybird has all the context to write SQL that answers your questions.
Tinybird retains the context from your chat, so you can perform exploratory data analysis interactively and iteratively.
When prompted, Explorations generates timeseries visualizations to help you understand how your data is evolving.
Copyright © 2025 Tinybird. All rights reserved
|