Tiger MCP reference

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

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