The Aleph MCP

Instructions

Implementation Reference

• src/tools.js:439-458 (handler)

  The main handler function 'asnHints' that processes parameters, calls the API client, and formats the geographic hints response for the tool.

  async asnHints(params) {
    try {
      const { asn } = params;
      const result = await this.client.getASNHints(asn);
  
      let response = `💡 Geographic Hints for ASN ${asn}\n\n`;
  
      if (typeof result === 'object' && Object.keys(result).length > 0) {
        for (const [key, value] of Object.entries(result)) {
          response += `**${key}:** ${JSON.stringify(value, null, 2)}\n`;
        }
      } else {
        response += 'No hints available for this ASN.';
      }
  
      return response;
  
    } catch (error) {
      return `❌ Failed to retrieve ASN hints: ${error.message}`;
    }

• src/tools.js:112-124 (schema)

  The input schema definition for the 'thealeph_asn_hints' tool, specifying the required 'asn' string parameter.

  {
    name: 'thealeph_asn_hints',
    description: 'Get geographic and network hints for an ASN',
    inputSchema: {
      type: 'object',
      properties: {
        asn: {
          type: 'string',
          description: 'Autonomous System Number'
        }
      },
      required: ['asn']
    }

• src/tools.js:242-243 (registration)

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

  case 'thealeph_asn_hints':
    return this.asnHints(params);

• src/client.js:122-127 (helper)

  Helper method in the API client that performs the HTTP GET request to retrieve ASN hints from the backend API endpoint.

  /**
   * Get hints by ASN
   */
  async getASNHints(asn) {
    return this.makeRequest('GET', `/api/asn/${asn}/hints`);
  }