get_compound_synonyms
Retrieve all names and synonyms for a chemical compound using its PubChem CID to identify substances across different naming conventions.
Instructions
Get all names and synonyms for a compound
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cid | Yes | PubChem Compound ID (CID) |
Implementation Reference
- src/index.ts:958-979 (handler)The main execution handler for the get_compound_synonyms tool. Validates the input using isValidCidArgs, calls the PubChem API to retrieve synonyms for the given CID, and returns the JSON response as text content.
private async handleGetCompoundSynonyms(args: any) { if (!isValidCidArgs(args)) { throw new McpError(ErrorCode.InvalidParams, 'Invalid CID arguments'); } try { const response = await this.apiClient.get(`/compound/cid/${args.cid}/synonyms/JSON`); return { content: [ { type: 'text', text: JSON.stringify(response.data, null, 2), }, ], }; } catch (error) { throw new McpError( ErrorCode.InternalError, `Failed to get compound synonyms: ${error instanceof Error ? error.message : 'Unknown error'}` ); } } - src/index.ts:428-438 (registration)Tool registration in the ListToolsRequestSchema handler, defining the tool name, description, and input schema requiring a 'cid' parameter of type number or string.
{ name: 'get_compound_synonyms', description: 'Get all names and synonyms for a compound', inputSchema: { type: 'object', properties: { cid: { type: ['number', 'string'], description: 'PubChem Compound ID (CID)' }, }, required: ['cid'], }, }, - src/index.ts:431-437 (schema)Input schema definition for the get_compound_synonyms tool, specifying an object with a required 'cid' property that accepts number or string.
inputSchema: { type: 'object', properties: { cid: { type: ['number', 'string'], description: 'PubChem Compound ID (CID)' }, }, required: ['cid'], }, - src/index.ts:750-751 (registration)Dispatch case in the CallToolRequestSchema handler that routes calls to the get_compound_synonyms tool to its handler function.
case 'get_compound_synonyms': return await this.handleGetCompoundSynonyms(args); - src/index.ts:65-74 (helper)Helper validation function isValidCidArgs used by the handler to check input arguments, ensuring 'cid' is number or string and optional 'format' is valid.
const isValidCidArgs = ( args: any ): args is { cid: number | string; format?: string } => { return ( typeof args === 'object' && args !== null && (typeof args.cid === 'number' || typeof args.cid === 'string') && (args.format === undefined || ['json', 'sdf', 'xml', 'asnt', 'asnb'].includes(args.format)) ); };