TrustyData

npx add-mcp 'https://mcp.trustydata.app/mcp'

TrustyData MCP Server

Kết nối LLM của bạn (Claude, ChatGPT, trợ lý IDE…) với TrustyData — dịch vụ đảm bảo chất lượng dữ liệu địa chỉ tại Pháp, mã hóa địa lý, định tuyến, tra cứu doanh nghiệp (SIRENE) và thống kê vùng phục vụ (INSEE), được xây dựng trên các nguồn dữ liệu mở chính thức (BAN, INSEE, SIRENE, IGN, OpenStreetMap).

▶️ Dùng thử trực tiếp — tác nhân demo công khai, không cần tài khoản Yêu cầu một tác nhân thực tế xác minh địa chỉ, liệt kê các xã, tra cứu doanh nghiệp hoặc tính tuyến đường: tác nhân sẽ gọi máy chủ MCP này ngay trước mắt bạn.

Đây là máy chủ MCP từ xa được lưu trữ — bạn không cần cài đặt hay chạy bất cứ thứ gì. Trỏ ứng dụng MCP của bạn đến điểm cuối bên dưới và đăng nhập bằng tài khoản TrustyData.

Điểm cuối	https://mcp.trustydata.app/mcp
Giao thức truyền tải	Streamable HTTP
Xác thực	OAuth 2.1 (đăng nhập bằng tài khoản TrustyData)
Tài liệu	https://trustydata.fr/docs/
Trạng thái	https://status.trustydata.app

Kho lưu trữ này chứa siêu dữ liệu danh sách công khai của máy chủ TrustyData MCP (server.json, tài liệu, ví dụ). Bản thân máy chủ là một dịch vụ được lưu trữ — mã nguồn của API dữ liệu nền tảng không thuộc kho lưu trữ này.

Chức năng

TrustyData chuyển đổi địa chỉ Pháp lộn xộn thành dữ liệu sạch, có thẩm quyền và bổ sung ngữ cảnh địa lý ngay trong cuộc trò chuyện với LLM của bạn:

• Xác minh và chuẩn hóa địa chỉ bưu chính tại Pháp theo dữ liệu tham chiếu chính thức BAN (kết quả có tính thẩm quyền — kết quả trống nghĩa là không tìm thấy kết quả khớp).
• Tìm kiếm địa chỉ và địa danh theo tên, mã bưu chính hoặc mã INSEE, kèm các bộ lọc tùy chọn (tỉnh, vùng, dân số).
• Tìm kiếm lân cận — tìm địa chỉ hoặc điểm gần một vị trí.
• Định tuyến — tính tuyến đường bộ hoặc ma trận thời gian di chuyển/khoảng cách tại Pháp (OpenStreetMap), bằng ô tô, đi bộ hoặc xe đạp.
• Tra cứu doanh nghiệp — tìm kiếm doanh nghiệp và cơ sở tại Pháp trong danh bạ chính thức SIRENE và lấy hồ sơ đầy đủ (lãnh đạo, tài chính, thỏa ước tập thể, tùy theo gói dịch vụ).
• Vùng phục vụ — dân số, hộ gia đình, thu nhập, độ tuổi và hồ sơ nghề nghiệp-xã hội, tiềm năng chi tiêu của vùng tính theo thời gian lái xe hoặc bán kính (INSEE Filosofi và điều tra dân số); so sánh tối đa 10 vùng và đo lường phần diện tích mỗi vùng bao phủ riêng.
• Cơ cấu hoạt động — số lượng cơ sở SIRENE trong vùng phục vụ, phân theo nhóm và nhóm phụ hoạt động, kèm mật độ trên 10.000 cư dân và chỉ số so với một lãnh thổ tham chiếu: mặc định là Pháp, hoặc tỉnh có tỷ trọng lớn nhất trong vùng nếu bạn yêu cầu. Đây là mức tối thiểu, không phải tổng số: chỉ tính các cơ sở đang hoạt động, đã định vị địa lý; phản hồi cho biết lãnh thổ tham chiếu nào được sử dụng và số lượng đó chiếm tỷ lệ bao nhiêu trong tổng số.
• Doanh nghiệp gặp khó khăn — các thủ tục tập thể được công bố trên BODACC (thanh lý, phục hồi hoạt động, bảo hộ), được tính trên mọi cơ sở của doanh nghiệp nằm trong khu vực, và các trường hợp ngừng hoạt động (cơ sở SIRENE đóng cửa nhưng không phải do tiếp quản tại cùng địa chỉ hoặc chuyển địa điểm), theo năm kể từ 2017 và theo hoạt động, kèm tỷ lệ trên 100 cơ sở đang hoạt động và chỉ số so với lãnh thổ tham chiếu. Số thủ tục là mức tối thiểu, số trường hợp ngừng hoạt động là mức tối đa, và dữ liệu năm hiện tại chưa đầy đủ — phản hồi sẽ nêu rõ điều này.

Các trường dữ liệu phong phú hơn (ví dụ: lưới thống kê INSEE Filosofi, tọa độ Lambert 93) được trả về tùy theo gói dịch vụ của bạn.

Công cụ

Công cụ	Chức năng	Gói tối thiểu
verify_address	Xác minh và chuẩn hóa địa chỉ tại Pháp theo BAN	Discovery
search_address	Tự động hoàn thành / tìm kiếm địa chỉ đầy đủ	Discovery
get_address_details	Thông tin chi tiết đầy đủ cho một mã địa chỉ cụ thể	Discovery
search_locality	Tìm kiếm xã / địa danh tại Pháp	Discovery
search_nearby	Tìm kiếm lân cận quanh một điểm	Growth
route_matrix	Ma trận thời gian di chuyển / khoảng cách (ô tô, đi bộ, xe đạp)	Growth
compute_route	Tuyến đường bộ đầy đủ giữa các điểm (ô tô, đi bộ, xe đạp)	Business
search_company	Tìm kiếm doanh nghiệp và cơ sở tại Pháp trong danh bạ SIRENE (tên, SIREN/SIRET, hoạt động, vị trí)	Discovery (tìm kiếm lân cận: Growth)
get_company_details	Hồ sơ đầy đủ của một cơ sở hoặc doanh nghiệp (thông tin nhận dạng, lãnh đạo, tài chính, thỏa ước tập thể — tùy theo gói dịch vụ)	Discovery
zone_stats	Mọi thông tin về vùng phục vụ (thời gian lái xe hoặc bán kính): dân số, hộ gia đình, thu nhập, độ tuổi và hồ sơ nghề nghiệp-xã hội, tiềm năng chi tiêu, giá bán bất động sản DVF (xu hướng 5 năm, so với tỉnh) và số lượng cơ sở theo hoạt động (SIRENE, mật độ trên 10.000 cư dân, chỉ số so với Pháp hoặc tỉnh có tỷ trọng lớn nhất), doanh nghiệp gặp khó khăn và trường hợp ngừng hoạt động kể từ 2017 (BODACC + SIRENE)	Growth hoặc Pass Zones (15 ngày, €30 chưa gồm VAT)
zone_compare	So sánh 2–10 vùng phục vụ: dân số được bao phủ riêng, phần giao nhau theo từng cặp, xếp hạng — mỗi vùng có khối zone_stats đầy đủ, bao gồm giá bất động sản và số lượng hoạt động, doanh nghiệp gặp khó khăn và trường hợp ngừng hoạt động kể từ 2017 (BODACC + SIRENE)	Growth hoặc Pass Zones (15 ngày, €30 chưa gồm VAT)

Tất cả công cụ đều được giới thiệu cho mọi ứng dụng. Nếu gói dịch vụ của bạn không bao gồm một công cụ, công cụ đó sẽ trả về thông báo hướng dẫn nâng cấp thay vì âm thầm thất bại.

Prompt

Ngoài các công cụ, máy chủ còn cung cấp năm prompt — các gợi ý có hướng dẫn, tự điền các tham số phù hợp cho bạn. Trong Claude Code, chúng xuất hiện dưới dạng /mcp__trustydata__<name>; các ứng dụng MCP khác hiển thị theo cách riêng.

Prompt	Đối số	Chức năng
zone_de_chalandise	adresse, minutes (10), mode (car)	Hồ sơ INSEE đầy đủ của vùng phục vụ, kèm giá bán bất động sản và số lượng hoạt động
comparer_emplacements	adresses (2–10), minutes (10)	So sánh các vị trí, xếp hạng theo dân số được bao phủ riêng
potentiel_commerce	adresse, secteur, minutes (10), coefficient	Ước tính thu nhập khả dụng và tiềm năng chi tiêu theo ngành
verifier_adresses	adresses	Xác minh danh sách địa chỉ, mỗi địa chỉ một lần gọi
qualifier_entreprise	nom_ou_siret	Tìm doanh nghiệp trong SIRENE và mở hồ sơ đầy đủ

Tên và cách diễn đạt của prompt bằng tiếng Pháp, giống như dữ liệu mà chúng mô tả. Prompt trả về một thông điệp, không phải kết quả: bản thân prompt không gọi công cụ nào và không tiêu tốn hạn mức — công cụ mà prompt hướng đến sẽ áp dụng yêu cầu gói dịch vụ riêng khi trợ lý gọi công cụ đó.

Kết nối

Claude (claude.ai / Claude Desktop)

Thêm một trình kết nối tùy chỉnh trỏ đến:

https://mcp.trustydata.app/mcp

Lần đầu sử dụng công cụ, bạn sẽ được yêu cầu đăng nhập qua OAuth bằng tài khoản TrustyData.

Ứng dụng MCP chung (Streamable HTTP)

{
  "mcpServers": {
    "trustydata": {
      "url": "https://mcp.trustydata.app/mcp"
    }
  }
}

Chưa có tài khoản? Bắt đầu miễn phí tại trustydata.fr — gói Discovery miễn phí (20.000 yêu cầu/tháng, không cần thẻ thanh toán).

Ví dụ prompt (tự do)

Không cần prompt — chỉ cần hỏi:

Vérifie et normalise cette adresse : "1 rue de Rivol 75001 Pari"

Quelle est la population de la commune de Bourg-en-Bresse ?

Trouve les adresses proches du 2 avenue de la Gare à Annecy.

Calcule l'itinéraire routier entre Lyon Part-Dieu et l'aéroport Saint-Exupéry.

Trouve les entreprises de plomberie à Annecy et donne-moi la fiche du premier établissement.

Combien de personnes habitent à 15 minutes en voiture du 1 rue Scribe, 75009 Paris, et quel est leur niveau de vie ?

Compare 10 minutes en voiture autour de la Part-Dieu et autour de Bellecour : quelle zone capte le plus d'habitants qu'elle est seule à couvrir ?

Combien d'établissements de restauration y a-t-il à 10 minutes à pied de la place Bellecour, et est-ce beaucoup pour le nombre d'habitants ?

Nguồn dữ liệu và ghi công

TrustyData sử dụng dữ liệu mở chính thức, được cập nhật thường xuyên. Vui lòng giữ lại các thông tin ghi công do công cụ trả về:

• Địa chỉ và xã — Base Adresse Nationale (BAN) và INSEE
• Doanh nghiệp — SIRENE (INSEE), Registre National des Entreprises (INPI)
• Ngữ cảnh thống kê và vùng phục vụ — INSEE Filosofi và điều tra dân số, IGN Contours IRIS
• Giá bán bất động sản — DGFiP, Demandes de valeurs foncières (Etalab, giấy phép mở)
• Cơ sở theo hoạt động — SIRENE (INSEE), chỉ các cơ sở đang hoạt động đã định vị địa lý
• Doanh nghiệp gặp khó khăn — BODACC (DILA) và SIRENE (INSEE), chỉ các cơ sở đã định vị địa lý
• Định tuyến — những người đóng góp OpenStreetMap (ODbL)

Gói plugin ChatGPT

Thư mục plugin-chatgpt/ là nguồn của plugin TrustyData được gửi đến danh mục plugin ChatGPT (định dạng Agent Plugins: plugin.json, mcp.json, skills/, assets/). Plugin trỏ đến cùng một máy chủ được lưu trữ và không chứa bí mật: URL video demo chỉ được chèn vào lúc tạo bản dựng.

python3 plugin-chatgpt/build_zip.py --video <demo recording url> --sortie dist/

Tập lệnh chỉ đóng gói các tệp nằm trong danh sách cho phép, từ chối mọi tệp lạ hoặc bất kỳ nội dung nào có vẻ là bí mật, rồi tạo dist/trustydata-plugin-<version>.zip. Tải tệp ZIP đó lên plugin TrustyData hiện có trong bảng điều khiển nhà phát triển OpenAI (không bao giờ tạo plugin thứ hai). Kiểm thử: pip install -r requirements-dev.txt && pytest.

Tài liệu

Hướng dẫn API đầy đủ, tài liệu tham khảo điểm cuối và ví dụ: https://trustydata.fr/docs/

Giấy phép

Nội dung của kho lưu trữ danh sách này (tài liệu, server.json, ví dụ) được phát hành theo Giấy phép MIT. Dịch vụ được lưu trữ và API dữ liệu nền tảng do TrustyData vận hành và chịu sự điều chỉnh theo các điều khoản của TrustyData.