InfluxDB MCP Server

Implementation Reference

• src/handlers/createOrgTool.js:4-35 (handler)

  The main handler function for the 'create-org' tool. It makes a POST request to the InfluxDB API to create a new organization with the given name and optional description, then returns the org details or an error message.

  export async function createOrg({ name, description }) {
    try {
      const orgData = {
        name,
        description,
      };
  
      const response = await influxRequest("/api/v2/orgs", {
        method: "POST",
        body: JSON.stringify(orgData),
      });
  
      const org = await response.json();
  
      return {
        content: [{
          type: "text",
          text:
            `Organization created successfully:\nID: ${org.id}\nName: ${org.name}\nDescription: ${org.description || "N/A"
            }`,
        }],
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: `Error creating organization: ${error.message}`,
        }],
        isError: true,
      };
    }
  }

• src/index.js:143-160 (registration)

  Registers the 'create-org' tool on the MCP server, including its name, description, input schema using Zod, and references the createOrg handler function.

  server.tool(
    "create-org",
    "Create a brand-new organization to isolate users or projects before generating buckets and tokens.",
    {
      name: z
        .string()
        .describe(
          "Display name for the organization as it should appear in InfluxDB Cloud/OSS.",
        ),
      description: z
        .string()
        .optional()
        .describe(
          "Optional free-form description that helps humans understand why the org exists.",
        ),
    },
    createOrg,
  );

• src/index.js:147-158 (schema)

  Zod schema defining the input parameters for the 'create-org' tool: required 'name' string and optional 'description' string.

    name: z
      .string()
      .describe(
        "Display name for the organization as it should appear in InfluxDB Cloud/OSS.",
      ),
    description: z
      .string()
      .optional()
      .describe(
        "Optional free-form description that helps humans understand why the org exists.",
      ),
  },