Tiger MCP — Claude Code MCP server for Tiger Cloud
Gives your coding agent access to Tiger Cloud services, databases and metrics. Useful when code changes need to be checked against a live database.
claude mcp add --env TIGER_PUBLIC_KEY=<TIGER_PUBLIC_KEY> --env TIGER_SECRET_KEY=<TIGER_SECRET_KEY> --transport stdio tiger-mcp -- docker run -i --rm -e TIGER_PUBLIC_KEY -e TIGER_SECRET_KEY ghcr.io/timescale/tiger-cli:0.26.0What Tiger MCP does
Tiger MCP ships inside Tiger CLI, the command-line tool for Tiger Cloud. The server runs in a Docker container, ghcr.io/timescale/tiger-cli:0.26.0, over stdio, so there is no network port to open. Through it the assistant can list services, run SQL, read the schema and pull metrics.
You need TIGER_PUBLIC_KEY and TIGER_SECRET_KEY before anything works — the container will not authenticate without them. Docker has to be installed too, since the launch command goes through docker run. The MCP tools accept service IDs only; names are rejected, so keep the ID handy in your prompts.
Worth adding if your project already runs on Tiger Cloud and you want the agent to read the data itself instead of taking your word for it. Against a local PostgreSQL instance it adds a layer you do not need, because the server targets Tiger Cloud services.
What it helps with
- list Tiger Cloud services from inside the agent
- run a SQL query without opening psql
- inspect table and TimescaleDB hypertable schemas
- fetch service metrics for a time range
- create a read-only database role
Example prompts for the agent
- List all services in my Tiger Cloud project
- Run
SELECT now()against service IDabc123 - Show the database schema and the installed PostgreSQL extensions
How to install Tiger MCP
Platform CLI
claude mcp add --env TIGER_PUBLIC_KEY=<TIGER_PUBLIC_KEY> --env TIGER_SECRET_KEY=<TIGER_SECRET_KEY> --transport stdio tiger-mcp -- docker run -i --rm -e TIGER_PUBLIC_KEY -e TIGER_SECRET_KEY ghcr.io/timescale/tiger-cli:0.26.0Replace <…> with your own values
Platform CLI
codex mcp add tiger-mcp --env TIGER_PUBLIC_KEY=<TIGER_PUBLIC_KEY> --env TIGER_SECRET_KEY=<TIGER_SECRET_KEY> -- docker run -i --rm -e TIGER_PUBLIC_KEY -e TIGER_SECRET_KEY ghcr.io/timescale/tiger-cli:0.26.0Replace <…> with your own values
Config file
{
"mcpServers": {
"tiger-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TIGER_PUBLIC_KEY",
"-e",
"TIGER_SECRET_KEY",
"ghcr.io/timescale/tiger-cli:0.26.0"
],
"env": {
"TIGER_PUBLIC_KEY": "<TIGER_PUBLIC_KEY>",
"TIGER_SECRET_KEY": "<TIGER_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tiger-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TIGER_PUBLIC_KEY",
"-e",
"TIGER_SECRET_KEY",
"ghcr.io/timescale/tiger-cli:0.26.0"
],
"env": {
"TIGER_PUBLIC_KEY": "<TIGER_PUBLIC_KEY>",
"TIGER_SECRET_KEY": "<TIGER_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TIGER_PUBLIC_KEY=<TIGER_PUBLIC_KEY> -e TIGER_SECRET_KEY=<TIGER_SECRET_KEY> tiger-mcp docker run -i --rm -e TIGER_PUBLIC_KEY -e TIGER_SECRET_KEY ghcr.io/timescale/tiger-cli:0.26.0Replace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Tiger MCP
How do I install Tiger MCP in Claude Code?
Run `claude mcp add --env TIGER_PUBLIC_KEY=<TIGER_PUBLIC_KEY> --env TIGER_SECRET_KEY=<TIGER_SECRET_KEY> --transport stdio tiger-mcp -- docker run -i --rm -e TIGER_PUBLIC_KEY -e TIGER_SECRET_KEY ghcr.io/timescale/tiger-cli:0.26.0`, replacing the placeholders with your own keys.
What does Tiger MCP do?
It gives an AI assistant programmatic access to Tiger Cloud: service listing and lifecycle, SQL queries, database schema, PostgreSQL extensions and metrics.
What do I need before running Tiger MCP?
Docker plus a pair of keys, TIGER_PUBLIC_KEY and TIGER_SECRET_KEY. The server starts as the container ghcr.io/timescale/tiger-cli:0.26.0.
