Skip to content

Tiger MCP reference

Tool reference for Tiger MCP, the Model Context Protocol server bundled with Tiger CLI

Tiger MCP gives your AI agent access to Tiger Cloud so you can manage services and query your data in natural language. It is built into the Tiger CLI binary.

To install and configure Tiger MCP for your AI agent, see Integrate Tiger Cloud with your AI agent. This page is the reference for the Tiger MCP tools your agent can call. For an overview of Tiger MCP and Tiger CLI, see Tiger CLI and Tiger MCP.

Tiger MCP exposes the following tools to your AI agent. You do not call these directly; you describe what you want and the agent selects the tool.

Definitions can change

Parameter names and required or optional fields can change with new Tiger MCP versions. Run tiger mcp get <tool_name> for the current definition of any tool.

Service tools

Note

The following tools are disabled when using read-only mode: service_create, service_fork, service_start, service_stop, service_resize, service_update_password.

service_list

List the services in the current project. No parameters.

service_get

Show detailed information about one service.

  • service_id (required): the target service.
  • with_password: include the password. Only set this if you explicitly ask for the password.

service_create

Create a new service. Addons: time-series (TimescaleDB) and ai (AI/vector).

  • name, addons, region, cpu_memory, replicas, wait, set_default, with_password.
Creates billable resources

service_create provisions billable infrastructure.

service_fork

Fork a service into an independent copy.

  • service_id (required): the source service.
  • fork_strategy (required): NOW, LAST_SNAPSHOT, or PITR.
  • target_time: point in time, for PITR.
  • name, cpu_memory, wait, set_default, with_password.
Creates billable resources

service_fork provisions billable infrastructure.

service_resize

Change a service's CPU and memory.

  • service_id (required), cpu_memory (required), wait.
Affects billing

service_resize affects billing, and the service may be briefly unavailable.

service_start

Start a stopped service.

  • service_id (required), wait.

service_stop

Stop a running service.

  • service_id (required), wait.

service_update_password

Update the tsdbadmin password. May disconnect existing sessions.

  • service_id (required), password (required).

service_logs

Fetch service logs.

  • service_id (required), tail, since, until, node.

Database tools

db_execute_query

Run a single SQL statement against a service.

  • service_id (required), query (required), parameters, timeout_seconds, role, pooled.
Can run destructive SQL

db_execute_query can run INSERT, UPDATE, DELETE, and DDL. Multi-statement queries (semicolon-separated) are supported when no parameters are provided. In read-only mode, writes and DDL are rejected by the server.

db_schema

Return the schema of a service database as readable text (tables, views, materialized views, and more).

  • service_id (required), schema, definitions, comments, internal, role, pooled.

Documentation and skills tools

search_docs

Search Tiger Data documentation with hybrid semantic (vector) and keyword search.

  • source (required), query (required), limit (required), semanticWeight (required): 0 for keyword-only, 1 for semantic-only, or a value in between to blend the two.

view_skill

Retrieve a built-in skill for TimescaleDB operations and best practices (for example, schema design, hypertable setup, and migration planning).

  • skill_name (required), path (required).

To install, list, inspect, and start Tiger MCP, use the tiger mcp commands, documented in the Tiger CLI reference. Global flags that apply when running Tiger MCP are in the configuration parameters.

Tiger MCP ships inside the open-source Tiger CLI. File an issue in the repo to report bugs or request features and help shape the product.