Add to Docker Desktop
Version 4.43 or later needs to be installed to add the server automatically
Use cases
About
Amazon Timestream for InfluxDB MCP Server
Time-series database operations.
MCP Info
| Attribute | Details |
|---|---|
| Docker Image | mcp/timestream-for-influxdb-mcp-server |
| Author | awslabs |
| Repository | https://github.com/awslabs/mcp |
Image Building Info
| Attribute | Details |
|---|---|
| Dockerfile | https://github.com/awslabs/mcp/blob/636aca8e109b5559006044f035bb89c16e9e5410/src/timestream-for-influxdb-mcp-server/Dockerfile |
| Commit | 636aca8e109b5559006044f035bb89c16e9e5410 |
| Docker Image built by | Docker Inc. |
| Docker Scout Health Score | |
| Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/timestream-for-influxdb-mcp-server --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| Licence | Apache License 2.0 |
Available Tools (26)
| Tools provided by this Server | Short Description |
|---|---|
CreateDbCluster | Create a new Timestream for InfluxDB database cluster. |
CreateDbInstance | Create a new Timestream for InfluxDB database instance |
CreateDbParamGroup | Creates a new Timestream for InfluxDB DB parameter group to associate with DB instances. |
DeleteDbCluster | Deletes a Timestream for InfluxDB cluster by the db_cluster_id |
DeleteDbInstance | Deletes a Timestream for InfluxDB DB instance by the instance-identifier |
GetDbCluster | Returns a Timestream for InfluxDB DB cluster details by the db_cluster_id |
GetDbInstance | Returns a Timestream for InfluxDB DB instance details by the instance-identifier |
GetDbParameterGroup | Get a Timestream for InfluxDB DB parameter group details for a db_parameter_group_id |
InfluxDBCreateBucket | Create a new bucket in InfluxDB. |
InfluxDBCreateOrg | Create a new organization in InfluxDB. |
InfluxDBListBuckets | List all buckets in InfluxDB. |
InfluxDBListOrgs | List all organizations in InfluxDB. |
InfluxDBQuery | Query data from InfluxDB using Flux query language. |
InfluxDBWriteLP | Write data in Line Protocol format to InfluxDB. |
InfluxDBWritePoints | Write data points to InfluxDB endpoint. |
ListClustersByStatus | Returns a list of Timestream for InfluxDB DB clusters filtered by status (case-insensitive). |
ListDbClusters | List all Timestream for InfluxDB DB clusters. |
ListDbInstances | List all Timestream for InfluxDB DB instances |
ListDbParamGroups | List all Timestream for InfluxDB DB parameter groups. |
ListTagsForResource | A list of tags applied to the resource. |
LsInstancesByStatus | Returns a list of Timestream for InfluxDB DB instances filtered by status (case-insensitive). |
LsInstancesOfCluster | List all Timestream for InfluxDB instances belonging to a specific DB cluster. |
TagResource | Tags are composed of a Key/Value pairs. |
UntagResource | Removes the tags, identified by the keys, from the specified resource. |
UpdateDbCluster | Updates a Timestream for InfluxDB cluster. |
UpdateDbInstance | Updates a Timestream for InfluxDB DB instance. |
Tools Details
Tool: CreateDbCluster
Create a new Timestream for InfluxDB database cluster.
| Parameters | Type | Description |
|---|---|---|
allocated_storage_gb | integer | The amount of storage to allocate for your DB storage type in GiB (gibibytes). |
db_instance_type | string | The Timestream for InfluxDB DB instance type to run InfluxDB on. |
name | string | The name that uniquely identifies the DB cluster when interacting with the Amazon Timestream for InfluxDB API and CLI commands. This name will also be a prefix included in the endpoint. |
password | string | The password of the initial admin user created in InfluxDB. This password will allow you to access the InfluxDB UI to perform various administrative task and also use the InfluxDB CLI to create an operator token. |
vpc_security_group_ids | array | A list of VPC security group IDs to associate with the DB. |
vpc_subnet_ids | array | A list of VPC subnet IDs to associate with the DB. Provide at least two VPC subnet IDs in different Availability Zones when deploying with a Multi-AZ standby. |
bucket | stringoptional | The name of the initial InfluxDB bucket. |
db_parameter_group_identifier | stringoptional | The id of the DB parameter group to assign to your DB. |
db_storage_type | stringoptional | The Timestream for InfluxDB DB storage type to read and write InfluxDB data. |
deployment_type | stringoptional | Specifies whether the DB instance will be deployed as a standalone instance or with a Multi-AZ standby for high availability. |
failover_mode | stringoptional | Specifies the behavior of failure recovery when the primary node of the cluster fails. |
log_delivery_configuration | stringoptional | Configuration for sending InfluxDB engine logs to a specified S3 bucket. |
networkType | stringoptional | Specifies whether the network type of the Timestream for InfluxDB cluster is IPv4 or DUAL. |
organization | stringoptional | The name of the initial organization for the initial admin user in InfluxDB.An InfluxDB organization is a workspace for a group of users |
port | stringoptional | The port number on which InfluxDB accepts connections. Default: 8086 |
publicly_accessible | booleanoptional | Configures the DB with a public IP to facilitate access from outside the VPC. |
tags | stringoptional | A list of tags to assign to the DB. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
username | stringoptional | The username of the initial admin user created in InfluxDB. |
Tool: CreateDbInstance
Create a new Timestream for InfluxDB database instance
| Parameters | Type | Description |
|---|---|---|
allocated_storage_gb | integer | The amount of storage to allocate for your DB storage type in GiB (gibibytes). |
db_instance_name | string | The name that uniquely identifies the DB instance. This name will also be a prefix included in the endpoint. DB instance names must be unique per customer and per region. |
db_instance_type | string | The Timestream for InfluxDB DB instance type to run InfluxDB on. |
password | string | The password of the initial admin user created in InfluxDB. This password will allow you to access the InfluxDB UI to perform various administrative task and also use the InfluxDB CLI to create an operator token. |
vpc_security_group_ids | array | A list of VPC security group IDs to associate with the DB. |
vpc_subnet_ids | array | A list of VPC subnet IDs to associate with the DB. Provide at least two VPC subnet IDs in different Availability Zones when deploying with a Multi-AZ standby. |
bucket | stringoptional | The name of the initial InfluxDB bucket. |
db_parameter_group_id | stringoptional | The id of the DB parameter group to assign to your DB. |
db_storage_type | stringoptional | The Timestream for InfluxDB DB storage type to read and write InfluxDB data. |
deployment_type | stringoptional | Specifies whether the DB instance will be deployed as a standalone instance or with a Multi-AZ standby for high availability. |
networkType | stringoptional | Specifies whether the network type of the Timestream for InfluxDB cluster is IPv4 or DUAL. |
organization | stringoptional | The name of the initial organization for the initial admin user in InfluxDB.An InfluxDB organization is a workspace for a group of users |
port | stringoptional | The port number on which InfluxDB accepts connections. Default: 8086 |
publicly_accessible | booleanoptional | Configures the DB with a public IP to facilitate access from outside the VPC. |
tags | stringoptional | A list of tags to assign to the DB. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
username | stringoptional | The username of the initial admin user created in InfluxDB. |
Tool: CreateDbParamGroup
Creates a new Timestream for InfluxDB DB parameter group to associate with DB instances.
| Parameters | Type | Description |
|---|---|---|
name | string | The name of the DB parameter group. The name must be unique per customer and per region. |
description | stringoptional | A description of the DB parameter group. |
parameters | stringoptional | A list of the parameters that comprise the DB parameter group. |
tags | stringoptional | A list of tags to assign to the DB. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
Tool: DeleteDbCluster
Deletes a Timestream for InfluxDB cluster by the db_cluster_id
| Parameters | Type | Description |
|---|---|---|
db_cluster_id | string | Service-generated unique identifier of the DB cluster. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
Tool: DeleteDbInstance
Deletes a Timestream for InfluxDB DB instance by the instance-identifier
| Parameters | Type | Description |
|---|---|---|
identifier | string | The id of the DB instance. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
Tool: GetDbCluster
Returns a Timestream for InfluxDB DB cluster details by the db_cluster_id
| Parameters | Type | Description |
|---|---|---|
db_cluster_id | string | Service-generated unique identifier of the DB cluster. |
Tool: GetDbInstance
Returns a Timestream for InfluxDB DB instance details by the instance-identifier
| Parameters | Type | Description |
|---|---|---|
identifier | string | The id of the DB instance. |
Tool: GetDbParameterGroup
Get a Timestream for InfluxDB DB parameter group details for a db_parameter_group_id
| Parameters | Type | Description |
|---|---|---|
identifier | string | The id of the DB parameter group. |
Tool: InfluxDBCreateBucket
Create a new bucket in InfluxDB.
| Parameters | Type | Description |
|---|---|---|
bucket_name | string | The name of the bucket to create. |
description | stringoptional | Description of the bucket. |
org | stringoptional | The organization name. Falls back to INFLUXDB_ORG env var if not provided. |
retention_seconds | stringoptional | Retention period in seconds. 0 or None means infinite retention. |
token | stringoptional | The authentication token. Falls back to INFLUXDB_TOKEN env var if not provided. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
url | stringoptional | The URL of the InfluxDB server. Falls back to INFLUXDB_URL env var if not provided. |
verify_ssl | booleanoptional | Whether to verify SSL with https connections. |
Tool: InfluxDBCreateOrg
Create a new organization in InfluxDB.
| Parameters | Type | Description |
|---|---|---|
org_name | string | The name of the organization to create. |
token | stringoptional | The authentication token. Falls back to INFLUXDB_TOKEN env var if not provided. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
url | stringoptional | The URL of the InfluxDB server. Falls back to INFLUXDB_URL env var if not provided. |
verify_ssl | booleanoptional | Whether to verify SSL with https connections. |
Tool: InfluxDBListBuckets
List all buckets in InfluxDB.
| Parameters | Type | Description |
|---|---|---|
org | stringoptional | The organization name. Falls back to INFLUXDB_ORG env var if not provided. |
token | stringoptional | The authentication token. Falls back to INFLUXDB_TOKEN env var if not provided. |
url | stringoptional | The URL of the InfluxDB server. Falls back to INFLUXDB_URL env var if not provided. |
verify_ssl | booleanoptional | Whether to verify SSL with https connections. |
Tool: InfluxDBListOrgs
List all organizations in InfluxDB.
| Parameters | Type | Description |
|---|---|---|
token | stringoptional | The authentication token. Falls back to INFLUXDB_TOKEN env var if not provided. |
url | stringoptional | The URL of the InfluxDB server. Falls back to INFLUXDB_URL env var if not provided. |
verify_ssl | booleanoptional | Whether to verify SSL with https connections. |
Tool: InfluxDBQuery
Query data from InfluxDB using Flux query language.
| Parameters | Type | Description |
|---|---|---|
query | string | The Flux query string. |
org | stringoptional | The organization name. Falls back to INFLUXDB_ORG env var if not provided. |
token | stringoptional | The authentication token. Falls back to INFLUXDB_TOKEN env var if not provided. |
url | stringoptional | The URL of the InfluxDB server. Falls back to INFLUXDB_URL env var if not provided. |
verify_ssl | booleanoptional | Whether to verify SSL with https connections. |
Tool: InfluxDBWriteLP
Write data in Line Protocol format to InfluxDB.
| Parameters | Type | Description |
|---|---|---|
bucket | string | The destination bucket for writes. |
data_line_protocol | string | Data in InfluxDB Line Protocol format. |
org | stringoptional | The organization name. Falls back to INFLUXDB_ORG env var if not provided. |
sync_mode | stringoptional | The synchronization mode, either 'synchronous' or 'asynchronous'. |
time_precision | stringoptional | The precision for the unix timestamps within the body line-protocol. One of: ns, us, ms, s (default is ns). |
token | stringoptional | The authentication token. Falls back to INFLUXDB_TOKEN env var if not provided. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
url | stringoptional | The URL of the InfluxDB server. Falls back to INFLUXDB_URL env var if not provided. |
verify_ssl | booleanoptional | Whether to verify SSL with https connections. |
Tool: InfluxDBWritePoints
Write data points to InfluxDB endpoint.
| Parameters | Type | Description |
|---|---|---|
bucket | string | The destination bucket for writes. |
points | array | List of data points to write. Each point should be a dictionary with measurement, tags, fields, and optional time. |
org | stringoptional | The organization name. Falls back to INFLUXDB_ORG env var if not provided. |
sync_mode | stringoptional | The synchronization mode, either 'synchronous' or 'asynchronous'. |
time_precision | stringoptional | The precision for the unix timestamps within the body line-protocol. One of: ns, us, ms, s (default is ns). |
token | stringoptional | The authentication token. Falls back to INFLUXDB_TOKEN env var if not provided. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
url | stringoptional | The URL of the InfluxDB server. Falls back to INFLUXDB_URL env var if not provided. |
verify_ssl | booleanoptional | Whether to verify SSL with https connections. |
Tool: ListClustersByStatus
Returns a list of Timestream for InfluxDB DB clusters filtered by status (case-insensitive).
| Parameters | Type | Description |
|---|---|---|
status | string | The status to filter DB clusters by (case-insensitive). |
Tool: ListDbClusters
List all Timestream for InfluxDB DB clusters.
| Parameters | Type | Description |
|---|---|---|
max_results | stringoptional | The maximum number of items to return in the output. If the total number of items available is more than the value specified, a nextToken is provided in the output. |
next_token | stringoptional | The pagination token. To resume pagination, provide the next-token value as an argument of a subsequent API invocation. |
Tool: ListDbInstances
List all Timestream for InfluxDB DB instances
| Parameters | Type | Description |
|---|---|---|
max_results | stringoptional | The maximum number of items to return in the output. If the total number of items available is more than the value specified, a nextToken is provided in the output. |
next_token | stringoptional | The pagination token. To resume pagination, provide the next-token value as an argument of a subsequent API invocation. |
Tool: ListDbParamGroups
List all Timestream for InfluxDB DB parameter groups.
| Parameters | Type | Description |
|---|---|---|
max_results | stringoptional | The maximum number of items to return in the output. If the total number of items available is more than the value specified, a nextToken is provided in the output. |
next_token | stringoptional | The pagination token. To resume pagination, provide the next-token value as an argument of a subsequent API invocation. |
Tool: ListTagsForResource
A list of tags applied to the resource.
| Parameters | Type | Description |
|---|---|---|
resource_arn | string | The Amazon Resource Name (ARN) of the tagged resource. |
Tool: LsInstancesByStatus
Returns a list of Timestream for InfluxDB DB instances filtered by status (case-insensitive).
| Parameters | Type | Description |
|---|---|---|
status | string | The status to filter DB instances by (case-insensitive). |
Tool: LsInstancesOfCluster
List all Timestream for InfluxDB instances belonging to a specific DB cluster.
| Parameters | Type | Description |
|---|---|---|
db_cluster_id | string | Service-generated unique identifier of the DB cluster. |
max_results | stringoptional | The maximum number of items to return in the output. If the total number of items available is more than the value specified, a nextToken is provided in the output. |
next_token | stringoptional | The pagination token. To resume pagination, provide the next-token value as an argument of a subsequent API invocation. |
Tool: TagResource
Tags are composed of a Key/Value pairs. Apply them to Timestream for InfluxDB resource.
| Parameters | Type | Description |
|---|---|---|
resource_arn | string | The Amazon Resource Name (ARN) of the tagged resource. |
tags | object | A list of key-value pairs as tags. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
Tool: UntagResource
Removes the tags, identified by the keys, from the specified resource.
| Parameters | Type | Description |
|---|---|---|
resource_arn | string | The Amazon Resource Name (ARN) of the tagged resource. |
tag_keys | array | The keys used to identify the tags to remove. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
Tool: UpdateDbCluster
Updates a Timestream for InfluxDB cluster.
| Parameters | Type | Description |
|---|---|---|
db_cluster_id | string | Service-generated unique identifier of the DB cluster. |
db_instance_type | stringoptional | Update the DB cluster to use the specified DB instance Type. |
db_parameter_group_identifier | stringoptional | Update the DB cluster to use the specified DB parameter group. |
failover_mode | stringoptional | Update the DB cluster's failover behavior. |
log_delivery_configuration | stringoptional | The log delivery configuration to apply to the DB cluster. |
port | stringoptional | Update the DB cluster to use the specified port. |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
Tool: UpdateDbInstance
Updates a Timestream for InfluxDB DB instance.
| Parameters | Type | Description |
|---|---|---|
identifier | string | The id of the DB instance. |
allocated_storage_gb | stringoptional | The amount of storage to allocate for your DB storage type (in gibibytes). |
db_instance_type | stringoptional | Update the DB cluster to use the specified DB instance Type. |
db_parameter_group_identifier | stringoptional | The id of the DB parameter group to assign to your DB. |
db_storage_type | stringoptional | The Timestream for InfluxDB DB storage type to read and write InfluxDB data. |
deployment_type | stringoptional | Specifies whether the DB instance will be deployed as a standalone instance or with a Multi-AZ standby for high availability. |
log_delivery_configuration | stringoptional | Configuration for sending InfluxDB engine logs to a specified S3 bucket. |
port | stringoptional | The port number on which InfluxDB accepts connections. Default: 8086 |
tool_write_mode | booleanoptional | Tool is run in write mode and will be able to perform any create/update/delete operations. Default is read-only mode (False) |
Use this MCP Server
{
"mcpServers": {
"awslabs-timestream-for-influxdb": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AWS_REGION",
"-e",
"AWS_PROFILE",
"mcp/timestream-for-influxdb-mcp-server"
],
"env": {
"AWS_REGION": "us-east-1",
"AWS_PROFILE": "default"
}
}
}
}