Stock Market MCP Server

Instructions

Implementation Reference

• src/index.ts:176-189 (handler)

  The main handler function for the get_market_report tool. It fetches the market status from the Alpha Vantage API (MARKET_STATUS function) using the pre-configured axios instance and returns the raw JSON response as a text content block.

  private async handleGetMarketReport() {
    const response = await this.axiosInstance.get('', {
      params: {
        function: 'MARKET_STATUS'
      }
    });
  
    return {
      content: [{
        type: 'text',
        text: JSON.stringify(response.data, null, 2)
      }]
    };
  }

• src/index.ts:67-74 (registration)

  Registration of the get_market_report tool in the ListToolsRequestSchema response. Defines name, description ('Generate US market report/briefing'), and inputSchema (empty object with no properties or required fields).

  {
    name: 'get_market_report',
    description: 'Generate US market report/briefing',
    inputSchema: {
      type: 'object',
      properties: {}
    }
  },

• src/index.ts:116-117 (registration)

  Dispatch logic in the CallToolRequestSchema handler: switch case for 'get_market_report' that invokes this.handleGetMarketReport().

  case 'get_market_report':
    return await this.handleGetMarketReport();