Marketstack MCP Server

Instructions

Implementation Reference

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

  The async handler function that implements the core logic of the 'get_bond_info' tool, fetching government bond data for a specified country using the MarketstackClient API.
  const getBondInfoHandler = async (input: Input, client: MarketstackClient): Promise<Output> => { try { const { country } = input; const apiRequestParams: MarketstackApiParams = { endpoint: 'bond', country, }; const data = await client.fetchApiData(apiRequestParams); return data; } catch (error: unknown) { console.error('getBondInfo tool error:', error); const message = error instanceof Error ? error.message : 'An unknown error occurred.'; throw new Error(`getBondInfo tool failed: ${message}`); } };
• src/tools/financialInstruments/getBondInfo.ts:5-7 (schema)

  The Zod input schema shape for the 'get_bond_info' tool, defining the required 'country' parameter.
  const getBondInfoInputSchemaShape = { country: z.string().describe('Specify your country for your request, e.g. kenya or united%20states'), };
• src/tools/financialInstruments/index.ts:41-46 (registration)

  The registration of the 'get_bond_info' tool on the MCP server using server.tool(), wrapping the handler with wrapToolHandler.
  server.tool( getBondInfoTool.name, getBondInfoTool.description, getBondInfoTool.inputSchemaShape, wrapToolHandler((input) => getBondInfoTool.handler(input, client)) );
• src/tools/financialInstruments/getBondInfo.ts:41-46 (schema)

  The tool definition object exporting the name, description, schema, and handler for 'get_bond_info', used in registration.
  export const getBondInfoTool: MarketstackToolDefinition = { name: 'get_bond_info', description: 'Get real-time government bond data for a specific country.', inputSchemaShape: getBondInfoInputSchemaShape, handler: getBondInfoHandler, };