Statelessor MCP Server

Instructions

Implementation Reference

• tools/get-findings.js:20-58 (handler)

  The execute function implementing the core logic of the 'get_project_findings' tool: parses input, fetches findings via API client, formats or returns error response.

  async execute(args) {
    try {
      const { projectName } = args;
  
      // Call Statelessor API
      const findings = await apiClient.getProjectFindings(projectName);
  
      if (!findings || findings.length === 0) {
        return {
          content: [
            {
              type: 'text',
              text: `No historical findings found for project: ${projectName}`,
            },
          ],
        };
      }
  
      // Format findings
      return {
        content: [
          {
            type: 'text',
            text: resultFormatter.formatHistoricalFindings(findings, projectName),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error retrieving findings: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  },

• tools/get-findings.js:5-18 (schema)

  Tool definition object containing name, description, and input schema for validation.

  definition: {
    name: 'get_project_findings',
    description: 'Retrieve historical analysis findings for a project',
    inputSchema: {
      type: 'object',
      properties: {
        projectName: {
          type: 'string',
          description: 'Name of the project',
        },
      },
      required: ['projectName'],
    },
  },

• mcp-server.js:61-62 (registration)

  MCP server switch case that registers and dispatches calls to the getFindingsTool handler.

  case 'get_project_findings':
    return await getFindingsTool.execute(args);

• utils/api-client.js:105-119 (helper)

  Supporting API client method that performs HTTP GET to retrieve project findings from the backend service.

  async getProjectFindings(projectName) {
    const requestId = this.generateRequestId();
    
    try {
      const response = await this.client.get(`/findings/${projectName}`, {
        headers: {
          'X-Request-ID': requestId,
        },
      });
  
      return response.data;
    } catch (error) {
      throw this.handleError(error, 'getProjectFindings');
    }
  }