Tiger

Tiger MCP Server enables AI assistants to interact programmatically with your Tiger Cloud infrastructure, giving you seamless access to management and querying of database services through an integrated Model Context Protocol (MCP) server.

How to use

You can use a compatible MCP client to connect to the Tiger MCP Server and perform service management and database operations. The MCP server exposes capabilities for listing, creating, starting, stopping, resizing, and deleting database services, as well as executing database queries. It also proxies documentation-enabled tools to help assistants interpret PostgreSQL, TimescaleDB, and Tiger Cloud concepts, while using your existing authentication context.

How to install

Prerequisites: you need a working environment to install the Tiger CLI and, optionally, an MCP client to connect to the MCP server. You will install Tiger CLI first, then install and start the MCP server for an AI assistant.

# Install Script (macOS/Linux/WSL)
curl -fsSL https://cli.tigerdata.com | sh

# Install Script (Windows)
irm https://cli.tigerdata.com/install.ps1 | iex

# Homebrew (macOS/Linux)
brew install --cask timescale/tiger-cli

# Debian/Ubuntu
# Add repository
curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.deb.sh | sudo os=any dist=any bash

# Install tiger-cli
sudo apt-get install tiger-cli

# Red Hat/Fedora
# Add repository
curl -s https://packagecloud.io/install/repositories/timescale/tiger-cli/script.rpm.sh | sudo os=rpm_any dist=rpm_any bash

# Install tiger-cli
sudo yum install tiger-cli

# Go Install
go install github.com/timescale/tiger-cli/cmd/tiger@latest

MCP server installation steps

After you have Tiger CLI installed, you can set up the MCP server for your AI assistant.

# Interactive installation (prompts for client selection)
tiger mcp install

# Or specify your MCP client directly
# Example for Claude Code
tiger mcp install claude-code
# Example for Codex
# tiger mcp install codex
# Example for Cursor IDE
# tiger mcp install cursor
# Example for Gemini CLI
# tiger mcp install gemini
# Example for VS Code
# tiger mcp install vscode
# Example for Windsurf
# tiger mcp install windsurf

Manual installation and streamable HTTP transport

If your MCP client is not listed, you can install the MCP server manually. Use the command to start the MCP server when you are ready to run it.

{
  "mcpServers": {
    "tiger": {
      "command": "tiger",
      "args": [
        "mcp",
        "start"
      ]
    }
  }
}

Streamable HTTP protocol

If you prefer the Streamable HTTP transport, start the MCP server over HTTP and provide your client with the HTTP URL.

tiger mcp start http --port 8080

Use http://localhost:8080 as the MCP URL for your client.

## Available tools

### service\_list

List all database services in your project

### service\_get

Get detailed information about a specific service

### service\_create

Create a new database service with configurable resources

### service\_fork

Fork an existing database service to create an independent copy

### service\_start

Start a stopped database service

### service\_stop

Stop a running database service

### service\_resize

Resize a database service by changing CPU and memory allocation

### service\_update\_password

Update the master password for a service

### service\_logs

View logs for a database service

### db\_execute\_query

Execute SQL queries against a database service with support for parameterized queries