AlgoLabAlgoLabAlgoLabAlgoLab
Model Context Protocol

Dữ liệu chứng khoán Việt Nam,
cắm thẳng 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.

11 tools dữ liệu thật Realtime trong phiên Chuẩn mở — không khoá vendor
claude → algolab-market
> "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đ…"
Endpoint
https://mcp.algolab.vn

Streamable HTTP · xác thực Bearer token (key dạng alm_…) · giới hạn tốc độ theo gói.

An toàn

Chỉ đọc (read-only). Key thu hồi được tức thì. Quota đếm nguyên tử từng request — không bất ngờ cuối tháng.

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 2 phút

Claude Code — terminal
claude mcp add --transport http algolab-market \
  "https://mcp.algolab.vn" \
  --header "Authorization: Bearer alm_xxx"
Claude Desktop — claude_desktop_config.json
{
  "mcpServers": {
    "algolab-market": {
      "type": "http",
      "url": "https://mcp.algolab.vn",
      "headers": { "Authorization": "Bearer alm_xxx" }
    }
  }
}
Claude.ai (bản web) — chưa hỗ trợ

Hộp thoại “Add custom connector” trên claude.ai web hiện chỉ nhận xác thực OAuth, không có ô dán Bearer token — nên không cắm được key alm_… ở đó.

👉 Dùng Claude Desktop (ứng dụng máy tính) với cấu hình bên cạnh — tương đương và dùng được ngay với key của bạn.

Gemini CLI — ~/.gemini/settings.json
{
  "mcpServers": {
    "algolab-market": {
      "httpUrl": "https://mcp.algolab.vn",
      "headers": { "Authorization": "Bearer alm_xxx" }
    }
  }
}
Antigravity — ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "algolab-market": {
      "serverUrl": "https://mcp.algolab.vn",
      "headers": { "Authorization": "Bearer alm_xxx" }
    }
  }
}
ChatGPT — qua OpenAI API

App ChatGPT (Settings → Apps → Developer mode) cũng chỉ nhận xác thực OAuth, không có ô dán Bearer token — nên dùng qua OpenAI Responses API, truyền key trong tham số authorization:

response = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "algolab_market",
        "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.

Bảng giá

Free
mãi mãi
  • 30 yêu cầu / phút
  • 1.000 yêu cầu / ngày
  • Đủ 11 tools

Đủ cho cá nhân dùng Claude Desktop hằng ngày.

Đăng ký Free
Phổ biến
Pro
990.000đ / tháng
  • 600 yêu cầu / phút
  • 50.000 yêu cầu / ngày
  • Đủ 11 tools

Cho trader chuyên nghiệp và ứng dụng AI nội bộ.

Đăng ký Pro
Enterprise
9.900.000đ / tháng
  • 6.000 yêu cầu / phút
  • 1.000.000 yêu cầu / ngày
  • Đủ 11 tools

Cho tổ chức, sản phẩm thương mại và agent fleet.

Đăng ký Enterprise

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?

Các client cho dán Bearer token / custom header: Claude Desktop (app máy tính), Claude Code, Gemini CLI, Antigravity, Cursor, Windsurf, và agent tự viết bằng MCP SDK (Python/TypeScript). Lưu ý: claude.ai bản web và app ChatGPT hiện chỉ hỗ trợ OAuth nên không cắm key trực tiếp được — với ChatGPT hãy dùng qua OpenAI API.

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.

Làm sao lấy API key?

Tạo tài khoản và đăng nhập algolab.vn, quay lại trang này và bấm “Tạo key Free” — key dạng alm_… hiện ra một lần duy nhất, gắn với tài khoản của bạn (quên thì tạo lại, key cũ tự vô hiệu). Gói Pro/Enterprise liên hệ [email protected].

Algolab MCP đang ở giai đoạn beta — phản hồi về [email protected].