Stock Market MCP Server

Instructions

Implementation Reference

• src/index.ts:221-235 (handler)

  The handler function that executes the tool logic: fetches company overview data from Alpha Vantage API using the 'OVERVIEW' endpoint and returns the JSON response.
  private async handleGetCompanyOverview(args: { symbol: string }) { const response = await this.axiosInstance.get('', { params: { function: 'OVERVIEW', symbol: args.symbol } }); return { content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }] }; }
• src/index.ts:97-106 (schema)

  Input schema definition for the get_company_overview tool, specifying the required 'symbol' parameter.
  inputSchema: { type: 'object', properties: { symbol: { type: 'string', description: 'Stock ticker symbol' } }, required: ['symbol'] }
• src/index.ts:94-107 (registration)

  Tool registration in the ListTools response, including name, description, and schema.
  { name: 'get_company_overview', description: 'Get company overview and key metrics', inputSchema: { type: 'object', properties: { symbol: { type: 'string', description: 'Stock ticker symbol' } }, required: ['symbol'] } }
• src/index.ts:125-131 (registration)

  Dispatch/registration logic in CallToolRequest handler that validates input and calls the tool handler.
  case 'get_company_overview': { if (!request.params.arguments || typeof request.params.arguments !== 'object') { throw new McpError(ErrorCode.InvalidParams, 'Invalid arguments'); } const args = request.params.arguments as { symbol: string }; return await this.handleGetCompanyOverview(args); }