Unofficial PubChem MCP Server

Instructions

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))
    );
  };