Tool nào hiện ra

Trợ lý chỉ thấy tool dùng được trên máy bạn. Tool không dùng được thì không có trong danh sách, thay vì hiện ra rồi báo lỗi: trợ lý không tốn ngữ cảnh cho thứ nó không gọi được, và không đoán sai.

Ba quy tắc

Tool dữ liệu theo khoá nguồn. Một giá trị method mở khi máy có khoá của một nguồn đọc được nó, hoặc nguồn đó không cần khoá. Tool không còn giá trị nào mở thì ẩn. Dữ liệu không phân cấp: cấp quyền không mở thêm dữ liệu, và phần đang ẩn chỉ có nghĩa là máy chưa có khoá của nguồn phù hợp.
Tool tính toán theo cấp quyền của vnstock_quant. Mỗi tool quant_* gắn với nhóm tính năng (bảng nhóm tính năng); quant_ta chỉ liệt kê chỉ báo bạn dùng được. vnstock_quant vẫn kiểm từng lời gọi và đếm lượt thử; vnstock-mcp không tự đếm.
Tool nghiên cứu luôn có. Mọi research_* hiện ở mọi cấp, mọi hồ sơ.

Không đọc được trạng thái khoá hay cấp quyền (thư viện lỗi, sandbox của ứng dụng chặn) thì phần phía sau bị ẩn, và instructions nhắc chạy vnstock-mcp doctor.

Số tool theo tình huống

Đo trên bản 1.0.0rc1 ngày 06/11/2026. Số thật trên máy bạn tuỳ nguồn bạn có khoá.

Tình huống	Hồ sơ `research`	Hồ sơ `full`
Chưa đăng nhập, chưa có khoá nguồn nào	14	15
Bản Cộng đồng, khoá `ssi`	21	25
Bản Cộng đồng, khoá `ssi`, `dnse`, `fhsc`	24	33
Cấp Bronze, khoá `ssi`, `dnse`, `fhsc`	30	39
Cấp Silver trở lên, đủ khoá các nguồn	30	40

Chưa có khoá nào thì vẫn có tiền mã hoá qua nguồn không cần khoá, nhóm chỉ số (reference_index groups), các tool nghiên cứu, và phần tính toán cơ bản theo lượt thử trong ngày (10 chỉ báo, 10 chỉ số tài chính, backtest cơ bản). Bạn vẫn nhập được bảng của mình bằng research_import để tính.

Xem đúng danh sách trên máy bạn:

Shell

vnstock-mcp tools                    # tool đang hiện với hồ sơ mặc định
vnstock-mcp tools --profile full
vnstock-mcp tools market_equity      # tham số và giá trị method đang mở

Trong cuộc trò chuyện, quant_entitlement cho biết cấp quyền và lượt thử còn lại mà không trừ lượt.

Thêm khoá, đăng nhập hay đổi cấp xong thì khởi động lại ứng dụng AI để máy chủ dựng lại danh sách.

Hồ sơ tool

Một số ứng dụng (Claude Desktop, Gemini) nạp mô tả của mọi tool vào ngữ cảnh ở mỗi cuộc trò chuyện. Ít tool hơn là ít token hơn. Hồ sơ chọn sẵn bộ tool; chọn bằng --profile trong cấu hình của ứng dụng, hoặc biến VNSTOCK_MCP_PROFILE.

Hồ sơ	Gồm	Tối đa
`minimal`	Danh mục mã, giá và báo cáo tài chính cổ phiếu, chỉ báo, rủi ro, chỉ số tài chính, tra cứu, cùng các tool nghiên cứu	15
`research` (mặc định)	Dữ liệu cổ phiếu, chỉ số, bảng giá, hàng hoá, báo cáo tài chính, toàn bộ tính toán, các tool nghiên cứu	30
`data`	Mọi tool dữ liệu, không có tính toán	29
`full`	Mọi tool	40

--layers lọc thêm theo tầng (ví dụ --layers market,quant); hai bộ lọc giao nhau.

Mục lục

Ba quy tắc

Số tool theo tình huống

Hồ sơ tool

Tags