search_similar_compounds
Find chemically similar compounds using Tanimoto similarity by providing a SMILES string, similarity threshold, and maximum results to identify molecular analogs in PubChem's database.
Instructions
Find chemically similar compounds using Tanimoto similarity
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_records | No | Maximum number of results (1-10000, default: 100) | |
| smiles | Yes | SMILES string of the query molecule | |
| threshold | No | Similarity threshold (0-100, default: 90) |
Implementation Reference
- src/index.ts:981-1010 (handler)The main handler function that validates input using isValidSmilesArgs, performs a POST request to PubChem's similarity search endpoint with SMILES, threshold, and maxRecords, and returns the JSON response.private async handleSearchSimilarCompounds(args: any) { if (!isValidSmilesArgs(args)) { throw new McpError(ErrorCode.InvalidParams, 'Invalid similarity search arguments'); } try { const threshold = args.threshold || 90; const maxRecords = args.max_records || 100; const response = await this.apiClient.post('/compound/similarity/smiles/JSON', { smiles: args.smiles, Threshold: threshold, MaxRecords: maxRecords, }); return { content: [ { type: 'text', text: JSON.stringify(response.data, null, 2), }, ], }; } catch (error) { throw new McpError( ErrorCode.InternalError, `Failed to search similar compounds: ${error instanceof Error ? error.message : 'Unknown error'}` ); } }
- src/index.ts:442-453 (schema)Tool schema definition including input schema for SMILES, optional threshold and max_records, registered in the ListTools response.name: 'search_similar_compounds', description: 'Find chemically similar compounds using Tanimoto similarity', inputSchema: { type: 'object', properties: { smiles: { type: 'string', description: 'SMILES string of the query molecule' }, threshold: { type: 'number', description: 'Similarity threshold (0-100, default: 90)', minimum: 0, maximum: 100 }, max_records: { type: 'number', description: 'Maximum number of results (1-10000, default: 100)', minimum: 1, maximum: 10000 }, }, required: ['smiles'], }, },
- src/index.ts:754-755 (registration)Switch case in CallToolRequestSchema handler that routes calls to the search_similar_compounds tool to its handler function.case 'search_similar_compounds': return await this.handleSearchSimilarCompounds(args);
- src/index.ts:77-87 (helper)Input validation type guard used by the handler to validate smiles, threshold, and max_records parameters.args: any ): args is { smiles: string; threshold?: number; max_records?: number } => { return ( typeof args === 'object' && args !== null && typeof args.smiles === 'string' && args.smiles.length > 0 && (args.threshold === undefined || (typeof args.threshold === 'number' && args.threshold >= 0 && args.threshold <= 100)) && (args.max_records === undefined || (typeof args.max_records === 'number' && args.max_records > 0 && args.max_records <= 10000)) ); };