# Tinybird (verified)

Query and manage Tinybird real-time analytics — run SQL pipes, inspect data sources, manage tokens and workspaces.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add tinybird

# Browse available tools
npx -y @smithery/cli@latest tool list tinybird

# Get full schema for a tool
npx -y @smithery/cli@latest tool get tinybird explore_data

# Call a tool
npx -y @smithery/cli@latest tool call tinybird explore_data '{}'
```

## Direct MCP Connection

Endpoint: `https://tinybird.run.tools`

**Required config:**
- `token` (query) — Tinybird workspace API token (or JWT). Generate one in the Tinybird UI under Tokens.

**Optional config:**
- `host` (query) — Override API host for JWT + non-default region, e.g. https://api.eu-central-1.aws.tinybird.co

## Tools (10)

- `explore_data` — Explore data in the workspace to answer questions.
- `text_to_sql` — Convert natural language question to SQL query.
- `list_datasources` — List all datasources available in the workspace.
- `list_endpoints` — List all endpoints available in the workspace.
- `list_service_datasources` — List all service datasources available in the workspace.
- `execute_query` — Execute a sql query against Tinybird SQL API.
- `server_usage_timeseries` — Endpoint to get usage timeseries (sessions and users by method) for a specific MCP server over a configurable time wind…
- `tool_call_counts` — Endpoint to get tool call counts and user counts by tool name for a specific MCP server
- `tool_uptime_timeseries` — Daily uptime/success rate by tool for a specific MCP server.
- `client_usage_timeseries` — Daily session counts broken down by client for a specific MCP server.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get tinybird <tool-name>
```