InfluxDB 3 MCP Server

Official

Explore InfluxDB 3 schemas and query time series with the official MCP server. Choose its readonly profile for analysis without admin tools.

Local serverstdio

What is the InfluxDB 3 MCP Server?

InfluxData’s InfluxDB 3 MCP server gives an assistant schema discovery and query tools for InfluxDB deployments. It supports database and table exploration, SQL and InfluxQL, with the available tools depending on the product and configured profile.

Keep the time window with the result

For an operational question, identify the database, measurement and period before calculating an average or comparing values. The query response can include a row count, truncation status and warnings. Include those details with the query so a partial response is not mistaken for the complete dataset.

Select the readonly tool profile

Set INFLUX_MCP_TOOL_PROFILE=readonly for analysis without write, administration, token-management or host-level tools. The npm setup requires Node.js 20.11 or later and npm 9 or later. Credentials and connection variables differ across Core, Enterprise and cloud products; use the matching example configuration in the repository.

Setup and tool documentation. Explore related MCP servers.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_databasesList accessible databases.
list_tablesDiscover tables.
describe_tableInspect table columns.
query_sqlRun a bounded SQL query.
query_influxqlRun a bounded InfluxQL query.

How to install the InfluxDB 3 MCP Server

{
  "mcpServers": {
    "influxdb3": {
      "command": "npx",
      "args": [
        "-y",
        "@influxdata/influxdb3-mcp-server"
      ],
      "env": {
        "INFLUX_DB_INSTANCE_URL": "http://localhost:8181",
        "INFLUX_DB_TOKEN": "YOUR_INFLUXDB_TOKEN",
        "INFLUX_DB_PRODUCT_TYPE": "core",
        "INFLUX_MCP_TOOL_PROFILE": "readonly"
      }
    }
  }
}

This example targets Core. Use the repository’s product-specific variables for Enterprise or cloud deployments.

Configuration

Node.js 20.11+ and npm 9+ for npm installation. Configure the instance, product type and credentials using the matching deployment example.

VariableDescriptionRequired
INFLUX_DB_INSTANCE_URLURL of the intended InfluxDB deployment.Yes
INFLUX_DB_TOKENCredential accepted by the selected deployment.Yes
INFLUX_DB_PRODUCT_TYPEInfluxDB product type from the deployment guide.Yes
INFLUX_MCP_TOOL_PROFILESet readonly to exclude mutating and administration tools.Optional

Example prompts to try

  • “Find the sensors with the highest average temperature in the last 24 hours, and include the query and truncation status.”

Frequently asked questions

Set INFLUX_MCP_TOOL_PROFILE=readonly using the maintainer’s deployment configuration.