The Aleph MCP

Instructions

Implementation Reference

• src/tools.js:563-595 (handler)

  Main handler function for 'thealeph_batch_query_ptr' tool. Validates input, calls the API client, processes results, and formats the markdown response.

  async batchQueryPTR(params) {
    try {
      const { queries } = params;
  
      if (!queries || queries.length === 0) {
        return '❌ Please provide at least one query';
      }
  
      const result = await this.client.batchQueryPTR(queries);
  
      let response = `📦 Batch PTR Query Results (${queries.length} queries)\n\n`;
  
      if (Array.isArray(result)) {
        result.forEach((item, idx) => {
          response += `**Query ${idx + 1}:**\n`;
          if (item.ptr_record) response += `  - PTR: ${item.ptr_record}\n`;
          if (item.ip) response += `  - IP: ${item.ip}\n`;
          if (item.asn) response += `  - ASN: ${item.asn}\n`;
          if (item.location_info) {
            response += `  - Location: ${JSON.stringify(item.location_info)}\n`;
          }
          response += '\n';
        });
      } else {
        response += JSON.stringify(result, null, 2);
      }
  
      return response;
  
    } catch (error) {
      return `❌ Batch PTR query failed: ${error.message}`;
    }
  }

• src/tools.js:176-198 (schema)

  Input schema and metadata definition for the 'thealeph_batch_query_ptr' tool, used for MCP tool discovery.

  {
    name: 'thealeph_batch_query_ptr',
    description: 'Query multiple PTR records in a single batch request',
    inputSchema: {
      type: 'object',
      properties: {
        queries: {
          type: 'array',
          description: 'Array of query objects, each with optional ptr_record, ip, and/or asn',
          items: {
            type: 'object',
            properties: {
              ptr_record: { type: 'string' },
              ip: { type: 'string' },
              asn: { type: 'integer' }
            }
          },
          minItems: 1,
          maxItems: 100
        }
      },
      required: ['queries']
    }

• src/tools.js:250-251 (registration)

  Registration of the tool handler in the executeTool switch statement dispatcher.

  case 'thealeph_batch_query_ptr':
    return this.batchQueryPTR(params);

• src/client.js:158-162 (helper)

  API client helper method that sends the batch PTR queries to the Aleph API endpoint '/api/batch_query'.

  async batchQueryPTR(queries) {
    return this.makeRequest('POST', '/api/batch_query', {
      data: { queries }
    });
  }