Kong Konnect MCP Server

Instructions

Implementation Reference

• src/operations/configuration.ts:155-199 (handler)

  Executes the core logic of the list_plugins tool: calls the API to fetch plugins, transforms the raw response into a structured format with metadata, detailed plugin objects (including scoping to consumers/services/routes), and provides suggestions for related tools.

  export async function listPlugins(
    api: KongApi,
    controlPlaneId: string,
    size = 100,
    offset?: string
  ) {
    try {
      const result = await api.listPlugins(controlPlaneId, size, offset);
  
      // Transform the response to have consistent field names
      return {
        metadata: {
          controlPlaneId: controlPlaneId,
          size: size,
          offset: offset || null,
          nextOffset: result.offset,
          totalCount: result.total
        },
        plugins: result.data.map((plugin: any) => ({
          pluginId: plugin.id,
          name: plugin.name,
          enabled: plugin.enabled,
          config: plugin.config,
          protocols: plugin.protocols,
          tags: plugin.tags,
          scoping: {
            consumerId: plugin.consumer?.id,
            serviceId: plugin.service?.id,
            routeId: plugin.route?.id,
            global: (!plugin.consumer && !plugin.service && !plugin.route)
          },
          metadata: {
            createdAt: plugin.created_at,
            updatedAt: plugin.updated_at
          }
        })),
        relatedTools: [
          "Use list-services and list-routes to find entities these plugins are applied to",
          "Use query-api-requests to analyze traffic affected by these plugins"
        ]
      };
    } catch (error) {
      throw error;
    }
  }

• src/parameters.ts:102-112 (schema)

  Zod schema defining the input parameters for the list_plugins tool: controlPlaneId (required), size (optional, default 100, 1-1000), offset (optional). Used for validation in tool registration.

  export const listPluginsParameters = () => z.object({
    controlPlaneId: z.string()
      .describe("Control Plane ID (obtainable from list-control-planes tool)"),
    size: z.number().int()
      .min(1).max(1000)
      .default(100)
      .describe("Number of plugins to return"),
    offset: z.string()
      .optional()
      .describe("Offset token for pagination (from previous response)"),
  });

• src/tools.ts:56-62 (registration)

  Tool definition/registration metadata in the tools() array, including method name, name, description (from prompts), parameters schema, and category. This is used by index.ts to register the tool with MCP.

  {
    method: "list_plugins",
    name: "List Plugins",
    description: prompts.listPluginsPrompt(),
    parameters: parameters.listPluginsParameters(),
    category: "configuration"
  },

• src/api.ts:182-190 (helper)

  API client helper method that constructs the Kong API endpoint for listing plugins and makes the authenticated HTTP GET request, handling errors consistently.

  async listPlugins(controlPlaneId: string, size = 100, offset?: string): Promise<any> {
    let endpoint = `/control-planes/${controlPlaneId}/core-entities/plugins?size=${size}`;
    
    if (offset) {
      endpoint += `&offset=${offset}`;
    }
  
    return this.kongRequest<any>(endpoint);
  }

• src/index.ts:101-107 (registration)

  Tool dispatch/routing in the MCP server registration: matches the method name and calls the specific handler function with API client and parsed arguments.

  case "list_plugins":
    result = await configuration.listPlugins(
      this.api,
      args.controlPlaneId,
      args.size,
      args.offset
    );