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);
  }