list_etf_tickers
Retrieve a list of supported ETF tickers with customizable pagination limits and offsets for precise API requests through the Marketstack MCP Server.
Instructions
List all supported ETF tickers.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"list": "<list>"
},
"name": "list_etf_tickers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Specify a pagination limit (number of results per page) for your API request. Default limit value is `100`, maximum allowed limit value is `1000`. | |
| list | Yes | Specify your list as ticker for your request. | |
| offset | No | Specify a pagination offset value for your API request. Example: An offset value of `100` combined with a limit value of 10 would show results 100-110. Default value is `0`, starting with the first available result. |
Implementation Reference
- The main handler function that executes the tool logic by constructing API parameters and calling the Marketstack client to fetch ETF tickers.
const listEtfTickersHandler = async (input: Input, client: MarketstackClient): Promise<Output> => { try { const { list, limit, offset } = input; const apiRequestParams: MarketstackApiParams = { endpoint: 'etflist', list, ...(limit && { limit }), // Include if limit is provided ...(offset && { offset }), // Include if offset is provided }; const data = await client.fetchApiData(apiRequestParams); return data; } catch (error: unknown) { console.error('listEtfTickers tool error:', error); const message = error instanceof Error ? error.message : 'An unknown error occurred.'; throw new Error(`listEtfTickers tool failed: ${message}`); } }; - Zod input schema shape defining parameters for the list_etf_tickers tool: list (fixed to 'ticker'), optional limit, and offset.
const listEtfTickersInputSchemaShape = { list: z.literal('ticker').describe('Specify your list as ticker for your request.'), limit: z .number() .int() .min(1) .max(1000) .optional() .default(100) .describe( 'Specify a pagination limit (number of results per page) for your API request. Default limit value is `100`, maximum allowed limit value is `1000`.' ), offset: z .number() .int() .min(0) .optional() .default(0) .describe( 'Specify a pagination offset value for your API request. Example: An offset value of `100` combined with a limit value of 10 would show results 100-110. Default value is `0`, starting with the first available result.' ), }; - src/tools/financialInstruments/index.ts:48-53 (registration)Registration of the list_etf_tickers tool on the MCP server using server.tool, wrapping the handler with the Marketstack client.
server.tool( listEtfTickersTool.name, listEtfTickersTool.description, listEtfTickersTool.inputSchemaShape, wrapToolHandler((input) => listEtfTickersTool.handler(input, client)) ); - src/tools/financialInstruments/listEtfTickers.ts:62-67 (registration)Tool definition export that bundles name, description, schema, and handler for the list_etf_tickers tool.
export const listEtfTickersTool: MarketstackToolDefinition = { name: 'list_etf_tickers', description: 'List all supported ETF tickers.', inputSchemaShape: listEtfTickersInputSchemaShape, handler: listEtfTickersHandler, };