Tài liệu MCP
Đưa dữ liệu chứng khoán Việt Nam vào ứng dụng AI của bạn
Một link riêng để thêm 18 công cụ đọc kho dulieuchungkhoan.vn vào ứng dụng AI: giá từ năm 2000, báo cáo tài chính, sự kiện, hồ sơ, tin tức, vĩ mô. Ứng dụng cần hỗ trợ thêm máy chủ MCP từ xa bằng địa chỉ HTTPS. Dán link một lần, không cần cài thêm gì.
- Công cụ
- 18
- Lịch sử giá
- Từ năm 2000
- Link mỗi tài khoản
- Tối đa 5
- Phí
- Miễn phí
Đăng ký công khai sắp mở. Trong lúc chờ, link MCP được cấp thủ công: gửi email đến dulieuchungkhoan.official@gmail.com.
01Giới thiệu
MCP (Model Context Protocol) là chuẩn mở để ứng dụng AI gọi công cụ bên ngoài. Khi kết nối link của chúng tôi, mỗi câu trả lời đều dựa trên số liệu tra từ kho lúc bạn hỏi, không dựa vào trí nhớ của mô hình.
Công cụ theo nhóm
- Tra cứuTìm mã và chỉ tiêu; chuỗi theo thời gian, báo cáo tài chính, sự kiện, tin tức.get_
series5 công cụ - Lọc, so sánhLát cắt một phiên cho nhiều mã hoặc 24 ngành, năm chiến lược lọc mẫu, so với ngành.cross_
section3 công cụ - Tổng hợpBức tranh một cổ phiếu, thị trường một phiên, định giá nhanh, trong một lời gọi.get_
stock_ overview3 công cụ - Báo cáo gốcĐọc báo cáo tài chính PDF theo mục; đọc thuyết minh theo danh sách kiểm.get_
report_ text2 công cụ - Tính, xuất tệpTăng trưởng, CAGR, beta, DCF trên số đã tra; xuất CSV, Excel, báo cáo Word.compute3 công cụ
- Kiến thứcTài liệu định giá, đọc báo cáo, vĩ mô, chỉ báo; bộ cố vấn khi bạn đồng ý.load_
knowledge_ reference2 công cụ
Kho cập nhật theo ngày: giá phiên hôm nay thường có từ khoảng 16:10. Trong giờ giao dịch, một số công cụ trả thêm số liệu tạm của phiên khi có.
02Hỏi được gì
Hỏi như hỏi một chuyên viên phân tích. Một số câu mẫu theo chủ đề: sao chép vào ứng dụng AI rồi đổi mã theo ý bạn.
Thị trường
«Phiên gần nhất thị trường thế nào: chỉ số, độ rộng, khối ngoại, ngành nào dẫn dắt?»
Cổ phiếu
«Tổng quan FPT: giá một năm, P/E, P/B, ROE, lợi nhuận bốn quý gần nhất.»
Định giá
«P/E của HPG đang ở phân vị nào so với 5 năm qua và so với ngành?»
Báo cáo tài chính
«Lập bảng doanh thu, lợi nhuận sau thuế của VNM trong 8 quý gần nhất.»
Lọc cổ phiếu
«Lọc cổ phiếu theo chiến lược cổ tức, giá trị giao dịch tối thiểu 5 tỷ đồng mỗi phiên.»
Xuất tệp
«Xuất P/E, P/B, ROE của các mã ngân hàng phiên gần nhất ra tệp Excel.»
Ngành
«So ngân hàng với các ngành khác theo sức mạnh tương đối 26 tuần.»
Sự kiện
«Mã nào chốt quyền nhận cổ tức tiền trong 30 ngày tới?»
Tin tức
«Tin nổi bật về ngành bất động sản trong tuần này.»
Hàng hoá
«Giá dầu WTI giao ngay và tương lai 3 tháng gần đây, kẻ thành bảng.»
Thuyết minh
«Đọc thuyết minh báo cáo tài chính năm gần nhất của HPG: nợ vay và chi phí lãi vay.»
Báo cáo
«Viết báo cáo Word ngắn về MWG, kèm biểu đồ lợi nhuận theo quý.»
Muốn AI trả lời theo lối tư vấn (lập luận, cấu trúc câu trả lời), hãy nói «bật cố vấn» hoặc chọn lệnh enable_advisor trong ứng dụng. Bộ cố vấn không tự bật.
03Ứng dụng AI phù hợp
Link của bạn dùng được với ứng dụng AI đáp ứng hai điều kiện dưới đây.
- Hỗ trợ thêm máy chủ MCP từ xa (remote MCP server) bằng một địa chỉ HTTPS.
- Kết nối được mà không cần đăng nhập OAuth: mã truy cập nằm sẵn trong link, ứng dụng chỉ cần gửi đúng địa chỉ đó.
Ví dụ nơi dán link: ChatGPT ở chế độ cho phép thêm máy chủ MCP; Claude, bản web và bản máy tính; Gemini, mục «Trình kết nối», bấm «Tuỳ chỉnh», dán link vào ô «URL của máy chủ MCP».
Danh sách ứng dụng chúng tôi đã chạy thử với link riêng đang được bổ sung trên trang này.
04Kết nối từng bước
Bốn bước. Bước 3 thực hiện trong ứng dụng AI; tên các mục ở đó thay đổi theo phiên bản ứng dụng.
- 01
Tạo tài khoảnsắp có
Đăng ký bằng email hoặc Google trên trang tài khoản của dulieuchungkhoan.vn.
- 02
Tạo link MCPsắp có
Vào «Link MCP của tôi», đặt tên theo ứng dụng (ví dụ «ChatGPT») rồi bấm «Tạo link». Link chỉ hiện một lần: sao chép ngay.
- 03
Thêm vào ứng dụng AI
Mở phần thêm máy chủ MCP từ xa của ứng dụng (ví dụ ChatGPT, Claude, Gemini: chỗ mở ghi ở mục «Ứng dụng AI phù hợp»), dán link vào ô địa chỉ (URL) rồi lưu.
- 04
Hỏi thử
Mở hội thoại mới, hỏi một câu có mã cổ phiếu. Ứng dụng có thể xin phép trước khi gọi công cụ: đồng ý để AI lấy số liệu.
https://api.dulieuchungkhoan.vn/<mã của bạn>/mcpĐổi link hoặc kết nối lại
- Link bị lộ hoặc không dùng nữa: thu hồi ở «Link MCP của tôi», tạo link mới, dán lại vào ứng dụng.
- Ứng dụng chưa thấy công cụ mới sau khi chúng tôi cập nhật: tắt connector rồi bật lại, mở hội thoại mới.
05Danh sách công cụ
18 công cụ trong sáu nhóm. Bạn không cần gọi tên công cụ: AI tự chọn theo câu hỏi.
| Nhóm | Công cụ | Làm gì |
|---|---|---|
| Tra cứu | lookup | Tìm mã, tìm chỉ tiêu theo tên; thẻ doanh nghiệp và hồ sơ: cổ đông, lãnh đạo, thông tin công ty, kế hoạch năm. |
get_series | Chuỗi theo thời gian của tối đa 20 chỉ tiêu cho một mã, một chỉ số hoặc chuỗi vĩ mô; chuỗi thị trường theo phút trong phiên. | |
get_financials | Báo cáo tài chính theo mẫu biểu từng loại doanh nghiệp, theo năm hoặc quý, kèm link tệp gốc; tỷ số theo kỳ. | |
get_events | Dòng thời gian sự kiện: cổ tức, phát hành, đại hội, giao dịch nội bộ, niêm yết, lịch vĩ mô, đáo hạn phái sinh. | |
get_news | Tìm tin theo từ khoá, mã, ngành; mỗi sự kiện một dòng, kèm mức quan trọng và số báo cùng đưa tin. | |
| Lọc, so sánh | cross_section | Lát cắt một phiên cho nhiều mã hoặc 24 ngành: lọc theo điều kiện, xếp hạng, tối đa 200 dòng. |
screen_by_strategy | Lọc theo một trong năm chiến lược mẫu: giá trị, tăng trưởng, cổ tức, chất lượng, động lượng. | |
compare_industry | So sánh một mã hoặc một ngành với các ngành khác và với 30 mã vốn hoá lớn nhất cùng ngành. | |
| Tổng hợp | get_stock_overview | Bức tranh một cổ phiếu hoặc ETF: giá 250 phiên, P/E, P/B, ROE, lãi 4 quý, kế hoạch năm, sự kiện 30 ngày tới, dòng tiền. |
get_market_today | Thị trường một phiên: chỉ số sàn, độ rộng, khối ngoại, tự doanh, ngành mạnh yếu, mã đóng góp điểm, lãi suất, tỷ giá, dầu, lịch vĩ mô 7 ngày. | |
get_quick_valuation | P/E, P/B hiện tại, phân vị 5 năm của chính mã, so với ngành, cổ tức; tính Gordon hoặc DCF khi bạn đưa giả định. | |
| Báo cáo gốc | get_report_text | Đọc báo cáo tài chính gốc (PDF) theo mục: thuyết minh, bảng cân đối, kết quả kinh doanh, lưu chuyển tiền, ý kiến kiểm toán. |
read_financial_notes | Đọc thuyết minh theo danh sách kiểm của từng loại doanh nghiệp, kèm bằng chứng trích dẫn và cờ theo ngưỡng. | |
| Tính, xuất tệp | compute | Tính trên số đã tra hoặc số bạn đưa: tăng trưởng, CAGR, trung bình, beta, Sharpe, Gordon, DCF; trả kèm phép tính đã thay số. |
export | Xuất bảng ra CSV hoặc Excel, tối đa 5.000 dòng; link tải được lưu tối đa 24 giờ. | |
report | Tạo báo cáo Word từ nội dung AI soạn, tối đa 3 biểu đồ; link tải được lưu tối đa 24 giờ. | |
| Kiến thức | load_knowledge_reference | Tài liệu kiến thức: định giá, đọc báo cáo tài chính, vĩ mô và tiền tệ, chỉ báo kỹ thuật, danh mục. |
load_skill | Bộ cố vấn: cách lập luận và trình bày câu trả lời tư vấn. Chỉ gọi khi bạn đồng ý. |
- Nhóm
- Tra cứu
- Công cụ
lookup- Làm gì
- Tìm mã, tìm chỉ tiêu theo tên; thẻ doanh nghiệp và hồ sơ: cổ đông, lãnh đạo, thông tin công ty, kế hoạch năm.
- Nhóm
- Tra cứu
- Công cụ
get_series- Làm gì
- Chuỗi theo thời gian của tối đa 20 chỉ tiêu cho một mã, một chỉ số hoặc chuỗi vĩ mô; chuỗi thị trường theo phút trong phiên.
- Nhóm
- Tra cứu
- Công cụ
get_financials- Làm gì
- Báo cáo tài chính theo mẫu biểu từng loại doanh nghiệp, theo năm hoặc quý, kèm link tệp gốc; tỷ số theo kỳ.
- Nhóm
- Tra cứu
- Công cụ
get_events- Làm gì
- Dòng thời gian sự kiện: cổ tức, phát hành, đại hội, giao dịch nội bộ, niêm yết, lịch vĩ mô, đáo hạn phái sinh.
- Nhóm
- Tra cứu
- Công cụ
get_news- Làm gì
- Tìm tin theo từ khoá, mã, ngành; mỗi sự kiện một dòng, kèm mức quan trọng và số báo cùng đưa tin.
- Nhóm
- Lọc, so sánh
- Công cụ
cross_section- Làm gì
- Lát cắt một phiên cho nhiều mã hoặc 24 ngành: lọc theo điều kiện, xếp hạng, tối đa 200 dòng.
- Nhóm
- Lọc, so sánh
- Công cụ
screen_by_strategy- Làm gì
- Lọc theo một trong năm chiến lược mẫu: giá trị, tăng trưởng, cổ tức, chất lượng, động lượng.
- Nhóm
- Lọc, so sánh
- Công cụ
compare_industry- Làm gì
- So sánh một mã hoặc một ngành với các ngành khác và với 30 mã vốn hoá lớn nhất cùng ngành.
- Nhóm
- Tổng hợp
- Công cụ
get_stock_overview- Làm gì
- Bức tranh một cổ phiếu hoặc ETF: giá 250 phiên, P/E, P/B, ROE, lãi 4 quý, kế hoạch năm, sự kiện 30 ngày tới, dòng tiền.
- Nhóm
- Tổng hợp
- Công cụ
get_market_today- Làm gì
- Thị trường một phiên: chỉ số sàn, độ rộng, khối ngoại, tự doanh, ngành mạnh yếu, mã đóng góp điểm, lãi suất, tỷ giá, dầu, lịch vĩ mô 7 ngày.
- Nhóm
- Tổng hợp
- Công cụ
get_quick_valuation- Làm gì
- P/E, P/B hiện tại, phân vị 5 năm của chính mã, so với ngành, cổ tức; tính Gordon hoặc DCF khi bạn đưa giả định.
- Nhóm
- Báo cáo gốc
- Công cụ
get_report_text- Làm gì
- Đọc báo cáo tài chính gốc (PDF) theo mục: thuyết minh, bảng cân đối, kết quả kinh doanh, lưu chuyển tiền, ý kiến kiểm toán.
- Nhóm
- Báo cáo gốc
- Công cụ
read_financial_notes- Làm gì
- Đọc thuyết minh theo danh sách kiểm của từng loại doanh nghiệp, kèm bằng chứng trích dẫn và cờ theo ngưỡng.
- Nhóm
- Tính, xuất tệp
- Công cụ
compute- Làm gì
- Tính trên số đã tra hoặc số bạn đưa: tăng trưởng, CAGR, trung bình, beta, Sharpe, Gordon, DCF; trả kèm phép tính đã thay số.
- Nhóm
- Tính, xuất tệp
- Công cụ
export- Làm gì
- Xuất bảng ra CSV hoặc Excel, tối đa 5.000 dòng; link tải được lưu tối đa 24 giờ.
- Nhóm
- Tính, xuất tệp
- Công cụ
report- Làm gì
- Tạo báo cáo Word từ nội dung AI soạn, tối đa 3 biểu đồ; link tải được lưu tối đa 24 giờ.
- Nhóm
- Kiến thức
- Công cụ
load_knowledge_reference- Làm gì
- Tài liệu kiến thức: định giá, đọc báo cáo tài chính, vĩ mô và tiền tệ, chỉ báo kỹ thuật, danh mục.
- Nhóm
- Kiến thức
- Công cụ
load_skill- Làm gì
- Bộ cố vấn: cách lập luận và trình bày câu trả lời tư vấn. Chỉ gọi khi bạn đồng ý.
Công cụ trả số liệu, không nói đắt hay rẻ, không khuyến nghị mua bán. Không công cụ nào đặt lệnh, xem tài khoản chứng khoán hay chuyển tiền.
06Hình của kết quả
Phần này dành cho người muốn đọc hoặc kiểm tra số liệu trong kết quả công cụ. Bạn không cần biết để dùng.
Kết quả của mọi công cụ là một object {data, meta}. data chứa số liệu; meta chứa mô tả: cờ có dữ liệu, mô tả cột, đơn vị, độ tươi, ghi chú cắt. Bảng nằm trong data dạng {columns, rows}: columns là tên cột theo thứ tự, mỗi phần tử của rows là một mảng giá trị cùng độ dài và cùng thứ tự với columns. Không có dòng nào thì rows là mảng rỗng, columns vẫn đủ.
{
"data": {
"columns": ["date", "field:close_adj"],
"rows": [["2026-10-01", 118300.0], ["2026-10-02", null]]
},
"meta": {
"found": true, "has_data": true, "row_count": 2, "symbol": "FPT",
"columns": [{"id": "field:close_adj", "name_vi": "Giá đóng cửa điều chỉnh", "unit": "vnd_per_share"}],
"truncated": false
}
}meta.columnsmô tả từng cột:idtrùng với một tên trongdata.columns, kèm tên tiếng Việt và đơn vị. Hai khoácolumnscùng tên nhưng khác vai trò: một là tên cột theo thứ tự, một là mô tả cột. Báo cáo tài chính đặt mỗi chỉ tiêu trên một dòng, nênidở đó là mã chỉ tiêu trong cộtref.- Ô không có số là
null, không phải chuỗi ký tự. Ý nghĩa cụ thể của ô thiếu nằm ởmeta.columns[].read_range(ô ngoài khoảng đã đọc),meta.not_applicable_symbols(mã không áp dụng chỉ tiêu) hoặcreasoncủa ô. AI nói với bạn là «không có sẵn»; ô thiếu không phải số 0. - Kết quả
export:data.columnslà mã máy của cột trong tệp, còn tiêu đề tiếng Việt đúng như trong tệp nằm ởmeta.columns[].name_vi. Tệp giữ nguyên tiêu đề và chữ trong ô như trước. - Mọi API khác của chúng tôi (
/v1, trang web, tài khoản, chat) đều dùng dạng mỗi dòng một object. Riêng MCP dùng dạng cột và dòng vì AI đọc kết quả bằng token: dạng mỗi dòng một object dài gần gấp đôi trên chuỗi thời gian. Chúng tôi sẽ xem xét lại khi chi phí token không còn là ràng buộc, hoặc khi ứng dụng bên ngoài yêu cầu dạng object.
07Hạn mức
Mỗi tài khoản có hạn mức lượt gọi công cụ theo vai trò, tính trên hai cửa sổ thời gian. Trang Tổng quan cho biết bạn đã dùng bao nhiêu phần trăm.
- Mỗi lời gọi công cụ qua link riêng được tính một lượt;
load_skillvàload_knowledge_referencekhông tính. - Cửa sổ 5 giờ bắt đầu từ lời gọi đầu tiên; cửa sổ tuần được tính theo mốc riêng của tài khoản.
- Mọi link của một tài khoản đều dùng chung hạn mức.
- Hết lượt: công cụ báo cho AI thời điểm có lại để AI nói với bạn.
- Có thêm mức trần theo phút cho mỗi tài khoản để máy chủ hoạt động ổn định.
- Chat trên web tính hạn mức riêng, không trừ vào lượt MCP.
08Bảo mật và quyền riêng tư
Link MCP là chìa khoá vào hạn mức của bạn. Hãy giữ nó như giữ mật khẩu.
- Link chỉ hiện một lần lúc tạo. Chúng tôi chỉ lưu bản băm SHA-256 của mã, không lưu mã gốc, nên không thể gửi lại link cũ.
- Mỗi tài khoản có tối đa 5 link còn hiệu lực: hãy đặt tên theo từng ứng dụng để thu hồi riêng.
- Việc thu hồi có hiệu lực trong vòng một phút.
- Chúng tôi chỉ nhận lời gọi công cụ do ứng dụng AI gửi tới, không nhận nội dung hội thoại của bạn.
- Nhật ký máy chủ ghi nhận cho mỗi lời gọi: tên công cụ, thời gian chạy, kích thước kết quả, mã số tài khoản, tên ứng dụng gọi tới, phiên bản giao thức, tên các tham số và dạng kết quả (có số, rỗng hay lỗi); không ghi giá trị tham số bạn hỏi, không ghi mã trong link.
- Link tải tệp xuất chỉ dùng được khi link MCP đã tạo ra nó còn hiệu lực, và được giữ tối đa 24 giờ.
- Ứng dụng AI đọc kết quả công cụ theo chính sách dữ liệu của nhà cung cấp ứng dụng đó.
09Câu hỏi thường gặp
Những điều người dùng thường hỏi trước khi kết nối link.
- Có mất phí không?
- Không. dulieuchungkhoan.vn miễn phí; bạn chỉ trả phí gói của ứng dụng AI nếu có.
- Có cần biết lập trình không?
- Không. Bạn chỉ cần dán một link và hỏi bằng tiếng Việt. Muốn lấy dữ liệu bằng mã lệnh thì dùng API.
- Dữ liệu có theo thời gian thực không?
- Không. Kho dữ liệu cập nhật theo ngày. Trong sáu phiên đo tháng 10/2026, giá có trước 16:10, tỷ số trước 17:35, báo cáo tài chính trước 18:42; những ngày nguồn chậm có thể muộn hơn. Trong phiên, một số công cụ trả thêm số tạm khi có.
- Lịch sử xa nhất là bao lâu?
- Giá theo ngày có từ năm 2000 với các mã niêm yết sớm; mỗi mã bắt đầu từ ngày niêm yết của chính nó.
- AI có đặt lệnh hay khuyên mua bán không?
- Không đặt lệnh. Công cụ chỉ trả số liệu, không đánh giá đắt rẻ; quyết định đầu tư là của bạn. Dữ liệu chỉ dùng để tham khảo.
- Một link có dùng cho nhiều ứng dụng được không?
- Được, nhưng bạn nên tạo mỗi ứng dụng một link để thu hồi riêng khi cần.
- Ứng dụng báo lỗi kết nối thì làm gì?
- Kiểm tra link còn hiệu lực ở «Link MCP của tôi», dán lại đúng nguyên link, rồi mở hội thoại mới. Link đã thu hồi không dùng lại được.
Bắt đầu bằng một câu hỏi
Tạo link, dán vào ứng dụng AI, rồi hỏi về mã bạn đang theo dõi.
Cần hỗ trợ? Viết email cho chúng tôi