Marketstack MCP Server

Instructions

Implementation Reference

• src/tools/financialInstruments/getIndexInfo.ts:14-31 (handler)

  The main handler function that executes the tool logic by fetching index information from the Marketstack API using the provided index identifier.

  const getIndexInfoHandler = async (input: Input, client: MarketstackClient): Promise<Output> => {
    try {
      const { index } = input;
  
      const apiRequestParams: MarketstackApiParams = {
        endpoint: 'indexinfo',
        index,
      };
  
      const data = await client.fetchApiData(apiRequestParams);
  
      return data;
    } catch (error: unknown) {
      console.error('getIndexInfo tool error:', error);
      const message = error instanceof Error ? error.message : 'An unknown error occurred.';
      throw new Error(`getIndexInfo tool failed: ${message}`);
    }
  };

• src/tools/financialInstruments/getIndexInfo.ts:5-7 (schema)

  Zod input schema defining the required 'index' parameter for the tool.

  const getIndexInfoInputSchemaShape = {
    index: z.string().describe('Specify your benchmark/index id for your request, e.g. australia_all_ordinaries.'),
  };

• src/tools/financialInstruments/index.ts:27-32 (registration)

  MCP server registration of the 'get_index_info' tool, providing name, description, input schema, and wrapped handler.

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

• src/tools/financialInstruments/getIndexInfo.ts:41-46 (helper)

  Tool definition object that bundles the name, description, schema, and handler for use in registration.

  export const getIndexInfoTool: MarketstackToolDefinition = {
    name: 'get_index_info',
    description: 'Get details for a specific stock market index.',
    inputSchemaShape: getIndexInfoInputSchemaShape,
    handler: getIndexInfoHandler,
  };