The Aleph MCP

Instructions

Implementation Reference

• src/tools.js:333-352 (handler)

  The main handler function that fetches summary statistics from the API client and formats the response as a markdown summary.

  async summaryStats(params) {
    try {
      const result = await this.client.getSummaryStats();
  
      let response = '📈 API Usage Summary\n\n';
  
      if (typeof result === 'object') {
        for (const [key, value] of Object.entries(result)) {
          response += `**${key}:** ${JSON.stringify(value, null, 2)}\n`;
        }
      } else {
        response += `${JSON.stringify(result, null, 2)}`;
      }
  
      return response;
  
    } catch (error) {
      return `❌ Failed to retrieve summary statistics: ${error.message}`;
    }
  }

• src/tools.js:59-67 (schema)

  Tool schema definition including name, description, and empty input schema (no parameters required).

  {
    name: 'thealeph_summary_stats',
    description: 'Get a quick summary of API usage statistics',
    inputSchema: {
      type: 'object',
      properties: {},
      required: []
    }
  },

• src/tools.js:234-235 (registration)

  Tool registration in the executeTool switch statement, dispatching to the summaryStats handler.

  case 'thealeph_summary_stats':
    return this.summaryStats(params);

• src/client.js:93-96 (helper)

  API client helper method that makes the HTTP GET request to the summary stats endpoint.

   * Get summary statistics
   */
  async getSummaryStats() {
    return this.makeRequest('GET', '/monitoring/stats/summary');