Marketstack MCP Server

Instructions

Implementation Reference

• src/tools/referenceData/getExchangeDetails.ts:18-37 (handler)

  The async handler function that fetches exchange details for a given MIC using the Marketstack client by constructing the endpoint `exchanges/${mic}` and calling client.fetchApiData.

  const getExchangeDetailsHandler = async (input: Input, client: MarketstackClient): Promise<Output> => {
    try {
      const { mic } = input;
  
      // Construct the endpoint path with the MIC
      const endpoint = `exchanges/${mic}`;
  
      const apiRequestParams: MarketstackApiParams = {
        endpoint,
      };
  
      const data = await client.fetchApiData(apiRequestParams);
  
      return data;
    } catch (error: unknown) {
      console.error('getExchangeDetails tool error:', error);
      const message = error instanceof Error ? error.message : 'An unknown error occurred.';
      throw new Error(`getExchangeDetails tool failed: ${message}`);
    }
  };

• src/tools/referenceData/getExchangeDetails.ts:5-11 (schema)

  Zod input schema shape defining the required 'mic' string parameter for the tool.

  const getExchangeDetailsInputSchemaShape = {
    mic: z
      .string()
      .describe(
        'Obtain information about a specific stock exchange by attaching its MIC identification to your API request URL, e.g. `XNAS`.'
      ),
  };

• src/tools/referenceData/index.ts:50-55 (registration)

  Registers the 'get_exchange_details' tool with the MCP server, providing name, description, input schema, and a wrapped handler function.

  server.tool(
    getExchangeDetailsTool.name,
    getExchangeDetailsTool.description,
    getExchangeDetailsTool.inputSchemaShape,
    wrapToolHandler((input) => getExchangeDetailsTool.handler(input, client))
  );