AlgoLabAlgoLabAlgoLabAlgoLabAlgoLabAlgoLab
Model Context Protocol

Dữ liệu chứng khoán chuyên sâu tại thị trường Việt Nam,
kết nối trực tiếp vào AI của bạn

Algolab MCP cho Claude và mọi AI client truy cập trực tiếp giá cổ phiếu, vĩ mô, dự báo VN-Index, tin tức, báo cáo phân tích và dòng tiền khối ngoại — qua một endpoint duy nhất, chuẩn mở MCP.

Kết nối trong 1 phút — không cần keyXem 11 công cụ
11 tools dữ liệu thật Realtime trong phiên Chuẩn mở — không khoá vendor
claude → algolab
> "Khối ngoại đang làm gì với HPG tuần này?"

⚒ get_foreign_flows(ticker="HPG", since="2026-06-03")
{
  "ticker": "HPG",
  "day": "2026-06-09",
  "buy_vol": 5,557,200,
  "sell_vol": 8,646,400,
  "net": -3,089,200        // bán ròng phiên thứ 4
}

⚒ get_stock_daily(ticker="HPG")
⚒ get_news(ticker="HPG", limit=5)

✓ "Khối ngoại bán ròng HPG 4 phiên liên tiếp,
   tổng ~9,2 triệu cp. Giá lùi về 23.300đ…"
Remote MCP server URL
https://mcp.algolab.vn

Chỉ đọc (read-only) — không truy cập dữ liệu cá nhân. Quyền thu hồi được tức thì, quota đếm từng request theo gói.

11 công cụ dữ liệu

tools/list
Cổ phiếu
  • list_tickers

    Danh sách mã trong vũ trụ Algolab — lọc theo prefix hoặc ngành ICB.

  • get_stock_daily

    OHLCV ngày + khối lượng ròng khối ngoại của một mã.

  • get_stock_realtime

    Snapshot realtime tới 50 mã: giá khớp, %thay đổi, khối lượng.

Vĩ mô
  • get_macro_world

    GOLD, BRENT, WTI, SP500, NASDAQ, US10Y, DXY, USDVND theo chuỗi thời gian.

  • get_macro_vietnam

    CPI, GDP, M2, tỷ giá, IIP, bán lẻ — số liệu vĩ mô Việt Nam.

Chỉ số & Dự báo
  • get_market_index

    Diễn biến VNINDEX, VN30, HNX, UPCOM và các chỉ số ngành.

  • get_vnindex_forecast

    Đường dự báo VN-Index 12 tháng kèm dải tin cậy + luận điểm của AlgolabX.

Tin tức & Báo cáo
  • get_news

    Tin tức cổ phiếu Việt Nam kèm sentiment và điểm tác động.

  • get_report

    Báo cáo phân tích từ HSC, VCI, MBS, AlgolabX… kèm khuyến nghị, giá mục tiêu.

Dòng tiền & Sức mạnh giá
  • get_foreign_flows

    Mua/bán/ròng của khối ngoại theo phiên, theo mã hoặc toàn thị trường.

  • get_rs_ranking

    Bảng xếp hạng Relative Strength toàn thị trường theo ngày.

Sắp tới

Tài chính doanh nghiệp theo quý, định giá ngành, sự kiện doanh nghiệp và cảnh báo đột biến khối lượng.

Kết nối trong 1 phút

Cách 1 — claude.ai: kết nối một chạm
Dễ nhất

Không cần key, không cần terminal — đăng nhập Algolab là xong.

  1. 1Mở claude.ai → Customize (thanh bên) → Connectors → Add custom connector
  2. 2Điền 2 ô — Name: Algolab · Remote MCP server URL: https://mcp.algolab.vn → bấm Add (bỏ qua Advanced settings)
  3. 3Bấm Connect → đăng nhập Algolab → Cho phép. Xong — hỏi ngay được dữ liệu thị trường.

Dùng được trên claude.ai web, Claude Desktop và app điện thoại — connector đồng bộ theo tài khoản Claude. App ChatGPT cũng kết nối tương tự (Settings → Apps → Developer mode → thêm MCP server).

Cách 2 — API key cho client cấu hình tay

Dành cho Claude Code, Cursor, Gemini CLI, Antigravity hoặc agent tự viết — tạo key rồi dán vào config tương ứng bên dưới.

Claude Code — terminal
claude mcp add --transport http --scope user algolab \
  "https://mcp.algolab.vn" \
  --header "Authorization: Bearer alm_xxx"

Chạy lệnh này trong terminal (không phải dán vào hội thoại). --scope user để dùng được ở mọi thư mục, mọi phiên — thiếu nó server chỉ có trong thư mục hiện tại. Gõ /mcp trong phiên để kiểm tra kết nối.

Claude Desktop — claude_desktop_config.json
{
  "mcpServers": {
    "algolab": {
      "type": "http",
      "url": "https://mcp.algolab.vn",
      "headers": { "Authorization": "Bearer alm_xxx" }
    }
  }
}

Config chỉ được nạp lúc khởi động — lưu file xong phải thoát hẳn (Quit) và mở lại Claude Desktop thì server mới xuất hiện.

Gemini CLI — ~/.gemini/settings.json
{
  "mcpServers": {
    "algolab": {
      "httpUrl": "https://mcp.algolab.vn",
      "headers": { "Authorization": "Bearer alm_xxx" }
    }
  }
}

Lưu file rồi mở phiên gemini mới — phiên đang chạy không tự nạp lại config.

Antigravity — ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "algolab": {
      "serverUrl": "https://mcp.algolab.vn",
      "headers": { "Authorization": "Bearer alm_xxx" }
    }
  }
}

Lưu file xong khởi động lại Antigravity (hoặc Reload Window) để nạp server mới.

ChatGPT — qua OpenAI API

App ChatGPT: thêm qua OAuth như Cách 1 (Settings → Apps → Developer mode → thêm MCP server https://mcp.algolab.vn). Còn khi gọi bằng OpenAI Responses API thì dùng key, truyền trong tham số authorization:

response = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "algolab",
        "server_url": "https://mcp.algolab.vn",
        "authorization": "alm_xxx",
        "require_approval": "never",
    }],
    input="Khối ngoại đang mua ròng mã nào hôm nay?",
)

Xong — mở hội thoại mới và hỏi: “Top 10 cổ phiếu RS mạnh nhất hôm nay? Khối ngoại đang mua ròng mã nào?” — AI sẽ tự gọi đúng công cụ và trả lời bằng dữ liệu thật. Trong Claude Code còn có lệnh tắt: gõ /algolab để chọn nhanh phân tích cổ phiếu, tổng quan thị trường hoặc dự báo VN-Index.

Gói & bảng giá nằm trong Ví Go

Các gói Free / Pro / Enterprise thanh toán bằng điểm Go — xem chi tiết giới hạn tốc độ và đăng ký ngay trong ví của bạn.

Mở Ví Go

Câu hỏi thường gặp

MCP là gì?

Model Context Protocol — chuẩn mở do Anthropic khởi xướng để các AI (Claude, ChatGPT, Cursor…) gọi dữ liệu và công cụ bên ngoài một cách an toàn. Algolab MCP biến toàn bộ kho dữ liệu thị trường của Algolab thành “công cụ” mà AI của bạn dùng được ngay trong hội thoại.

Client nào dùng được?

Gần như mọi client. Dễ nhất: claude.ai web, Claude Desktop, app Claude điện thoại và app ChatGPT — kết nối OAuth một chạm, không cần key. Cách nâng cao bằng API key: Claude Code, Cursor, Windsurf, Gemini CLI, Antigravity, và agent tự viết bằng MCP SDK (Python/TypeScript).

Dữ liệu lấy từ đâu, cập nhật thế nào?

Từ hệ thống thu thập dữ liệu của Algolab: giá realtime trong phiên, OHLCV và dòng tiền khối ngoại cập nhật cuối ngày, vĩ mô thế giới cập nhật hằng ngày, tin tức và báo cáo cập nhật liên tục.

Connector trên claude.ai báo lỗi khi Connect?

Thử Disconnect rồi Connect lại — phiên cấp quyền cũ có thể đã hết hạn; đảm bảo bạn bấm “Cho phép” trên trang Algolab khi được hỏi. Vẫn kẹt? Email algolabx@gmail.com kèm screenshot — phản hồi trong ngày.

Cài bằng key rồi nhưng phiên mới không thấy server?

Khả năng cao bạn thêm thiếu --scope user trong lệnh claude mcp add: thiếu nó server chỉ gắn với thư mục lúc cài. Chạy claude mcp list để kiểm tra, rồi thêm lại bằng lệnh đầy đủ ở phần Cách 2.

Sửa file config mà không thấy gì đổi?

Mọi client chỉ đọc config lúc khởi động — thoát hẳn (Quit) và mở lại app, hoặc mở phiên CLI mới. Dán config vào hội thoại thì không cài được gì.

Kết nối lỗi 401?

Key dán thiếu/thừa ký tự, hoặc đã bị vô hiệu do bấm “Tạo lại key”. Đăng nhập algolab.vn/mcp, tạo key mới và cập nhật lại config. Với kết nối OAuth (claude.ai): Disconnect rồi Connect lại là được cấp token mới.

Có cần API key không?

Dùng claude.ai / Claude Desktop / app ChatGPT thì KHÔNG — kết nối OAuth là xong, không cần key. Key chỉ cần cho client cấu hình tay (Claude Code, Cursor, Gemini CLI…): đăng nhập algolab.vn rồi bấm “Tạo key Free” — key dạng alm_… hiện ra một lần duy nhất (quên thì tạo lại, key cũ tự vô hiệu). Gói Pro / Enterprise: đăng ký trong Ví Go (Tài khoản → Ví Go), thanh toán bằng điểm Go.

Algolab MCP đang ở giai đoạn beta — phản hồi về algolabx@gmail.com.