api-sorties-mcp

api-sorties-mcp

Serveur MCP (Model Context Protocol) pour API Sorties France — recherche d'événements et sorties en France (concerts, spectacles, expositions, marchés, sport), agrégés depuis plusieurs sources open data, normalisés et dédupliqués.

Installation

Nécessite une clé API — créez-en une gratuitement depuis le portail développeur.

Ajoutez ceci à la configuration de votre client MCP (Claude Desktop, etc.) :

{
  "mcpServers": {
    "api-sorties-france": {
      "command": "npx",
      "args": ["-y", "api-sorties-mcp"],
      "env": {
        "API_SORTIES_BASE_URL": "https://api.sorties.dev",
        "API_SORTIES_API_KEY": "<votre clé API>"
      }
    }
  }
}

Outils exposés

Outil	Rôle
search_events	Recherche paginée par ville, code INSEE, position géo + rayon, période, catégorie, gratuité, texte libre.
get_event	Fiche d'un événement par identifiant.
get_venue	Fiche d'un lieu (salle, musée, place) par identifiant.
list_categories	Taxonomie complète des catégories.

Chaque outil reflète fidèlement le contrat public GET /v1/... de l'API — voir la documentation complète pour le détail de chaque paramètre.

Ce que ça fait, et ce que ça ne fait pas

• Toutes les opérations sont en lecture seule.
• search_events sans filtre de date ne retourne pas les événements à venir par défaut — bornez la période (from/to/endsAfter).
• Les erreurs (clé invalide, quota dépassé, paramètre refusé) sont renvoyées comme résultat d'outil lisible par l'agent, jamais comme exception de protocole.

Licence

MIT