Flipt MCP Server

Implementation Reference

• src/index.ts:165-196 (registration)

  Registration of the 'list_flags' MCP tool, including inline Zod input schema and handler function that fetches flags via fliptClient and returns formatted text content with metadata URI.

  server.tool(
    'list_flags',
    {
      namespaceKey: z.string().min(1),
    },
    async args => {
      try {
        const flags = await fliptClient.listFlags(args.namespaceKey);
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(flags, null, 2),
            },
          ],
          _meta: {
            uri: `flipt://namespaces/${args.namespaceKey}/flags`,
          },
        };
      } catch (error: any) {
        console.error(`Error listing flags for namespace ${args.namespaceKey}:`, error);
        return {
          content: [
            {
              type: 'text',
              text: `Failed to list flags: ${error.message}`,
            },
          ],
          isError: true,
        };
      }
    }

• src/index.ts:170-170 (handler)

  The inline handler function for the 'list_flags' tool that executes the logic: calls fliptClient.listFlags, formats as JSON text content, includes URI metadata, handles errors.

  async args => {

• src/index.ts:168-169 (schema)

  Zod input schema for the 'list_flags' tool requiring a non-empty namespaceKey string.

    namespaceKey: z.string().min(1),
  },

• src/services/fliptClient.ts:192-204 (helper)

  Helper method in FliptClient that calls the generated FlagsServiceApi.listFlags to retrieve flags for a namespace, with error handling and response normalization.

  async listFlags(namespaceKey: string) {
    try {
      const response = await this.flagsApi.listFlags(namespaceKey);
      if (response && response.flags) {
        return response.flags;
      } else {
        console.error('Unexpected response structure:', response);
        return [];
      }
    } catch (error) {
      console.error(`Error getting flags for namespace ${namespaceKey}:`, error);
      return [];
    }