create_rollout
Define and configure rollouts for feature flags in Flipt MCP Server by specifying namespace, flag key, rank, and optional segment or threshold rules for precise control and deployment.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | No | ||
| flagKey | Yes | ||
| namespaceKey | Yes | ||
| rank | Yes | ||
| segment | No | ||
| threshold | No |
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; }