API et serveur MCP de l’agenda nocturne

API JSON gratuite, en lecture seule, sans clé, CORS ouvert. Les données sont reconstruites chaque nuit à partir des annonces publiques et mises en cache 5 minutes.

Règle d’usage : chaque événement contient url (notre fiche, avec utm_source=api) et source_links (les annonces originales). Affichez et liez les deux : nous ne faisons que rassembler le travail des lieux et collectifs. Mettez en cache chez vous ; environ 1 requête/seconde maximum.

Endpoints

Chemin	Rôle
GET`/api/v1/events`	recherche d’événements (filtres ci-dessous)
GET`/api/v1/events/{id}`	un événement
GET`/api/v1/venues`	lieux avec des dates à venir
GET`/api/v1/cities`	zones et villes
GET`/api/v1/genres`	styles
GET`/openapi.json`	OpenAPI 3.1
GET`/mcp`	serveur MCP pour agents IA

Filtres de /api/v1/events

Paramètre	Valeurs
`date`	YYYY-MM-DD	une nuit
`from / to`	YYYY-MM-DD	plage de nuits (défaut : dès ce soir)
`when`	tonight \| tomorrow \| weekend	raccourci (week-end = ven.–dim.)
`city / area`	geneve, lausanne, nyon, la-cote, france-voisine, annemasse…	zone ou ville (slug)
`venue`	les-docks-lausanne	slug du lieu (voir /api/v1/venues)
`genre`	techno, house, jazz, hip-hop, rock/indie…	style
`free`	true	gratuit / entrée libre / prix libre
`q`	texte	recherche (titre, lieu, artiste)
`lang`	fr \| en	langue des descriptions et des URL
`limit`	1–100 (20)	taille de page
`offset / cursor`	0 / meta.next_cursor	pagination

Exemples

/api/v1/events?when=tonight&city=geneve · Ce soir à Genève
/api/v1/events?when=weekend&city=lausanne&genre=techno&lang=en · Techno ce week-end à Lausanne
/api/v1/events?free=true&when=weekend · Gratuit / prix libre ce week-end
/api/v1/events?from=2026-11-06&to=2026-11-08&city=nyon · Plage de dates à Nyon
/api/v1/events?q=jazz&limit=5&offset=5 · Recherche texte + pagination
/api/v1/events?venue=les-docks-lausanne · Un lieu (slug)
/api/v1/venues?city=france-voisine · Lieux en France voisine
/api/v1/cities · Zones et villes
/api/v1/genres · Styles

curl -s 'https://geneversleep.ch/api/v1/events?when=tonight&city=geneve&limit=2&lang=fr'

{ "meta": { "total": 9, "count": 2, "limit": 2, "next_cursor": "o2", "from": "2026-11-03", ... },
  "events": [ { "id": "gns-2026-11-03-a01b1180", "title": "Fly Anakin & Quelle Chris",
      "date": "2026-11-03", "start_time": "19:00", "venue": "Bongo Joe", "city": "Genève",
      "genres": ["hip-hop"], "price": "10-15CHF", "is_free": false,
      "url": "https://geneversleep.ch/soiree/2026-11-03-fly-anakin-quelle-chris-a01b1180?utm_source=api",
      "source_links": [ { "name": "Bongo Joe", "url": "https://…" } ] } ] }

Serveur MCP pour agents IA

Point d’accès distant Streamable HTTP, lecture seule, sans authentification : https://geneversleep.ch/mcp. Outils : search_events, events_tonight, events_weekend, free_events, venue_events, list_venues.

Claude Code

claude mcp add --transport http geneversleep https://geneversleep.ch/mcp

Claude (claude.ai / Desktop) : Réglages → Connecteurs → Ajouter un connecteur personnalisé → URL https://geneversleep.ch/mcp. Ancien Claude Desktop (claude_desktop_config.json) :

{
  "mcpServers": {
    "geneversleep": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://geneversleep.ch/mcp"
      ]
    }
  }
}

ChatGPT : Réglages → Applications et connecteurs → Mode développeur → Créer → URL du serveur MCP https://geneversleep.ch/mcp, authentification « Aucune ».

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "geneversleep": {
      "url": "https://geneversleep.ch/mcp"
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "geneversleep": {
      "type": "http",
      "url": "https://geneversleep.ch/mcp"
    }
  }
}

Widgets pour votre site

Pas envie de coder ? Prenez un encadré prêt à coller (ville, style, gratuit, newsletter) : générateur de widgets.

Découverte

Questions, quotas plus élevés, données manquantes ? [email protected]