Flipt MCP Server

Implementation Reference

• src/index.ts:1103-1134 (handler)

  The inline anonymous handler function for the 'create_rollout' MCP tool. It invokes the fliptClient service to create the rollout and returns the JSON response or an error message.

  async args => {
    try {
      const response = await fliptClient.createRollout(
        args.namespaceKey,
        args.flagKey,
        args.rank,
        args.description,
        args.segment,
        args.threshold
      );
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(response, null, 2),
          },
        ],
      };
    } catch (error: any) {
      console.error('Error creating rollout:', error);
      return {
        content: [
          {
            type: 'text',
            text: `Failed to create rollout: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/index.ts:1085-1102 (schema)

  Zod schema defining the input parameters and validation for the 'create_rollout' tool.

  {
    namespaceKey: z.string().min(1),
    flagKey: z.string().min(1),
    rank: z.number().int().min(1),
    description: z.string().optional(),
    segment: z
      .object({
        segmentKey: z.string().min(1),
        value: z.boolean().optional(),
      })
      .optional(),
    threshold: z
      .object({
        percentage: z.number().min(0).max(100),
        value: z.boolean(),
      })
      .optional(),
  },

• src/index.ts:1083-1135 (registration)

  Registration of the 'create_rollout' tool with the MCP server using server.tool(), including inline schema and handler.

  server.tool(
    'create_rollout',
    {
      namespaceKey: z.string().min(1),
      flagKey: z.string().min(1),
      rank: z.number().int().min(1),
      description: z.string().optional(),
      segment: z
        .object({
          segmentKey: z.string().min(1),
          value: z.boolean().optional(),
        })
        .optional(),
      threshold: z
        .object({
          percentage: z.number().min(0).max(100),
          value: z.boolean(),
        })
        .optional(),
    },
    async args => {
      try {
        const response = await fliptClient.createRollout(
          args.namespaceKey,
          args.flagKey,
          args.rank,
          args.description,
          args.segment,
          args.threshold
        );
  
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(response, null, 2),
            },
          ],
        };
      } catch (error: any) {
        console.error('Error creating rollout:', error);
        return {
          content: [
            {
              type: 'text',
              text: `Failed to create rollout: ${error.message}`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/services/fliptClient.ts:383-402 (helper)

  Helper method in FliptClient service that wraps the generated rolloutsApi.createRollout call to create a rollout.

  async createRollout(
    namespaceKey: string,
    flagKey: string,
    rank: number,
    description?: string,
    segment?: any,
    threshold?: any
  ) {
    try {
      const response = await this.rolloutsApi.createRollout(namespaceKey, flagKey, {
        rank,
        description,
        segment,
        threshold,
      });
      return response;
    } catch (error) {
      console.error('Error creating rollout:', error);
      throw error;
    }