Status Invest MCP Server

Instructions

Implementation Reference

• src/interface/controllers/StatusInvestToolsController.ts:23-47 (registration)

  Registers the 'get-acoes' MCP tool with Zod input schema and inline async handler that delegates to StatusInvestService.getStockResume and formats response as JSON text.

  private registerGetStockToolHandler(): void {
    this.server.tool(
      'get-acoes',
      'Buscar informações básicas de ações',
      {
        stocks: z.array(z.string()).describe('Array of stock symbols'),
      },
      async (args) => {
        const stocks: string[] = Array.isArray(args.stocks)
          ? args.stocks
          : [args.stocks];
  
        const infos = await this.service.getStockResume(stocks);
  
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(infos, null, 2),
            },
          ],
        };
      },
    );
  }

• src/application/services/StatusInvestService.ts:17-43 (helper)

  Helper method in StatusInvestService that loops over stocks, fetches raw data from apiService.getStockResume, maps and enriches it (adds image URL, handles type), returns formatted array.

  async getStockResume(stocks: string[]) {
    const data = [];
    for (const stock of stocks) {
      const stockData = await this.apiService.getStockResume(stock);
      if (stockData && stockData?.length > 0) {
        for (const item of stockData) {
          let type = TypeEnum[item.type];
          if (!type) {
            type = `${item.type} unknown`;
          }
          const jsonData = {
            id: item.id,
            type,
            code: item.code,
            name: item.name,
            price: item.price,
            variation: item.variation,
            variationUp: item.variationUp,
            url: item.url,
            image: `https://statusinvest.com.br/img/company/avatar/${item.parentId}.jpg?v=214`,
          };
          data.push(jsonData);
        }
      }
    }
    return data;
  }

• src/infrastructure/services/StatusInvestApiService.ts:53-59 (helper)

  Core implementation: HTTP JSON fetch from StatusInvest API endpoint `/home/mainsearchquery?q={stock}` returning MainSearchQuery array.

  async getStockResume(stock: string): Promise<MainSearchQuery[] | null> {
    const data = await this.makeJsonRequest<MainSearchQuery[]>(
      `/home/mainsearchquery?q=${stock.toLowerCase()}`,
    );
    if (!data) return null;
    return data;
  }