ShoWhere

Serveur MCP ShoWhere

Le catalogue géomarketing ShoWhere, interrogeable en langage naturel depuis votre client MCP. Anonyme : pas de clé, pas de compte, pas d'OAuth.

Endpoint

https://mcp.showhere.fr/

  • Streamable HTTP
  • JSON-RPC 2.0
  • POST uniquement

Connexion

Brancher le serveur sur votre client

https://mcp.showhere.fr/

Le serveur expose un endpoint unique en Streamable HTTP : chaque message est une requête JSON-RPC 2.0 envoyée en POST. Aucune autre méthode HTTP n'est acceptée.

Il est anonyme. Ni clé d'API, ni compte, ni OAuth : l'URL suffit.

Le corps d'une requête est limité à 64 Ko.

En-tête Origin

Une requête portant un en-tête Origin d'un autre hôte est refusée, par protection contre le DNS rebinding. Un Origin absent est accepté : c'est le cas nominal d'un agent serveur à serveur.

Configurer votre client

La syntaxe de configuration diffère d'un client à l'autre et évolue régulièrement. Déclarez l'URL du serveur comme serveur MCP distant, en suivant la documentation de votre client.

Spécification du transport Streamable HTTP

Outils

Ce que le serveur sait faire

Cinq outils, du parcours du catalogue jusqu'aux valeurs communales.

  • showhere_list_categories

    Catégories du catalogue public, avec le nombre d'indicateurs de chacune.

    • Sans paramètre.

  • showhere_search_indicators

    Recherche sémantique en langage naturel dans le catalogue : comportements, équipement, consommation, profils.

    Ne renvoie aucun chiffre.

    • query requis.
    • limit ≤ 20.

  • showhere_get_indicator

    Fiche publique d'un indicateur, à partir de l'uuid rendu par la recherche, et si ses chiffres sont ouverts sur le serveur public.

    • uuid rendu par la recherche.

  • showhere_resolve_place

    Nom de commune française vers code INSEE.

    • Niveau commune uniquement.
    • Nom ≤ 100 caractères.

  • showhere_get_indicator_values

    Valeurs communales d'un indicateur ouvert : taux et effectif.

    • Niveau commune uniquement.
    • 25 zones par appel maximum.

Limites

Quotas et refus

Quotas

Fenêtre fixe, par adresse IP.

  • 60 appels par minute sur le serveur.
  • Dont 20 appels par minute pour showhere_get_indicator_values.
  • Corps de requête limité à 64 Ko.

Refus qualifiés

Un refus n'est pas une erreur de schéma : il est explicite et porte un lien.

  • Indicateur non public.
  • Indicateur introuvable.
  • Granularité refusée.
  • Projection absente.
  • Zones non couvertes.
  • Plafond de zones dépassé.

Découverte

De la découverte au devis

Chaque réponse du serveur porte un lien de découverte vers la fiche publique de l'indicateur visé, sur la plateforme ShoWhere. Cette page montre l'indicateur et permet de demander un devis.

Ce serveur est une vitrine du catalogue géomarketing ShoWhere, pas l'API client. Il expose les indicateurs publics et, pour ceux dont les chiffres sont ouverts, leurs valeurs à la commune.