--- 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, types, and required or optional fields can change with new Tiger MCP versions. Run `tiger mcp get ` 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. **Returns**: an array of services, each with its status, type, region, and resource allocation. ### `service_get` Show detailed information about one service. | Parameter | Type | Required | Description | | --------------- | ------- | -------- | --------------------------------------------------------------------------------------------- | | `service_id` | string | Yes | The target service. | | `with_password` | boolean | No | Include the password. Only set this if you explicitly ask for the password. Default: `false`. | **Returns**: connection endpoints, replica configuration, resource allocation, creation time, and status. ### `service_create` Create a new service. Addons: `time-series` (TimescaleDB) and `ai` (AI/vector). | Parameter | Type | Required | Description | | --------------- | -------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | No | Service name (auto-generated if omitted). | | `addons` | array of strings (`time-series`, `ai`) | No | Addons to enable. Omit or use an empty array for PostgreSQL-only. | | `region` | string | No | Cloud region, for example `us-east-1`. | | `cpu_memory` | string (enum) | No | CPU/memory allocation, for example `"4 CPU/16 GB"`. See [allowed configurations](/reference/tiger-cloud/tiger-cli#tiger-service-create/index.md). | | `replicas` | integer (0-5) | No | Number of high-availability replicas. Default: `0`. | | `wait` | boolean | No | Wait for the service to be ready before returning. Default: `false`. | | `set_default` | boolean | No | Set the new service as the default. Default: `true`. | | `with_password` | boolean | No | Include the password in the response. Default: `false`. | **Returns**: the new service's details, including its ID, connection endpoint, and status. Creates billable resources `service_create` provisions billable infrastructure. ### `service_fork` Fork a service into an independent copy. | Parameter | Type | Required | Description | | --------------- | --------------------------------------------- | ---------------- | ------------------------------------------------------------------------ | | `service_id` | string | Yes | The source service. | | `fork_strategy` | string (enum: `NOW`, `LAST_SNAPSHOT`, `PITR`) | Yes | When to fork from. | | `target_time` | string (RFC3339) | Only with `PITR` | Point in time to fork from. | | `name` | string | No | Fork name (auto-generated if omitted). | | `cpu_memory` | string (enum) | No | CPU/memory allocation for the fork. Inherits from the source if omitted. | | `wait` | boolean | No | Wait for the fork to be ready before returning. Default: `false`. | | `set_default` | boolean | No | Set the fork as the default service. Default: `true`. | | `with_password` | boolean | No | Include the password in the response. Default: `false`. | **Returns**: the new fork's details, including its ID, connection endpoint, and status. Creates billable resources `service_fork` provisions billable infrastructure. ### `service_resize` Change a service's CPU and memory. | Parameter | Type | Required | Description | | ------------ | ------------- | -------- | ----------------------------------------------------------------- | | `service_id` | string | Yes | The service to resize. | | `cpu_memory` | string (enum) | Yes | New CPU/memory allocation, for example `"4 CPU/16 GB"`. | | `wait` | boolean | No | Wait for the resize to finish before returning. Default: `false`. | **Returns**: the service's updated resource allocation and status. Affects billing `service_resize` affects billing, and the service may be briefly unavailable. ### `service_start` Start a stopped service. | Parameter | Type | Required | Description | | ------------ | ------- | -------- | ---------------------------------------------------------------------------- | | `service_id` | string | Yes | The service to start. | | `wait` | boolean | No | Wait for the service to be fully started before returning. Default: `false`. | **Returns**: the service's updated status. ### `service_stop` Stop a running service. | Parameter | Type | Required | Description | | ------------ | ------- | -------- | ---------------------------------------------------------------------------- | | `service_id` | string | Yes | The service to stop. | | `wait` | boolean | No | Wait for the service to be fully stopped before returning. Default: `false`. | **Returns**: the service's updated status. ### `service_update_password` Update the `tsdbadmin` password. May disconnect existing sessions. | Parameter | Type | Required | Description | | ------------ | ------ | -------- | ------------------------------------------ | | `service_id` | string | Yes | The service to update. | | `password` | string | Yes | The new password for the `tsdbadmin` user. | **Returns**: confirmation that the password was updated. ### `service_logs` Fetch service logs. | Parameter | Type | Required | Description | | ---------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `service_id` | string | Yes | The service to fetch logs for. | | `tail` | integer | No | Number of log lines to return. Default: `100`. | | `since`, `until` | string (RFC3339) | No | Restrict logs to a time range. | | `node` | integer | No | Specific node to fetch logs from (for services with HA replicas; `0` is valid). Defaults to the primary node. | **Returns**: the matching log lines. ## Database tools ### `db_execute_query` Run a single SQL statement against a service. | Parameter | Type | Required | Description | | ----------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------- | | `service_id` | string | Yes | The target service (or a read replica set ID, to query the replica instead of the primary). | | `query` | string | Yes | The SQL statement to run. | | `parameters` | array of strings | No | Values substituted for `$1`, `$2`, and so on. Not supported with multi-statement queries. | | `timeout_seconds` | integer | No | Query timeout. Default: `30`. | | `role` | string | No | Database role to connect as. Default: `tsdbadmin`. | | `pooled` | boolean | No | Use connection pooling. Default: `false`. | **Returns**: column information, row data, and execution metadata for each statement. 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). | Parameter | Type | Required | Description | | ------------- | ------- | -------- | --------------------------------------------------------------------- | | `service_id` | string | Yes | The target service (or a read replica set ID). | | `schema` | string | No | Restrict output to a single schema. | | `definitions` | boolean | No | Include full object definitions. Default: `false`. | | `comments` | boolean | No | Include object comments (`COMMENT ON` text). Default: `false`. | | `internal` | boolean | No | Include system schemas and extension-owned objects. Default: `false`. | | `role` | string | No | Database role to connect as. Default: `tsdbadmin`. | | `pooled` | boolean | No | Use connection pooling. Default: `false`. | **Returns**: readable text describing tables, views, materialized views, enum types, functions, procedures, indexes, triggers, and TimescaleDB hypertable and continuous aggregate metadata. The connection is opened in immutable read-only mode, so this tool never writes. ## Documentation and skills tools ### `search_docs` Search Tiger Data documentation with hybrid semantic (vector) and keyword search. | Parameter | Type | Required | Description | | ---------------- | ------------- | -------- | ---------------------------------------------------------------------------------------------------- | | `source` | string (enum) | Yes | The documentation source, for example `tiger`, `postgres_17`, or `postgis_3.5`. | | `query` | string | Yes | The search query. | | `limit` | integer | Yes | Maximum matches to return. Default: `20`. | | `semanticWeight` | number (0-1) | Yes | `0` for keyword-only, `1` for semantic-only, or a value in between to blend the two. Default: `0.7`. | **Returns**: ranked matches from the requested documentation source. ### `view_skill` Retrieve a built-in skill for TimescaleDB operations and best practices (for example, schema design, hypertable setup, and migration planning). | Parameter | Type | Required | Description | | ------------ | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `skill_name` | string | Yes | The skill to retrieve, or `.` to list all available skills. | | `path` | string | Yes | A relative path to a file or directory within the skill. Use `.` to list the skill's root directory, or leave empty for the skill's `SKILL.md`. | **Returns**: the requested skill content, or a directory listing. ## 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.