---
title: Tiger MCP reference | Tiger Data Docs
description: 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](/get-started/quickstart/mcp-cli/index.md). 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](/learn/tiger-cli-mcp/index.md).

## Tiger MCP tools

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).

## Manage the Tiger MCP server

To install, list, inspect, and start Tiger MCP, use the `tiger mcp` commands, documented in the [Tiger CLI reference](/reference/tiger-cloud/tiger-cli#mcp/index.md). Global flags that apply when running Tiger MCP are in the [configuration parameters](/reference/tiger-cloud/tiger-cli#configuration-parameters/index.md).

Tiger MCP ships inside the open-source Tiger CLI. [File an issue in the repo](https://github.com/timescale/tiger-cli/issues/new) to report bugs or request features and help shape the product.