Trên trang này

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.

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

Hình của link
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
    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 đủ.

Một chuỗi giá
{
  "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.columns mô tả từng cột: id trùng với một tên trong data.columns, kèm tên tiếng Việt và đơn vị. Hai khoá columns cù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ên id ở đó là mã chỉ tiêu trong cột ref.
  • Ô 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ặc reason củ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.columns là 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_skill và load_knowledge_reference khô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