Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

InfluxDB 3

de influxdataversión 2.0.1i★ 38iSe ejecuta en tu computadora
Nombre en el registroio.github.influxdata/influxdb3-mcp-server

Cómo instalar

What it does

Official InfluxDB 3 MCP server: query, write and manage Core, Enterprise and Cloud databases.

  • Connects Se ejecuta en tu computadora
  • Account or key Needs INFLUX_DB_TOKEN, INFLUX_DB_MANAGEMENT_TOKEN · 4 settings to fill in (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID)
  • Category Bases de datos y conjuntos de datos

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 2/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de InfluxDB 3 (créala en el sitio del autor) · 4 ajuste(s) que rellenar (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de InfluxDB 3

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 4 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • INFLUX_DB_PRODUCT_TYPE InfluxDB edition or service; use its runtime configuration value.
    • INFLUX_DB_INSTANCE_URL InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.
    • INFLUX_DB_ACCOUNT_ID Account ID required when using a management token with Cloud Dedicated.
    • INFLUX_DB_CLUSTER_ID Cluster ID required for Cloud Dedicated.

    Las descripciones siguen en el inglés original.

  4. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  5. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "influxdb3": {
          "command": "npx",
          "args": [
            "-y",
            "@influxdata/influxdb3-mcp-server"
          ],
          "env": {
            "INFLUX_DB_PRODUCT_TYPE": "your-value",
            "INFLUX_DB_TOKEN": "your-value",
            "INFLUX_DB_INSTANCE_URL": "your-value",
            "INFLUX_DB_MANAGEMENT_TOKEN": "your-value",
            "INFLUX_DB_ACCOUNT_ID": "your-value",
            "INFLUX_DB_CLUSTER_ID": "your-value"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Cierra Claude y vuelve a abrirlo

  7. Pruébalo

    Usa InfluxDB 3 y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando InfluxDB 3 o muestra una herramienta de InfluxDB 3 en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • INFLUX_MCP_TOOL_PROFILE Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools. · valor por defecto operator

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar InfluxDB 3

InfluxDB 3 se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar InfluxDB 3

  • Necesitas una clave de InfluxDB 3 (créala en el sitio del autor) · 4 ajuste(s) que rellenar (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de InfluxDB 3 (créala en el sitio del autor) · 4 ajuste(s) que rellenar (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de InfluxDB 3 (créala en el sitio del autor) · 4 ajuste(s) que rellenar (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de InfluxDB 3 (créala en el sitio del autor) · 4 ajuste(s) que rellenar (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Bases de datos y conjuntos de datos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de InfluxDB 3 (créala en el sitio del autor) · 4 ajuste(s) que rellenar (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de InfluxDB 3

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 4 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • INFLUX_DB_PRODUCT_TYPE InfluxDB edition or service; use its runtime configuration value.
    • INFLUX_DB_INSTANCE_URL InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.
    • INFLUX_DB_ACCOUNT_ID Account ID required when using a management token with Cloud Dedicated.
    • INFLUX_DB_CLUSTER_ID Cluster ID required for Cloud Dedicated.

    Las descripciones siguen en el inglés original.

  4. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  5. Pega este comando y pulsa Enter

    claude mcp add --scope user influxdb3 --env INFLUX_DB_PRODUCT_TYPE=your-value --env INFLUX_DB_TOKEN=your-value --env INFLUX_DB_INSTANCE_URL=your-value --env INFLUX_DB_MANAGEMENT_TOKEN=your-value --env INFLUX_DB_ACCOUNT_ID=your-value --env INFLUX_DB_CLUSTER_ID=your-value -- npx -y @influxdata/influxdb3-mcp-server

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Escribe /mcp en Claude Code

    Deberías ver InfluxDB 3 en la lista como conectado

  7. Pruébalo

    Usa InfluxDB 3 y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando InfluxDB 3 o muestra una herramienta de InfluxDB 3 en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • INFLUX_MCP_TOOL_PROFILE Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools. · valor por defecto operator

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de InfluxDB 3 (créala en el sitio del autor) · 4 ajuste(s) que rellenar (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de InfluxDB 3

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 4 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • INFLUX_DB_PRODUCT_TYPE InfluxDB edition or service; use its runtime configuration value.
    • INFLUX_DB_INSTANCE_URL InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.
    • INFLUX_DB_ACCOUNT_ID Account ID required when using a management token with Cloud Dedicated.
    • INFLUX_DB_CLUSTER_ID Cluster ID required for Cloud Dedicated.

    Las descripciones siguen en el inglés original.

  4. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de InfluxDB 3, INFLUX_DB_TOKEN, INFLUX_DB_MANAGEMENT_TOKEN, INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de Cursor en modo Agent

  7. Pruébalo

    Usa InfluxDB 3 y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando InfluxDB 3 o muestra una herramienta de InfluxDB 3 en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • INFLUX_MCP_TOOL_PROFILE Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools. · valor por defecto operator

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de InfluxDB 3 (créala en el sitio del autor) · 4 ajuste(s) que rellenar (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de InfluxDB 3

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 4 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • INFLUX_DB_PRODUCT_TYPE InfluxDB edition or service; use its runtime configuration value.
    • INFLUX_DB_INSTANCE_URL InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.
    • INFLUX_DB_ACCOUNT_ID Account ID required when using a management token with Cloud Dedicated.
    • INFLUX_DB_CLUSTER_ID Cluster ID required for Cloud Dedicated.

    Las descripciones siguen en el inglés original.

  4. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de InfluxDB 3, INFLUX_DB_TOKEN, INFLUX_DB_MANAGEMENT_TOKEN, INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de VS Code en modo Agent

  7. Pruébalo

    Usa InfluxDB 3 y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando InfluxDB 3 o muestra una herramienta de InfluxDB 3 en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • INFLUX_MCP_TOOL_PROFILE Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools. · valor por defecto operator

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa InfluxDB 3💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user influxdb3 --env INFLUX_DB_PRODUCT_TYPE=your-value --env INFLUX_DB_TOKEN=your-value --env INFLUX_DB_INSTANCE_URL=your-value --env INFLUX_DB_MANAGEMENT_TOKEN=your-value --env INFLUX_DB_ACCOUNT_ID=your-value --env INFLUX_DB_CLUSTER_ID=your-value -- npx -y @influxdata/influxdb3-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "influxdb3": {
      "command": "npx",
      "args": [
        "-y",
        "@influxdata/influxdb3-mcp-server"
      ],
      "env": {
        "INFLUX_DB_PRODUCT_TYPE": "your-value",
        "INFLUX_DB_TOKEN": "your-value",
        "INFLUX_DB_INSTANCE_URL": "your-value",
        "INFLUX_DB_MANAGEMENT_TOKEN": "your-value",
        "INFLUX_DB_ACCOUNT_ID": "your-value",
        "INFLUX_DB_CLUSTER_ID": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "influxdb3": {
      "command": "npx",
      "args": [
        "-y",
        "@influxdata/influxdb3-mcp-server"
      ],
      "env": {
        "INFLUX_DB_PRODUCT_TYPE": "your-value",
        "INFLUX_DB_TOKEN": "your-value",
        "INFLUX_DB_INSTANCE_URL": "your-value",
        "INFLUX_DB_MANAGEMENT_TOKEN": "your-value",
        "INFLUX_DB_ACCOUNT_ID": "your-value",
        "INFLUX_DB_CLUSTER_ID": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "influxdb3": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@influxdata/influxdb3-mcp-server"
      ],
      "env": {
        "INFLUX_DB_PRODUCT_TYPE": "your-value",
        "INFLUX_DB_TOKEN": "your-value",
        "INFLUX_DB_INSTANCE_URL": "your-value",
        "INFLUX_DB_MANAGEMENT_TOKEN": "your-value",
        "INFLUX_DB_ACCOUNT_ID": "your-value",
        "INFLUX_DB_CLUSTER_ID": "your-value"
      }
    }
  }
}

Valores que debes completar

  • INFLUX_DB_PRODUCT_TYPE obligatorio env
    InfluxDB edition or service; use its runtime configuration value.
  • INFLUX_DB_TOKEN secreto obligatorio env
    Operator, admin, resource or database token. Required for Core, Enterprise and Cloud Serverless; needed for query/write on Cloud Dedicated and Clustered.
  • INFLUX_DB_INSTANCE_URL obligatorio env
    InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.
  • INFLUX_DB_MANAGEMENT_TOKEN secreto obligatorio env
    Management API token for Cloud Dedicated or Clustered. Provide this or INFLUX_DB_TOKEN, or both for full functionality.
  • INFLUX_DB_ACCOUNT_ID obligatorio env
    Account ID required when using a management token with Cloud Dedicated.
  • INFLUX_DB_CLUSTER_ID obligatorio env
    Cluster ID required for Cloud Dedicated.
  • INFLUX_MCP_TOOL_PROFILE env
    Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools.

Las descripciones siguen en el inglés original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
476/sem
Licenciai
Sin licencia indicada
Conexión
Se ejecuta en tu computadora
Última versióni
2.0.1
Publicado en el registroi
30 oct 2026
Último cambio de códigoi
12 nov 2026
Creador
influxdata
Paquetes
npm: @influxdata/influxdb3-mcp-server
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 14 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub influxdata, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: anteayer

  • ! Precaución

    Tiene licencia

    GitHub no pudo identificar el tipo de licencia; abre el archivo para comprobarlo

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Bases de datos y conjuntos de datosi

  • Más estrellas que el 96% de los otros 1193 servidores de esta categoría
  • Publicado en el registro más recientemente que el 73% de los otros 1193 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 51% de los otros 1193 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro InfluxDB 3?

Superó 2 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: INFLUX_DB_TOKEN, INFLUX_DB_MANAGEMENT_TOKEN

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez anteayer, y la última versión (2.0.1) llegó al registro hace 15 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Dbx, MCP Toolbox for Databases, MCP Toolbox for Databases

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Dbx

Query databases from AI agents using connections configured in DBX.

de t8y2Muy usado↓ 9,4 mil/sem★ 30,3 milActualizado hace 6 meses

Se ejecuta en tu computadora

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

de googleapisMuy usado★ 16,9 milActualizado ayer

Se ejecuta en tu computadora

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

de googleapisMuy usado★ 16,9 milActualizado hace 8 meses

Se ejecuta en tu computadora

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

InfluxDB 3 MCP Server

Model Context Protocol (MCP) server for InfluxDB 3 integration. Provides tools, resources, and prompts for interacting with InfluxDB 3 Core and Enterprise, plus InfluxDB Cloud Dedicated, InfluxDB Clustered, and InfluxDB Cloud Serverless via MCP clients.


Prerequisites

  • InfluxDB 3 Instance: URL and token (Core/Enterprise/Cloud Serverless) or Cluster ID and tokens (Cloud Dedicated/Clustered)
  • Node.js: 22.23.4 or a later 22.x, 24.22.1 or a later 24.x, or 26.12.1 or newer (for npm/npx usage)
  • pnpm: use the version pinned in package.json for local development. Run corepack enable to activate it.
  • Docker: (for Docker-based setup)

Node.js verifies TLS servers with a root certificate store built into the node binary. Earlier releases include roots that chain to compromised eMudhra/emSign intermediate CAs. The Docker image uses the latest Node.js 24 release. npm/npx installations use your local Node.js, so update it to a release listed above. Node.js 20 is end of life and has no fixed release.


Migrating to 2.0

Version 2.0 changes query result envelopes, health-check output, argument errors, and telemetry. Clients that parse these responses must follow the read-only output contract. Read metadata.completeness, caps, and warnings before treating query results as a complete answer. Discovery metadata states its source and leaves unavailable values unknown. Tool names and configured profiles remain available.

Read-only Agent Workflows

Set INFLUX_MCP_TOOL_PROFILE=readonly to give an MCP client tools that explore and query data. The profile leaves out every tool that writes data, administers databases, manages tokens, or runs on the host.

Credentials

Set INFLUX_DB_TOKEN to an admin token, a scoped token, or an Enterprise user-authentication JWT. The server sends it in a Bearer header without inspecting it, so the token's permissions decide which databases the tools can read.

Query arguments

query_sql and query_influxql accept database for db and query for q. A call that gives both names with different values fails with invalid_arguments. Every argument error is a structured tool error and is recorded in telemetry.

Discovery

list_databases returns what the server lists, with visibility: "unknown", because a listed database might still be unreadable. health_check returns JSON with separate health and ping outcomes. A scoped token can be denied both checks and still read its databases.

investigate_database keeps each table's result even when another table fails, and reports how many tables it saw and whether it stopped early. Samples come from a time window, 24 hours by default; set sampleWindowHours to change it. An empty window doesn't mean the table is empty. On Core and Enterprise, describe_table and investigation use system.influxdb_schema for authoritative column roles. They also read schema mode and deletion status from the _internal catalog when the same credential permits it, reporting source: "server" and the catalog table name. Unavailable values stay unknown; catalog denial does not discard readable column metadata or samples. Without authoritative deletion metadata, a table name with a timestamp-shaped suffix gets an advisory possibly_deleted warning and stays listed. Cardinality estimates aren't supported yet.

Errors

When a call fails, read error.code, error.recovery, and error.retryable:

  • A 403 is not_found_or_denied. A token without access gets 403 whether or not the database exists.
  • A 404 is not_found.
  • A SQL query that names an unknown table has recovery: "fix_reference". Call list_tables or describe_table for the right name.
  • A query that runs out of server memory has recovery: "narrow".
  • A query sent to an Enterprise ingest-only node has recovery: "change_endpoint".
  • Other server failures have recovery: "none".

EXPLAIN ANALYZE runs the query within the same bounds and adds a diagnostic_execution warning.

Analyst explores an unfamiliar database

An analyst can connect an MCP client such as Claude Desktop, Cursor, Codex, or another agent harness and ask a question like:

Which sensors had the highest average temperature in the last 24 hours?

With the read-only profile, the agent can:

  1. Call list_databases to see accessible databases.
  2. Call list_tables and describe_table to discover measurements and columns.
  3. Treat uncertain tag and field categories as unknown.
  4. Build a bounded SQL query with db, q, and optional params.
  5. Call query_sql with structured JSON output.
  6. Return the result, row count, truncation status, warnings, and correlation metadata.

The user gets a grounded answer and a reusable query while the agent explores and queries data without access to mutation or administration tools.

Operator investigates an InfluxQL dashboard query

An operator can troubleshoot an existing InfluxQL dashboard panel and ask:

Why did this panel stop showing data after the deploy?

With the read-only profile, the agent can:

  1. Keep the user's query in InfluxQL and call query_influxql.
  2. Use SHOW queries and schema discovery to verify the measurement and referenced columns.
  3. Sample recent rows with bounded reads to distinguish missing data from a broken query.
  4. Reject unsafe follow-up attempts, such as SELECT INTO or destructive statements.
  5. Return request_id, query_id, and query_id_source so the operator can correlate the MCP result with system.queries.id when query history is available.
  6. Emit structured logs to stderr for stdio transports so stdout remains reserved for MCP protocol messages.

The user gets a practical diagnosis, such as missing data, renamed schema, a wrong time predicate, or a query failure. The investigation is traceable without logging full query text by default.


Available Tools

Tool NameDescriptionAvailability
load_database_contextLoad optional custom database context and documentationAll versions
get_helpGet help and troubleshooting guidance for InfluxDB operationsAll versions
write_line_protocolWrite data using InfluxDB line protocolAll versions
create_databaseCreate a new database (with cloud-specific config options)All versions
update_databaseUpdate database configuration (retention for all; maxTables/maxColumns for Cloud Dedicated/Clustered)All versions
delete_databaseDelete a database by name (irreversible)All versions
execute_queryDeprecated since 2.0.0. Use query_sql. Retained for compatibilityAll versions
query_sqlRun bounded read-only SQL with structured response metadataAll versions
query_influxqlRun bounded read-only InfluxQL with structured response metadataAll versions
get_measurementsList all measurements (tables) in a databaseAll versions
get_measurement_schemaGet schema (columns/types) for a measurement/tableAll versions
list_tablesList tables, also called measurements, in a databaseAll versions
describe_tableDescribe table schema with conservative column categoriesAll versions
investigate_databaseRun high-level read-only database discovery and samplingAll versions
create_admin_tokenCreate a named admin token with an optional expirationCore/Enterprise only
list_admin_tokensList all admin tokens (with optional filtering)Core/Enterprise only
create_resource_tokenCreate a resource token for specific DBs and permissionsEnterprise only
list_resource_tokensList all resource tokens (with filtering and ordering)Enterprise only
delete_tokenDelete a token by nameCore/Enterprise only
regenerate_operator_tokenRegenerate the operator token (dangerous/irreversible)Core/Enterprise only
cloud_list_database_tokensList all database tokens for Cloud-Dedicated/Clustered clusterCloud Dedicated/Clustered
cloud_get_database_tokenGet details of a specific database token by IDCloud Dedicated/Clustered
cloud_create_database_tokenCreate a new database token for Cloud-Dedicated/Clustered clusterCloud Dedicated/Clustered
cloud_update_database_tokenUpdate an existing database tokenCloud Dedicated/Clustered
cloud_delete_database_tokenDelete a database token from Cloud-Dedicated/Clustered clusterCloud Dedicated/Clustered
list_databasesList all available databases in the instanceAll versions
health_checkCheck InfluxDB connection and health statusAll versions

Available Resources

Resource NameDescription
influx-configRead-only access to InfluxDB configuration
influx-statusReal-time connection and health status

| influx-databases | List of all databases in the instan

Solo se muestra el principio; lee el resto en el repo