Flipt MCP Server

Implementation Reference

• src/index.ts:43-69 (handler)

  Inline asynchronous handler function that executes the core logic of the 'create_namespace' tool: invokes fliptClient.createNamespace with provided arguments, formats the success response as MCP content with JSON serialization and metadata URI, or returns an error response.

  async args => {
    try {
      const namespace = await fliptClient.createNamespace(args.key, args.name, args.description);
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(namespace, null, 2),
          },
        ],
        _meta: {
          uri: `flipt://namespaces/${args.key}`,
        },
      };
    } catch (error: any) {
      console.error('Error creating namespace:', error);
      return {
        content: [
          {
            type: 'text',
            text: `Failed to create namespace: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/index.ts:38-42 (schema)

  Zod schema for input validation of the 'create_namespace' tool parameters: requires non-empty string keys and names, optional description.

  {
    key: z.string().min(1),
    name: z.string().min(1),
    description: z.string().optional(),
  },

• src/index.ts:36-70 (registration)

  Registration of the 'create_namespace' MCP tool on the McpServer instance, including name, input schema, and inline handler function.

  server.tool(
    'create_namespace',
    {
      key: z.string().min(1),
      name: z.string().min(1),
      description: z.string().optional(),
    },
    async args => {
      try {
        const namespace = await fliptClient.createNamespace(args.key, args.name, args.description);
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(namespace, null, 2),
            },
          ],
          _meta: {
            uri: `flipt://namespaces/${args.key}`,
          },
        };
      } catch (error: any) {
        console.error('Error creating namespace:', error);
        return {
          content: [
            {
              type: 'text',
              text: `Failed to create namespace: ${error.message}`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/services/fliptClient.ts:69-81 (helper)

  Helper method in FliptClient service class that wraps the generated NamespacesServiceApi.createNamespace call to perform the actual namespace creation via the Flipt API, handling errors.

  async createNamespace(key: string, name: string, description?: string) {
    try {
      const response = await this.namespacesApi.createNamespace({
        key,
        name,
        description,
      });
      return response;
    } catch (error) {
      console.error('Error creating namespace:', error);
      throw error;
    }
  }