search_addresses_semantic
Find Ethereum addresses using AI-powered semantic search that understands natural language queries and matches based on meaning rather than exact text.
Instructions
Semantic search for Ethereum addresses using AI-powered vector similarity matching
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The query to search for | |
| limit | No | The number of results to return (default: 10) |
Implementation Reference
- index.js:687-688 (handler)Handler for the 'search_addresses_semantic' tool. It forwards the tool arguments to the ChainFetch API's semantic search endpoint for Ethereum addresses via the shared makeRequest method.
case 'search_addresses_semantic': return await this.makeRequest('/api/v1/ethereum/addresses/semantic_search', 'GET', args, null, token); - index.js:41-59 (registration)Tool registration entry in the listTools response, including name, description, and input schema definition.
{ name: 'search_addresses_semantic', description: 'Semantic search for Ethereum addresses using AI-powered vector similarity matching', inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'The query to search for', }, limit: { type: 'integer', description: 'The number of results to return (default: 10)', default: 10, }, }, required: ['query'], }, }, - index.js:44-58 (schema)Input schema definition for the search_addresses_semantic tool, specifying query (required) and optional limit parameters.
inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'The query to search for', }, limit: { type: 'integer', description: 'The number of results to return (default: 10)', default: 10, }, }, required: ['query'], }, - index.js:634-682 (helper)Shared helper method used by all tools, including search_addresses_semantic, to make authenticated API requests to the ChainFetch backend.
async makeRequest(endpoint, method = 'GET', params = {}, body = null, token = null) { const chainfetchToken = token || process.env.CHAINFETCH_API_TOKEN; if (!chainfetchToken) { throw new McpError( ErrorCode.InvalidRequest, 'CHAINFETCH_API_TOKEN is required' ); } const url = new URL(`${API_BASE_URL}${endpoint}`); // Add query parameters for GET requests if (method === 'GET' && Object.keys(params).length > 0) { Object.entries(params).forEach(([key, value]) => { if (value !== undefined && value !== null) { if (Array.isArray(value)) { value.forEach(v => url.searchParams.append(`${key}[]`, v)); } else { url.searchParams.append(key, value.toString()); } } }); } const fetchOptions = { method, headers: { 'Authorization': `Bearer ${chainfetchToken}`, 'Content-Type': 'application/json', }, }; if (body && method !== 'GET') { fetchOptions.body = JSON.stringify(body); } const response = await fetch(url.toString(), fetchOptions); if (!response.ok) { const errorText = await response.text(); throw new McpError( ErrorCode.InternalError, `API request failed: ${response.status} ${response.statusText} - ${errorText}` ); } return await response.json(); }