Influxdb3 MCP Server

What InfluxData/influxdb3_mcp_server does

InfluxData/influxdb3_mcp_server exposes InfluxDB 3 operations through the Model Context Protocol. It supports InfluxDB 3 Core and Enterprise, along with Cloud Dedicated, Cloud Clustered, and Cloud Serverless deployments. The tool set covers data access, schema inspection, database lifecycle operations, and token administration.

Agents can list databases and tables, inspect measurement schemas, sample an unfamiliar database, and check connection health. They can query with SQL or InfluxQL, write line protocol, and load custom database context or operational help. Administrative tools create, update, and delete databases, while token tools create, list, delete, or regenerate credentials depending on the deployment.

How it works

The server receives MCP tool calls and sends requests to the configured InfluxDB instance or cloud service. Core, Enterprise, and Cloud Serverless connections use an instance URL and token; Cloud Dedicated and Cloud Clustered connections use a cluster ID and tokens. The supplied credential is sent as a Bearer token, so database visibility and permitted actions are controlled by that token.

query_sql and query_influxql perform bounded, read-only queries and return structured response metadata. Results can include row counts, truncation status, warnings, and correlation identifiers. Query arguments use database and query; calls that provide both aliases with conflicting values fail with a structured argument error.

Discovery tools distinguish known values from unavailable ones. investigate_database preserves results for tables that succeed even if another table fails, and samples a 24-hour window by default. On Core and Enterprise, schema investigation can use authoritative server schema and internal catalog data when the credential permits access.

Set INFLUX_MCP_TOOL_PROFILE=readonly to expose only exploration and read-query tools. This profile excludes data writes, database administration, token management, and host operations.

Setup and configuration

Node.js 20.11 or newer is required for npm or npx usage. Docker can be used for a container-based setup. Local development uses pnpm, with the version pinned in package.json; Corepack can activate pnpm with Node.js 20 or 22.

Provide an InfluxDB URL and token for Core, Enterprise, or Cloud Serverless. Cloud Dedicated and Cloud Clustered deployments use a cluster ID and the relevant tokens. Set INFLUX_DB_TOKEN to an administrator token, scoped token, or Enterprise user-authentication JWT. The server passes this value through without inspecting its permissions.

Tools and capabilities

• Run bounded read-only SQL with query_sql or InfluxQL with query_influxql; execute_query remains only for compatibility and is deprecated.
• Explore databases and schemas with list_databases, list_tables, get_measurements, describe_table, get_measurement_schema, and investigate_database.
• Write line protocol and manage database configuration, including retention settings and applicable cloud limits for tables and columns.
• Create, list, delete, and regenerate tokens, with separate database-token operations for Cloud Dedicated and Cloud Clustered deployments.
• Load database-specific context, retrieve troubleshooting guidance, and check health with health_check.

Limitations and notes

Read results are bounded, and a complete answer should account for metadata such as completeness, caps, and warnings. Queries that exceed server memory require narrower requests. An Enterprise ingest-only endpoint cannot serve query operations. A 403 response is reported as not_found_or_denied, because a credential without access cannot distinguish an absent database from a forbidden one.

Database deletion and operator-token regeneration are irreversible operations. EXPLAIN ANALYZE runs within the same query bounds and adds a diagnostic warning. Cardinality estimates are not supported. When authoritative deletion metadata is unavailable, a timestamp-shaped table suffix may produce a possibly_deleted advisory while the table remains listed.