Marketstack MCP Server

Instructions

Implementation Reference

• src/tools/referenceData/getTickerDetails.ts:24-44 (handler)

  The asynchronous handler function that destructures input, builds the /tickers/{symbol} endpoint, optionally adds exchange param, fetches data via Marketstack client, and handles errors.

  const getTickerDetailsHandler = async (input: Input, client: MarketstackClient): Promise<Output> => {
    try {
      const { symbol, exchange } = input;
  
      // Construct the endpoint path with the symbol
      let endpoint = `tickers/${symbol}`;
  
      const apiRequestParams: MarketstackApiParams = {
        endpoint,
        ...(exchange && { exchange }), // Include if exchange is provided
      };
  
      const data = await client.fetchApiData(apiRequestParams);
  
      return data;
    } catch (error: unknown) {
      console.error('getTickerDetails tool error:', error);
      const message = error instanceof Error ? error.message : 'An unknown error occurred.';
      throw new Error(`getTickerDetails tool failed: ${message}`);
    }
  };

• src/tools/referenceData/getTickerDetails.ts:5-17 (schema)

  Zod input schema shape defining required 'symbol' string and optional 'exchange' string with descriptions.

  const getTickerDetailsInputSchemaShape = {
    symbol: z
      .string()
      .describe('Obtain information about a specific ticker symbol by attach it to your API request URL, e.g. `AAPL`.'),
    exchange: z
      .string()
      .optional()
      .describe(
        'To filter your results based on a specific stock exchange, use this parameter to specify the MIC identification of a stock exchange. Example: `XNAS`'
      ),
    // Note: The documentation mentions limit and offset for the /tickers endpoint, but it seems to apply
    // when listing multiple tickers, not getting details for a single one. We'll omit them for this tool.
  };

• src/tools/referenceData/index.ts:22-27 (registration)

  Registers the 'get_ticker_details' tool on the MCP server using its name, description, input schema, and a wrapped version of its handler that injects the Marketstack client.

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

• src/tools/referenceData/getTickerDetails.ts:54-59 (helper)

  Exports the tool definition object bundling the name, description, input schema shape, and handler function for use in registration.

  export const getTickerDetailsTool: MarketstackToolDefinition = {
    name: 'get_ticker_details',
    description: 'Obtain information about a specific ticker symbol.',
    inputSchemaShape: getTickerDetailsInputSchemaShape,
    handler: getTickerDetailsHandler,
  };