Algolab MCP

Official12 tools

by algolab

Vietnam stock market data for AI: prices, financials, broker research, macro, VN-Index forecast

vn.algolab/mcp — Model Context Protocol (MCP) Server

The vn.algolab/mcp server provides Vietnam stock market data for AI, including stock prices and financials. It also includes broker research and macro data, plus a VN-Index forecast. This enables AI applications to access structured market information related to Vietnam equities and index outlooks.

🛠️ Key Features

Vietnam stock market data
Prices
Financials
Broker research
Macro data
VN-Index forecast

🚀 Use Cases

Supplying AI systems with Vietnam equities pricing and financial metrics
Providing broker research context for AI analysis
Adding macro indicators and VN-Index forecasting inputs to AI workflows

⚡ Developer Benefits

Centralizes Vietnam-focused market datasets under an MCP server for AI consumption
Supports access to forecast and research content alongside prices and financials

Captured live from the server via tools/list.

get_market_overview

Toàn cảnh thị trường chứng khoán Việt Nam trong MỘT lượt: chỉ số (điểm, % thay đổi, P/E–P/B), top tăng/giảm, độ rộng kỹ thuật, 5 mã RS dẫn đầu, combo tín hiệu đang khớp, khối ngoại toàn thị trường, hợp đồng phái sinh gần nhất và bản tổng kết phiên mới nhất. Dùng khi: "thị trường hôm nay", "VN-Index thế nào", cần bối cảnh trước khi phân tích mã. · Không dùng khi: cần chuỗi giá (→ get_price_history) hoặc khối ngoại từng mã chi tiết (→ call_function get_foreign_flows_detail). Tham số: as_of (YYYY-MM-DD, mặc định phiên mới nhất); index (mặc định VNINDEX; VN30, HNX, UPCOM…). Kết quả: chỉ số tính điểm; giá trị VND; khối lượng cổ phiếu; trong phiên là số realtime. Xem thêm: get_technical_signals, get_news, get_intelligence.

Parameters2

as_of	any	optional	Ngày YYYY-MM-DD; mặc định phiên mới nhất (số realtime trong phiên).
index	string	optional	Chỉ số chính: VNINDEX (mặc định), VN30, HNX, UPCOM, VN100…

Raw schema

{
  "type": "object",
  "properties": {
    "as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ngày YYYY-MM-DD; mặc định phiên mới nhất (số realtime trong phiên).",
      "title": "As Of"
    },
    "index": {
      "default": "VNINDEX",
      "description": "Chỉ số chính: VNINDEX (mặc định), VN30, HNX, UPCOM, VN100…",
      "title": "Index",
      "type": "string"
    }
  },
  "title": "get_market_overviewArguments"
}

get_price_history

Chuỗi nến OHLCV của một mã bất kỳ: cổ phiếu (từ 2013), ETF, chứng quyền, chỉ số (từ 2017), phái sinh liên tục VN30F1M/VN30F2M (lưu từ 2017) hoặc từng hợp đồng; khung ngày/tuần/tháng và phút–giờ (cổ phiếu 50 phiên gần nhất có nến ATC 14:45, phái sinh từ 04/2026, chỉ số ~55 phiên gần nhất). Truy vấn được toàn bộ lịch sử. Dùng khi: xu hướng, hỗ trợ/kháng cự, hiệu suất theo thời gian, khối ngoại theo ngày của một mã. · Không dùng khi: chỉ cần giá hiện tại (→ get_quotes). Tham số: symbol; interval 1m|5m|15m|30m|1h|1d|1w|1mo; from_date/to_date; limit (mặc định 250, tối đa 1000); cursor lấy trang CŨ hơn. Kết quả: bars dạng bảng — limit nến MỚI NHẤT trong khoảng, cũ trước mới sau; nến ngày là giá điều chỉnh (VND), nến phút là giá thô; cổ phiếu kèm khối ngoại ròng và sự kiện quyền. Xem thêm: get_company_profile, get_technical_signals.

Parameters6

symbol	string	required	Mã bất kỳ: cổ phiếu (HPG), ETF, chứng quyền, chỉ số (VNINDEX, VN30), phái sinh (VN30F1M, VN30F2M hoặc mã hợp đồng).
interval	string	optional	Khung nến: 1m, 5m, 15m, 30m, 1h, 1d (mặc định), 1w, 1mo.
from_date	any	optional	Từ ngày YYYY-MM-DD (tuỳ chọn).
to_date	any	optional	Đến ngày YYYY-MM-DD; mặc định hôm nay.
limit	integer	optional	Số nến MỚI NHẤT cần lấy (mặc định 250, tối đa 1000).
cursor	any	optional	meta.next_cursor của lượt trước để lấy tiếp các nến CŨ hơn.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Mã bất kỳ: cổ phiếu (HPG), ETF, chứng quyền, chỉ số (VNINDEX, VN30), phái sinh (VN30F1M, VN30F2M hoặc mã hợp đồng).",
      "title": "Symbol",
      "type": "string"
    },
    "interval": {
      "default": "1d",
      "description": "Khung nến: 1m, 5m, 15m, 30m, 1h, 1d (mặc định), 1w, 1mo.",
      "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "1d",
        "1w",
        "1mo"
      ],
      "title": "Interval",
      "type": "string"
    },
    "from_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Từ ngày YYYY-MM-DD (tuỳ chọn).",
      "title": "From Date"
    },
    "to_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Đến ngày YYYY-MM-DD; mặc định hôm nay.",
      "title": "To Date"
    },
    "limit": {
      "default": 250,
      "description": "Số nến MỚI NHẤT cần lấy (mặc định 250, tối đa 1000).",
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "meta.next_cursor của lượt trước để lấy tiếp các nến CŨ hơn.",
      "title": "Cursor"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_price_historyArguments"
}

get_quotes

Giá realtime của tối đa 50 mã trong MỘT lượt — cổ phiếu, ETF, chứng quyền, chỉ số và phái sinh (kể cả VN30F1M/VN30F2M): giá khớp, % thay đổi, khối lượng, tốc độ khớp (RVOL), basis và OI phái sinh. Dùng khi: "giá HPG bây giờ", so sánh nhanh nhiều mã, soi danh mục. · Không dùng khi: cần lịch sử (→ get_price_history) hoặc hồ sơ doanh nghiệp (→ get_company_profile). Tham số: symbols — danh sách mã, vd ["HPG","VN30F1M","VNINDEX"]. Kết quả: mỗi mã một dòng; giá VND, chỉ số và phái sinh tính điểm; updated_at theo giờ sàn. Xem thêm: get_market_overview, get_price_history.

Parameters1

symbols

array

required

Danh sách mã (tối đa 50), vd ["HPG","VN30F1M","VNINDEX"].

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "description": "Danh sách mã (tối đa 50), vd [\"HPG\",\"VN30F1M\",\"VNINDEX\"].",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "title": "Symbols",
      "type": "array"
    }
  },
  "required": [
    "symbols"
  ],
  "title": "get_quotesArguments"
}

get_company_profile

Hồ sơ một doanh nghiệp niêm yết: thông tin chung và ngành ICB 4 cấp, cơ cấu sở hữu, định giá (P/E, P/B, EPS, BVPS do AlgolabX tự tính với số cổ phiếu đúng thời điểm, kèm số của nhà cung cấp), hiệu suất giá, thanh khoản, giá mục tiêu đồng thuận CTCK và AlgolabX, sự kiện quyền/cổ tức. Dùng khi: "HPG là công ty gì", "định giá VCB", bắt đầu phân tích một mã. · Không dùng khi: cần số liệu BCTC chi tiết (→ get_financial_statements). Tham số: symbol; sections — chọn trong overview, ownership, valuation, performance, targets, events (mặc định tất cả trừ events). Kết quả: mỗi section một khối; tiền VND, tỷ lệ % (hậu tố _pct). Xem thêm: get_financial_statements, get_research_reports.

Parameters2

symbol	string	required	Mã cổ phiếu hoặc ETF, vd HPG.
sections	any	optional	Chọn trong overview, ownership, valuation, performance, targets, events; mặc định tất cả trừ events.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Mã cổ phiếu hoặc ETF, vd HPG.",
      "title": "Symbol",
      "type": "string"
    },
    "sections": {
      "anyOf": [
        {
          "items": {
            "enum": [
              "overview",
              "ownership",
              "valuation",
              "performance",
              "targets",
              "events"
            ],
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Chọn trong overview, ownership, valuation, performance, targets, events; mặc định tất cả trừ events.",
      "title": "Sections"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_company_profileArguments"
}

get_financial_statements

Báo cáo tài chính theo đúng mẫu ngành (doanh nghiệp, ngân hàng, chứng khoán, bảo hiểm) của hơn 1.500 mã từ 2016: kết quả kinh doanh, cân đối kế toán, lưu chuyển tiền tệ theo quý hoặc năm; KQKD kèm dự phóng các quý tới của AlgolabX (tách riêng, không trộn với số đã công bố). Dùng khi: tăng trưởng doanh thu/lợi nhuận, biên lợi nhuận, nợ vay, dòng tiền. · Không dùng khi: chỉ cần P/E, P/B, vốn hoá (→ get_company_profile). Tham số: symbol; statement income|balance|cash (mặc định income); period quarter|annual; limit số kỳ (mặc định 8, tối đa 20); detail summary (dòng chính) | full (cả cây). Kết quả: lines dạng bảng dòng × kỳ, đơn vị tỷ VND; dòng EPS tính đồng. Xem thêm: search(kind="field") để tra mã chỉ tiêu.

Parameters5

symbol	string	required	Mã cổ phiếu, vd VCB.
statement	string	optional	income = KQKD (mặc định), balance = cân đối kế toán, cash = lưu chuyển tiền tệ.
period	string	optional	quarter (mặc định) hoặc annual.
limit	integer	optional	Số kỳ gần nhất (mặc định 8, tối đa 20).
detail	string	optional	summary = dòng chính (cấp 1–2 + EPS); full = toàn bộ cây kèm dòng cha.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Mã cổ phiếu, vd VCB.",
      "title": "Symbol",
      "type": "string"
    },
    "statement": {
      "default": "income",
      "description": "income = KQKD (mặc định), balance = cân đối kế toán, cash = lưu chuyển tiền tệ.",
      "enum": [
        "income",
        "balance",
        "cash"
      ],
      "title": "Statement",
      "type": "string"
    },
    "period": {
      "default": "quarter",
      "description": "quarter (mặc định) hoặc annual.",
      "enum": [
        "quarter",
        "annual"
      ],
      "title": "Period",
      "type": "string"
    },
    "limit": {
      "default": 8,
      "description": "Số kỳ gần nhất (mặc định 8, tối đa 20).",
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "detail": {
      "default": "summary",
      "description": "summary = dòng chính (cấp 1–2 + EPS); full = toàn bộ cây kèm dòng cha.",
      "enum": [
        "summary",
        "full"
      ],
      "title": "Detail",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_financial_statementsArguments"
}

get_research_reports

Báo cáo phân tích của 50 CTCK và AlgolabX (gần 7.000 báo cáo từ 2022): danh sách kèm khuyến nghị, giá mục tiêu và link đọc; khi có symbol thì kèm đồng thuận giá mục tiêu, khuyến nghị mới nhất của từng CTCK, AlgolabX theo kỳ hạn và upside so với giá hiện tại. Dùng khi: "CTCK nói gì về VCB", "giá mục tiêu HPG", báo cáo ngành/vĩ mô mới. · Không dùng khi: cần đọc toàn văn (→ call_function get_report_content với id). Tham số: symbol; broker (vd SSI, VCI, HSC, ALGOLABX); from_date; limit (mặc định 20); cursor. Kết quả: reports dạng bảng; giá VND; url là trang đọc trên algolab.vn — dùng link này khi dẫn nguồn. Xem thêm: get_company_profile.

Parameters5

symbol	any	optional	Mã cổ phiếu — kèm đồng thuận giá mục tiêu và upside.
broker	any	optional	Mã CTCK, vd SSI, VCI, HSC, MBS, ALGOLABX.
from_date	any	optional	Từ ngày YYYY-MM-DD.
limit	integer	optional	Số báo cáo mỗi trang (mặc định 20, tối đa 100).
cursor	any	optional	meta.next_cursor của lượt trước.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Mã cổ phiếu — kèm đồng thuận giá mục tiêu và upside.",
      "title": "Symbol"
    },
    "broker": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Mã CTCK, vd SSI, VCI, HSC, MBS, ALGOLABX.",
      "title": "Broker"
    },
    "from_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Từ ngày YYYY-MM-DD.",
      "title": "From Date"
    },
    "limit": {
      "default": 20,
      "description": "Số báo cáo mỗi trang (mặc định 20, tối đa 100).",
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "meta.next_cursor của lượt trước.",
      "title": "Cursor"
    }
  },
  "title": "get_research_reportsArguments"
}

get_news

Tin tức chứng khoán Việt Nam: tin doanh nghiệp kèm chấm điểm sentiment (Tích cực/Trung tính/Tiêu cực), bản tổng kết phiên cuối ngày và bản tin cập nhật trong phiên của AlgolabX; khi có symbol thì lọc theo mã. Dùng khi: "tin mới về HPG", "hôm nay thị trường có gì", tìm chất xúc tác/rủi ro. · Không dùng khi: cần báo cáo phân tích (→ get_research_reports). Tham số: symbol; kind company|recap|intraday|expert (recap + intraday); from_date; limit (mặc định 20 tin doanh nghiệp / 5 bản tin, tối đa 100); cursor. Kết quả: items mới nhất trước; published_at dạng ISO. Xem thêm: get_market_overview.

Parameters5

symbol	any	optional	Lọc theo mã.
kind	string	optional	company = tin doanh nghiệp có sentiment (mặc định); recap = tổng kết cuối ngày; intraday = bản tin trong phiên; expert = recap + intraday.
from_date	any	optional	Từ thời điểm (YYYY-MM-DD hoặc ISO datetime).
limit	any	optional	Số mục (mặc định 20 tin doanh nghiệp / 5 bản tin; tối đa 100).
cursor	any	optional	meta.next_cursor của lượt trước.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lọc theo mã.",
      "title": "Symbol"
    },
    "kind": {
      "default": "company",
      "description": "company = tin doanh nghiệp có sentiment (mặc định); recap = tổng kết cuối ngày; intraday = bản tin trong phiên; expert = recap + intraday.",
      "enum": [
        "company",
        "recap",
        "intraday",
        "expert"
      ],
      "title": "Kind",
      "type": "string"
    },
    "from_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Từ thời điểm (YYYY-MM-DD hoặc ISO datetime).",
      "title": "From Date"
    },
    "limit": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Số mục (mặc định 20 tin doanh nghiệp / 5 bản tin; tối đa 100).",
      "title": "Limit"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "meta.next_cursor của lượt trước.",
      "title": "Cursor"
    }
  },
  "title": "get_newsArguments"
}

get_technical_signals

Phân tích kỹ thuật định lượng của AlgolabX: xếp hạng sức mạnh giá RS đa khung, MACD, tín hiệu bắt đáy, beta, độ lệch chuẩn lợi suất; độ rộng thị trường; các combo tín hiệu đã backtest từ 2020 (tỉ lệ thắng, lợi suất vượt VN-Index) kèm danh sách mã đang khớp hôm nay. Dùng khi: tìm mã mạnh/yếu, xác nhận xu hướng, quét cơ hội theo bằng chứng lịch sử. · Không dùng khi: cần chuỗi giá (→ get_price_history). Tham số: symbol (một mã) hoặc top (mặc định 20, tối đa 200); as_of; min_adtv (sàn thanh khoản VND, mặc định 10 tỷ); detail summary|full. Kết quả: tickers dạng bảng (RS là percentile 0–100, lợi suất %); signal_combos; market_breadth. Xem thêm: get_market_overview.

Parameters5

symbol	any	optional	Một mã — trả riêng phân tích của mã đó (bỏ qua top/min_adtv).
as_of	any	optional	Ngày YYYY-MM-DD; mặc định phiên mới nhất.
top	integer	optional	Số mã RS mạnh nhất (mặc định 20, tối đa 200).
min_adtv	number	optional	Sàn thanh khoản — GTGD trung bình 1 tháng (VND), mặc định 10 tỷ; 0 = không lọc.
detail	string	optional	summary = cột chính; full = mọi khung RS/beta/độ lệch chuẩn và mọi combo.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Một mã — trả riêng phân tích của mã đó (bỏ qua top/min_adtv).",
      "title": "Symbol"
    },
    "as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ngày YYYY-MM-DD; mặc định phiên mới nhất.",
      "title": "As Of"
    },
    "top": {
      "default": 20,
      "description": "Số mã RS mạnh nhất (mặc định 20, tối đa 200).",
      "minimum": 1,
      "title": "Top",
      "type": "integer"
    },
    "min_adtv": {
      "default": 10000000000,
      "description": "Sàn thanh khoản — GTGD trung bình 1 tháng (VND), mặc định 10 tỷ; 0 = không lọc.",
      "minimum": 0,
      "title": "Min Adtv",
      "type": "number"
    },
    "detail": {
      "default": "summary",
      "description": "summary = cột chính; full = mọi khung RS/beta/độ lệch chuẩn và mọi combo.",
      "enum": [
        "summary",
        "full"
      ],
      "title": "Detail",
      "type": "string"
    }
  },
  "title": "get_technical_signalsArguments"
}

get_macro

Vĩ mô nhanh: Việt Nam (CPI, GDP, M2, tỷ giá trung tâm, IIP, bán lẻ) và thế giới (vàng, dầu Brent/WTI, S&P 500, Nasdaq, lợi suất TPCP Mỹ 10 năm, DXY, USD/VND) kèm FedWatch — xác suất Fed cắt/giữ/tăng lãi suất các kỳ họp tới. Dùng khi: bối cảnh vĩ mô, tác động tỷ giá/lãi suất lên thị trường. · Không dùng khi: cần chỉ tiêu khác — kho có hơn 1.300 chỉ tiêu (→ search kind="macro" rồi call_function get_macro_series). Tham số: scope vietnam|world|all; symbols (vd ["CPI","GOLD"]); from_date/to_date; limit số quan sát MỚI NHẤT mỗi chuỗi (mặc định 24). Kết quả: series có latest, previous và obs dạng bảng; fed_outlook. Xem thêm: call_function browse_macro.

Parameters5

scope	string	optional	vietnam, world hoặc all (mặc định).
symbols	any	optional	Lọc chuỗi — Việt Nam: CPI, GDP, M2, FX, IIP, RETAIL; thế giới: GOLD, BRENT, WTI, SP500, NASDAQ, US10Y, DXY, USDVND.
from_date	any	optional	Từ ngày YYYY-MM-DD.
to_date	any	optional	Đến ngày YYYY-MM-DD.
limit	integer	optional	Số quan sát MỚI NHẤT mỗi chuỗi (mặc định 24, tối đa 500).

Raw schema

{
  "type": "object",
  "properties": {
    "scope": {
      "default": "all",
      "description": "vietnam, world hoặc all (mặc định).",
      "enum": [
        "vietnam",
        "world",
        "all"
      ],
      "title": "Scope",
      "type": "string"
    },
    "symbols": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lọc chuỗi — Việt Nam: CPI, GDP, M2, FX, IIP, RETAIL; thế giới: GOLD, BRENT, WTI, SP500, NASDAQ, US10Y, DXY, USDVND.",
      "title": "Symbols"
    },
    "from_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Từ ngày YYYY-MM-DD.",
      "title": "From Date"
    },
    "to_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Đến ngày YYYY-MM-DD.",
      "title": "To Date"
    },
    "limit": {
      "default": 24,
      "description": "Số quan sát MỚI NHẤT mỗi chuỗi (mặc định 24, tối đa 500).",
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_macroArguments"
}

get_intelligence

★ Sản phẩm độc quyền AlgolabX (không phải dữ liệu thô): dự báo VN-Index các tháng tới (đường dự báo + dải tin cậy 50/80/95%) kèm luận điểm và kịch bản — cập nhật định kỳ, không phải mỗi phiên (luôn nêu as_of của bản đang dùng); tín hiệu phái sinh VN30F từ 4 mô hình (xu hướng, hồi quy, carry, chênh lệch); 2 danh mục mô hình đang công bố (Cơ bản và AlphaLab định lượng) với tỷ trọng, hiệu suất, alpha. Dùng khi: "VN-Index cuối năm bao nhiêu", "AlgolabX đang nghĩ gì", khẩu vị rủi ro trung hạn. · Không dùng khi: cần giá hiện tại (→ get_quotes). Tham số: as_of (mặc định bản mới nhất); section — đọc toàn văn một mục luận điểm (số mục hoặc từ khoá); detail summary|full. Kết quả: forecast (chỉ số chính + đường dự báo lấy mẫu, điểm), thesis (tóm tắt + mục lục), derivatives_signals, suggested_portfolios — tham khảo, không phải khuyến nghị cá nhân. Xem thêm: get_market_overview.

Parameters3

as_of	any	optional	Ngày bản dự báo YYYY-MM-DD; mặc định bản mới nhất.
detail	string	optional	summary (mặc định) = đường dự báo lấy mẫu + tóm tắt luận điểm + mục lục; full = toàn bộ (luận điểm rất dài, có thể bị cắt ở 200 KB).
section	any	optional	Đọc toàn văn MỘT mục luận điểm: số mục (vd "1", "I.1", "III.B.2") hoặc từ khoá tiêu đề (vd "tín dụng"); xem thesis.sections.

Raw schema

{
  "type": "object",
  "properties": {
    "as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ngày bản dự báo YYYY-MM-DD; mặc định bản mới nhất.",
      "title": "As Of"
    },
    "detail": {
      "default": "summary",
      "description": "summary (mặc định) = đường dự báo lấy mẫu + tóm tắt luận điểm + mục lục; full = toàn bộ (luận điểm rất dài, có thể bị cắt ở 200 KB).",
      "enum": [
        "summary",
        "full"
      ],
      "title": "Detail",
      "type": "string"
    },
    "section": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Đọc toàn văn MỘT mục luận điểm: số mục (vd \"1\", \"I.1\", \"III.B.2\") hoặc từ khoá tiêu đề (vd \"tín dụng\"); xem thesis.sections.",
      "title": "Section"
    }
  },
  "title": "get_intelligenceArguments"
}

search

Tìm mọi thứ trong kho dữ liệu Algolab bằng từ khoá tiếng Việt (có/không dấu) hoặc tiếng Anh: hàm dữ liệu (kèm tham số và ví dụ gọi), mã chứng khoán (toàn bộ mã đang niêm yết: cổ phiếu, ETF, chứng quyền, phái sinh, chỉ số), ngành ICB, chỉ tiêu BCTC (hơn 3.300), chỉ tiêu vĩ mô (hơn 1.300). Dùng khi: không chắc tên mã/hàm/chỉ tiêu; muốn biết Algolab có dữ liệu gì về một chủ đề. · Không dùng khi: đã biết công cụ cần gọi. Tham số: query; kind auto|function|symbol|sector|field|macro; limit (mặc định 10). Kết quả: nhóm functions / symbols / sectors / fields / macro; hàm danh mục gọi qua call_function. Xem thêm: call_function. Danh mục chuyên sâu: • get_index_intraday — chuỗi điểm trong phiên của chỉ số (mỗi phút) • get_foreign_flows_detail — khối ngoại toàn thị trường một phiên, top mua/bán ròng • get_corporate_events — sự kiện quyền, cổ tức, ĐHCĐ, giao dịch nội bộ của một mã • list_symbols — danh sách mã theo loại, sàn, ngành ICB • screen_stocks — lọc cổ phiếu theo định giá, sinh lời, hiệu suất giá, RS, thanh khoản, khối ngoại, ngành, cờ tín hiệu • get_report_content — toàn văn báo cáo phân tích (markdown) theo id • get_warrants — bảng giá chứng quyền kèm giá thực hiện, đáo hạn, ITM/OTM, hoà vốn • get_derivatives_snapshot — mọi hợp đồng tương lai: giá, basis, OI, CVD mua/bán chủ động • browse_macro — duyệt cây chỉ tiêu vĩ mô theo nhóm • get_macro_series — chuỗi số liệu một chỉ tiêu vĩ mô bất kỳ theo key • get_quota — hạn mức của khoá đang dùng: đã dùng, còn lại, giờ đặt lại • report_issue — báo lỗi hoặc dữ liệu sai cho đội AlgolabX, kèm ngữ cảnh lượt gọi gần nhất

Parameters3

query	string	required	Từ khoá tiếng Việt (có hoặc không dấu) hoặc tiếng Anh, vd "lãi suất liên ngân hàng", "Hoà Phát", "chứng quyền", "CPI".
kind	string	optional	auto (mặc định, mọi loại) · function · symbol · sector · field (chỉ tiêu BCTC) · macro.
limit	integer	optional	Số kết quả mỗi nhóm (mặc định 10, tối đa 50).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Từ khoá tiếng Việt (có hoặc không dấu) hoặc tiếng Anh, vd \"lãi suất liên ngân hàng\", \"Hoà Phát\", \"chứng quyền\", \"CPI\".",
      "minLength": 1,
      "title": "Query",
      "type": "string"
    },
    "kind": {
      "default": "auto",
      "description": "auto (mặc định, mọi loại) · function · symbol · sector · field (chỉ tiêu BCTC) · macro.",
      "enum": [
        "auto",
        "function",
        "symbol",
        "sector",
        "field",
        "macro"
      ],
      "title": "Kind",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Số kết quả mỗi nhóm (mặc định 10, tối đa 50).",
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "searchArguments"
}

call_function

Chạy một hàm trong danh mục dữ liệu chuyên sâu của Algolab theo tên, với tham số dạng object. Sai tên → gợi ý tên gần nhất; sai tham số → trả danh sách tham số và ví dụ đúng. Dùng khi: cần dữ liệu ngoài 10 công cụ chính (danh mục bên dưới). · Không dùng khi: công cụ trực tiếp đã đủ. Tham số: name; arguments (object). Kết quả: cùng dạng {status, data, meta} như mọi công cụ. Xem thêm: search. Ví dụ: call_function(name="get_warrants", arguments={"underlying": "HPG"}). Danh mục: • get_index_intraday — chuỗi điểm trong phiên của chỉ số (mỗi phút) • get_foreign_flows_detail — khối ngoại toàn thị trường một phiên, top mua/bán ròng • get_corporate_events — sự kiện quyền, cổ tức, ĐHCĐ, giao dịch nội bộ của một mã • list_symbols — danh sách mã theo loại, sàn, ngành ICB • screen_stocks — lọc cổ phiếu theo định giá, sinh lời, hiệu suất giá, RS, thanh khoản, khối ngoại, ngành, cờ tín hiệu • get_report_content — toàn văn báo cáo phân tích (markdown) theo id • get_warrants — bảng giá chứng quyền kèm giá thực hiện, đáo hạn, ITM/OTM, hoà vốn • get_derivatives_snapshot — mọi hợp đồng tương lai: giá, basis, OI, CVD mua/bán chủ động • browse_macro — duyệt cây chỉ tiêu vĩ mô theo nhóm • get_macro_series — chuỗi số liệu một chỉ tiêu vĩ mô bất kỳ theo key • get_quota — hạn mức của khoá đang dùng: đã dùng, còn lại, giờ đặt lại • report_issue — báo lỗi hoặc dữ liệu sai cho đội AlgolabX, kèm ngữ cảnh lượt gọi gần nhất

Parameters2

name	string	required	Tên hàm trong danh mục, vd "get_warrants".
arguments	any	optional	Tham số của hàm dạng object, vd {"underlying": "HPG"}.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Tên hàm trong danh mục, vd \"get_warrants\".",
      "title": "Name",
      "type": "string"
    },
    "arguments": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Tham số của hàm dạng object, vd {\"underlying\": \"HPG\"}.",
      "title": "Arguments"
    }
  },
  "required": [
    "name"
  ],
  "title": "call_functionArguments"
}

Install

Tools (12)

get_market_overviewget_price_historyget_quotesget_company_profileget_financial_statementsget_research_reportsget_newsget_technical_signals

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.algolab.vn/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.algolab.vn/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

vn.algolab/mcp — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

get_market_overview

get_price_history

get_quotes

get_company_profile

get_financial_statements

get_research_reports

get_news

get_technical_signals

get_macro

get_intelligence

search

call_function

Install

Remote endpoint

Related servers