Unleash MCP (Feature Toggle)

Instructions

Implementation Reference

• src/tools/get-project-features.ts:18-60 (handler)

  The handler function that executes the tool logic: fetches project features using the helper function and returns formatted JSON response or error.

  export async function handleGetProjectFeatures(params: {
    projectId: string;
  }) {
    try {
      // Get the project features
      const features = await getProjectFeatures(params.projectId);
      
      if (!features) {
        return {
          content: [{ 
            type: "text", 
            text: JSON.stringify({ 
              success: false,
              error: `Failed to fetch features for project '${params.projectId}'` 
            }, null, 2)
          }],
          isError: true
        };
      }
      
      return {
        content: [{ 
          type: "text", 
          text: JSON.stringify({ 
            success: true,
            message: `Successfully fetched features for project '${params.projectId}'`,
            features: features
          }, null, 2)
        }]
      };
    } catch (error: any) {
      return {
        content: [{ 
          type: "text", 
          text: JSON.stringify({ 
            success: false,
            error: error.message 
          }, null, 2)
        }],
        isError: true
      };
    }
  }

• src/tools/get-project-features.ts:11-13 (schema)

  Input schema validation using Zod for the projectId parameter.

  export const GetProjectFeaturesParamsSchema = {
    projectId: z.string().min(1)
  };

• src/server.ts:143-148 (registration)

  Registration of the getProjectFeatures tool in the MCP server using server.tool().

  server.tool(
    getProjectFeaturesTool.name,
    getProjectFeaturesTool.description,
    getProjectFeaturesTool.paramsSchema as any,
    getProjectFeaturesTool.handler as any
  );

• src/unleash/get-project-features.ts:9-18 (helper)

  Helper function that performs the actual API call to retrieve project features from Unleash.

  export async function getProjectFeatures(projectId: string): Promise<any[] | null> {
    try {
      const response = await client.get(`/api/admin/projects/${projectId}/features`);
      logger.info(`Successfully fetched features for project ${projectId}`);
      return response.data.features || response.data;
    } catch (error) {
      logger.error(`Error fetching features for project ${projectId}:`, error);
      return null;
    }
  }