# Tiger MCP

Gives your coding agent access to Tiger Cloud services, databases and metrics. Useful when code changes need to be checked against a live database.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 126
- Author: timescale
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/timescale/tiger-cli
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/tiger-mcp

## What it 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.

## Requirements
- Needs: Docker
- Environment variables: `TIGER_PUBLIC_KEY`, `TIGER_SECRET_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: PostgreSQL

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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.0
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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.0
```
Replace <…> with your own values

## When to use it
- 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
- List all services in my Tiger Cloud project
- Run `SELECT now()` against service ID `abc123`
- Show the database schema and the installed PostgreSQL extensions

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md