TrustyData

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

TrustyData MCP Server

LLM’nizi (Claude, ChatGPT, IDE asistanları…) TrustyData’a bağlayın — resmî açık veri kaynakları (BAN, INSEE, SIRENE, IGN, OpenStreetMap) üzerine kurulu Fransız adres verisi kalitesi, coğrafi kodlama, rota oluşturma, şirket arama (SIRENE) ve hizmet alanı istatistikleri (INSEE).

▶️ Canlı deneyin — herkese açık demo ajanı, hesap gerekmez Bir adresten doğrulama yapmasını, belediyeleri listelemesini, şirket aramasını veya rota hesaplamasını gerçek bir ajandan isteyin: ajan, bu MCP sunucusunu gözünüzün önünde çağırır.

Bu, barındırılan, uzak bir MCP sunucusudur — yüklemeniz veya çalıştırmanız gereken bir şey yoktur. MCP istemcinizi aşağıdaki uç noktaya yönlendirin ve TrustyData hesabınızla oturum açın.

Uç nokta	https://mcp.trustydata.app/mcp
Aktarım	Streamable HTTP
Kimlik doğrulama	OAuth 2.1 (TrustyData hesabınızla oturum açın)
Belgeler	https://trustydata.fr/docs/
Durum	https://status.trustydata.app

Bu depo, TrustyData MCP sunucusunun (server.json, belgeler, örnekler) herkese açık listeleme meta verilerini barındırır. Sunucunun kendisi barındırılan bir hizmettir — temel veri API’sinin kaynağı bu deponun parçası değildir.

Ne işe yarar?

TrustyData, karmaşık Fransız adreslerini temiz ve güvenilir verilere dönüştürür ve LLM konuşmanızın içinde doğrudan coğrafi bağlam ekler:

• Fransız posta adreslerini resmî BAN referansına göre doğrular ve standartlaştırır (sonuç güvenilirdir — boş sonuç eşleşme olmadığı anlamına gelir).
• Ad, posta kodu veya INSEE koduna göre adresleri ve yerleşim yerlerini arar; isteğe bağlı filtreler (il, bölge, nüfus) sunar.
• Yakınlık araması — bir konumun yakınındaki adresleri veya noktaları bulur.
• Rota oluşturma — Fransa’da OpenStreetMap verileriyle araba, yaya veya bisiklet için yol rotası ya da seyahat süresi/mesafe matrisi hesaplar.
• Şirket arama — resmî SIRENE sicilinde Fransız şirketlerini ve iş yerlerini arar ve tam kayıtları (planınıza bağlı olarak yöneticiler, mali bilgiler, toplu sözleşmeler) getirir.
• Hizmet alanları — bir sürüş süresi veya yarıçap bölgesinin nüfusu, hane sayısı, geliri, yaş ve sosyo-profesyonel profili, harcama potansiyeli (INSEE Filosofi ve nüfus sayımı); en fazla 10 bölgeyi karşılaştırır ve her birinin yalnızca kendine özgü kapsadığı alanı ölçer.
• Faaliyet dağılımı — bir hizmet alanındaki SIRENE iş yeri sayısını faaliyet ailesi ve alt ailesine göre, 10.000 kişi başına yoğunluk ve referans bölgeye göre endeksle gösterir: varsayılan olarak Fransa, istenirse bölgenin baskın département’ı. Bu sayı asgari bir değerdir, toplam değildir: yalnızca faal ve coğrafi konumu belirlenmiş iş yerleri sayılır; yanıtta hangi referansın kullanıldığı ve bu sayının referansın ne kadarını oluşturduğu belirtilir.
• İşletme başarısızlıkları — BODACC’ta yayımlanan toplu işlemler (tasfiye, konkordato, koruma) bölgedeki şirketin her iş yerinde sayılır; ayrıca faaliyet duruşları (aynı adreste devralma veya taşınma olmayan SIRENE kapanışları) 2017’den itibaren yıla ve faaliyete göre, 100 faal iş yeri başına oran ve referans bölgeye göre endeksle gösterilir. İşlemler asgari, duruşlar azami bir sayıdır ve içinde bulunulan yıl kısmi veriler içerir — yanıtta bu belirtilir.

Daha zengin alanlar (ör. INSEE Filosofi istatistiksel ızgarası, Lambert 93 koordinatları) planınıza bağlı olarak döndürülür.

Araçlar

Araç	Ne işe yarar?	Gerekli en düşük plan
verify_address	Fransız adresini BAN’a göre doğrular ve standartlaştırır	Discovery
search_address	Tam adresleri otomatik tamamlar / arar	Discovery
get_address_details	Belirli bir adres kimliği için tüm ayrıntıları getirir	Discovery
search_locality	Fransız belediyelerini / yerleşim yerlerini arar	Discovery
search_nearby	Bir noktanın çevresinde yakınlık araması yapar	Growth
route_matrix	Seyahat süresi / mesafe matrisi (araba, yaya, bisiklet)	Growth
compute_route	Noktalar arasında tam yol rotası (araba, yaya, bisiklet)	Business
search_company	SIRENE sicilinde Fransız şirketlerini ve iş yerlerini arar (ad, SIREN/SIRET, faaliyet, konum)	Discovery (yakınlık araması: Growth)
get_company_details	Bir iş yerinin veya şirketin tam kaydı (kimlik, yöneticiler, mali bilgiler, toplu sözleşmeler — plana göre)	Discovery
zone_stats	Bir hizmet alanıyla ilgili her şey (sürüş süresi veya yarıçap): nüfus, haneler, gelir, yaş ve sosyo-profesyonel profil, harcama potansiyeli, DVF gayrimenkul satış fiyatları (5 yıllık eğilim, département ile karşılaştırma) ve faaliyete göre iş yeri sayıları (SIRENE, 10.000 kişi başına yoğunluk, Fransa veya baskın département ile karşılaştırmalı endeks), 2017’den itibaren işletme başarısızlıkları ve faaliyet duruşları (BODACC + SIRENE)	Growth veya Pass Zones (15 gün, KDV hariç €30)
zone_compare	2–10 hizmet alanını karşılaştırır: yalnızca kapsanan nüfus, ikili örtüşmeler, sıralama — her biri tam zone_stats bloğuyla; gayrimenkul fiyatları ve faaliyet sayıları, 2017’den itibaren işletme başarısızlıkları ve faaliyet duruşları (BODACC + SIRENE) dâhil	Growth veya Pass Zones (15 gün, KDV hariç €30)

Tüm araçlar her istemciye duyurulur. Planınız bir aracı kapsamıyorsa araç sessizce başarısız olmak yerine yükseltme için uygulanabilir bir mesaj döndürür.

İstemler

Sunucu, araçların yanı sıra doğru parametreleri sizin için dolduran beş istem sunar. Claude Code’da bunlar /mcp__trustydata__<name> olarak görünür; diğer MCP istemcileri bunları kendi yöntemleriyle gösterir.

İstem	Bağımsız değişkenler	Ne işe yarar?
zone_de_chalandise	adresse, minutes (10), mode (araba)	Gayrimenkul satış fiyatları ve faaliyet sayılarıyla birlikte bir hizmet alanının tam INSEE profili
comparer_emplacements	adresses (2–10), minutes (10)	Konumları yalnızca kapsanan nüfusa göre sıralayarak karşılaştırır
potentiel_commerce	adresse, secteur, minutes (10), coefficient	Tahmini harcanabilir gelir ve sektör harcama potansiyeli
verifier_adresses	adresses	Her adres için bir çağrı yaparak adres listesini doğrular
qualifier_entreprise	nom_ou_siret	SIRENE’de şirket bulur ve tam kaydını açar

İstem adları ve ifadeleri, tanımladıkları veriler gibi Fransızcadır. İstem bir sonuç değil, mesaj döndürür: kendi başına araç çağırmaz ve kota tüketmez — asistan aracı çağırdığında, aracın kendi plan gereksinimi geçerli olur.

Bağlanma

Claude (claude.ai / Claude Desktop)

Şuraya yönlendiren bir özel bağlayıcı ekleyin:

https://mcp.trustydata.app/mcp

Bir araç ilk kez kullanıldığında TrustyData hesabınızla OAuth üzerinden oturum açmanız istenir.

Genel MCP istemcisi (Streamable HTTP)

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

Henüz hesabınız yok mu? trustydata.fr üzerinden ücretsiz başlayın — Discovery planı ücretsizdir (ayda 20.000 istek, kart gerekmez).

Örnek istemler (serbest biçimli)

İsteme gerek yok — doğrudan sorun:

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 ?

Veri kaynakları ve atıf

TrustyData, resmî ve düzenli olarak güncellenen açık verilerden yararlanır. Lütfen araçların döndürdüğü atıfları koruyun:

• Adresler ve belediyeler — Base Adresse Nationale (BAN) ve INSEE
• Şirketler — SIRENE (INSEE), Registre National des Entreprises (INPI)
• İstatistiksel bağlam ve hizmet alanları — INSEE Filosofi ve nüfus sayımı, IGN Contours IRIS
• Gayrimenkul satış fiyatları — DGFiP, Demandes de valeurs foncières (Etalab, açık lisans)
• Faaliyete göre iş yerleri — SIRENE (INSEE), yalnızca faal ve coğrafi konumu belirlenmiş iş yerleri
• İşletme başarısızlıkları — BODACC (DILA) ve SIRENE (INSEE), yalnızca coğrafi konumu belirlenmiş iş yerleri
• Rota oluşturma — OpenStreetMap katkıda bulunanları (ODbL)

ChatGPT eklenti paketi

plugin-chatgpt/ dizini, ChatGPT eklenti dizinine gönderilen TrustyData eklentisinin kaynağıdır (Agent Plugins biçimi: plugin.json, mcp.json, skills/, assets/). Aynı barındırılan sunucuya yönlendirir ve gizli bilgi içermez: demo videosu URL’si yalnızca derleme sırasında eklenir.

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

Betik yalnızca izin verilen dosyaları pakete ekler, fazladan dosyaları veya gizli bilgi olabilecek her şeyi reddeder ve dist/trustydata-plugin-<version>.zip dosyasını yazar. Bu ZIP’i OpenAI geliştirici panosundaki mevcut TrustyData eklentisine yükleyin (asla ikinci bir eklenti olarak yüklemeyin). Testler: pip install -r requirements-dev.txt && pytest.

Belgeler

Tam API kılavuzları, uç nokta başvurusu ve örnekler: https://trustydata.fr/docs/

Lisans

Bu listeleme deposunun içeriği (belgeler, server.json, örnekler) MIT Lisansı kapsamında yayımlanmıştır. Barındırılan hizmet ve temel veri API’si TrustyData tarafından işletilir ve TrustyData’nın koşullarına tabidir.