# Tiger Cloud MCP server

> Lets AI assistants manage Tiger Cloud Postgres services, run SQL queries, inspect schemas, and view logs and metrics.

- Repository: https://github.com/timescale/tiger-cli
- Page: https://hostedmcp.org/servers/timescale/tiger-cli
- Transport: stdio
- Stars: 127
- License: Apache-2.0
- Latest version: 0.27.0

## Install

### Claude Code

```sh
claude mcp add --env 'TIGER_SECRET_KEY=<YOUR_TIGER_SECRET_KEY>' --env 'TIGER_PUBLIC_KEY=<TIGER_PUBLIC_KEY>' tiger-cli -- docker run -i --rm ghcr.io/timescale/tiger-cli:0.27.0
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "tiger-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/timescale/tiger-cli:0.27.0"
      ],
      "env": {
        "TIGER_SECRET_KEY": "<YOUR_TIGER_SECRET_KEY>",
        "TIGER_PUBLIC_KEY": "<TIGER_PUBLIC_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "tiger-cli": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/timescale/tiger-cli:0.27.0"
      ],
      "env": {
        "TIGER_SECRET_KEY": "<YOUR_TIGER_SECRET_KEY>",
        "TIGER_PUBLIC_KEY": "<TIGER_PUBLIC_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"tiger-cli","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/timescale/tiger-cli:0.27.0"],"env":{"TIGER_SECRET_KEY":"<YOUR_TIGER_SECRET_KEY>","TIGER_PUBLIC_KEY":"<TIGER_PUBLIC_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "tiger-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/timescale/tiger-cli:0.27.0"
      ],
      "env": {
        "TIGER_SECRET_KEY": "<YOUR_TIGER_SECRET_KEY>",
        "TIGER_PUBLIC_KEY": "<TIGER_PUBLIC_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add tiger-cli --env 'TIGER_SECRET_KEY=<YOUR_TIGER_SECRET_KEY>' --env 'TIGER_PUBLIC_KEY=<TIGER_PUBLIC_KEY>' -- docker run -i --rm ghcr.io/timescale/tiger-cli:0.27.0
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.tiger-cli]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/timescale/tiger-cli:0.27.0"]

[mcp_servers.tiger-cli.env]
TIGER_SECRET_KEY = "<YOUR_TIGER_SECRET_KEY>"
TIGER_PUBLIC_KEY = "<TIGER_PUBLIC_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'TIGER_SECRET_KEY=<YOUR_TIGER_SECRET_KEY>' -e 'TIGER_PUBLIC_KEY=<TIGER_PUBLIC_KEY>' tiger-cli docker -- run -i --rm ghcr.io/timescale/tiger-cli:0.27.0
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "tiger-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/timescale/tiger-cli:0.27.0"
      ],
      "env": {
        "TIGER_SECRET_KEY": "<YOUR_TIGER_SECRET_KEY>",
        "TIGER_PUBLIC_KEY": "<TIGER_PUBLIC_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `TIGER_SECRET_KEY` | yes | yes | Tiger Cloud API secret key for authentication |
| `TIGER_PUBLIC_KEY` | yes | no | Tiger Cloud API public key for authentication |

## Tools (20)

- `service_list`
- `service_get`
- `service_create`
- `service_fork`
- `service_start`
- `service_stop`
- `service_rename`
- `service_resize`
- `service_delete`
- `service_update_password`
- `service_logs`
- `service_metrics_available`
- `service_metrics_details`
- `service_metrics_series`
- `db_query`
- `db_schema`
- `db_extensions_list`
- `feedback`
- `view_skill`
- `search_docs`

## FAQ

### How do I install the Tiger MCP server in Claude Code?

Run `tiger mcp install claude-code` to configure the MCP server for Claude Code, then restart the assistant to activate it.

### What can the Tiger MCP server do with database services?

It exposes tools to list, create, fork, start, stop, rename, resize, and delete database services, as well as view service logs.

### Can the Tiger MCP server run SQL queries?

Yes, the `db_query` tool executes SQL against a database service inline or from a SQL file, with parameterized queries, custom timeouts, and connection pooling.

### Do I need separate authentication for the MCP server?

No, the MCP server uses your CLI authentication and configuration after you run `tiger auth login`.
