Stock Market MCP Server

Instructions

Implementation Reference

• src/index.ts:150-174 (handler)

  Implements the core logic to fetch the latest intraday stock price for the given ticker symbol using the Alpha Vantage TIME_SERIES_INTRADAY API endpoint and formats the response as JSON.

  private async handleGetTickerPrice(args: any) {
    const response = await this.axiosInstance.get('', {
      params: {
        function: 'TIME_SERIES_INTRADAY',
        symbol: args.symbol,
        interval: '1min',
        outputsize: 'compact'
      }
    });
  
    const latestData = response.data['Time Series (1min)'];
    const latestTimestamp = Object.keys(latestData)[0];
    const price = latestData[latestTimestamp]['1. open'];
  
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          symbol: args.symbol,
          price: price,
          timestamp: latestTimestamp
        }, null, 2)
      }]
    };
  }

• src/index.ts:56-65 (schema)

  Input schema definition for the get_ticker_price tool, specifying an object with a required 'symbol' string property.

  inputSchema: {
    type: 'object',
    properties: {
      symbol: {
        type: 'string',
        description: 'Stock ticker symbol'
      }
    },
    required: ['symbol']
  }

• src/index.ts:53-66 (registration)

  Tool registration in the ListTools response, including name, description, and schema.

  {
    name: 'get_ticker_price',
    description: 'Get current price for a stock ticker',
    inputSchema: {
      type: 'object',
      properties: {
        symbol: {
          type: 'string',
          description: 'Stock ticker symbol'
        }
      },
      required: ['symbol']
    }
  },

• src/index.ts:114-115 (registration)

  Switch case in CallToolRequest handler that routes get_ticker_price calls to the handler function.

  case 'get_ticker_price':
    return await this.handleGetTickerPrice(request.params.arguments);