Développeurs

Serveur MCP JustOneEvent

JustOneEvent expose un serveur MCP (Model Context Protocol) : connectez Claude Desktop, Cursor ou tout client MCP compatible pour créer et gérer vos événements en langage naturel.

Authentification

Générez une clé API dans votre tableau de bord, puis envoyez-la dans l'en-tête Authorization de chaque requête (clé personnelle ou jeton OAuth) :

Authorization: Bearer joe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Chaque clé n'agit que sur votre compte. Révocable à tout moment depuis le tableau de bord.

Se connecter

Générez une clé API dans votre tableau de bord, puis ajoutez ce bloc à la configuration de votre client MCP (remplacez le token) :

{
  "mcpServers": {
    "justoneevent": {
      "url": "https://www.justoneevent.com/mcp",
      "headers": {
        "Authorization": "Bearer joe_live_xxx"
      }
    }
  }
}

Chaque clé agit uniquement sur le compte qui l'a créée. Révoquez-la à tout moment depuis le tableau de bord.

Référence des endpoints

Cliquez un endpoint pour voir ses paramètres, son corps de requête et un exemple de réponse. Toutes les réponses sont en JSON.

Authentifié — clé API requise

POST /api/v1/events Créer un événement (titre, description, lieu, dates, capacité, visibilité).

Créer un événement (titre, description, lieu, dates, capacité, visibilité).

Corps de la requête

{
  "title":        "string   (required, 3–200)",
  "description":  "string   (required)",
  "location":     "string   (required)",
  "start_date":   "string   (required, ISO-8601)",
  "end_date":     "string   (optional, defaults to start_date)",
  "max_capacity": "integer  (optional, 1–10000, default 100)",
  "is_public":    "boolean  (optional, default false)",
  "city":         "string   (optional, ≤120)",
  "image_query":  "string   (optional, auto-fetch a stock cover)",
  "custom_fields":[{ "label":"string", "field_type":"text|integer|select|multi_select|checkbox",
                     "required":false, "options":["…"] }]
}

Exemples de réponse

{ "id": "uuid", "slug": "my-event",
  "event_url": "https://www.justoneevent.com/events/my-event",
  "admin_url": "https://www.justoneevent.com/dashboard/events/uuid/edit" }

GET /api/v1/me/events Lister vos événements (actifs, passés ou tous) avec le nombre d'inscriptions.

Lister vos événements (actifs, passés ou tous) avec le nombre d'inscriptions.

Paramètres

status = active | past | all   (default active)
limit  = 1–100                 (default 20)

Exemples de réponse

{ "items": [ { "id":"uuid","slug":"…","title":"…","start_date":"…",
    "registration_count":0,"max_capacity":100,
    "is_published":true,"is_cancelled":false,"event_url":"…" } ], "count": 1 }

GET /api/v1/me/events/{id} Récupérer le détail et les statistiques d'inscription d'un événement.

Récupérer le détail et les statistiques d'inscription d'un événement.

Exemples de réponse

{ "id":"uuid","slug":"…","title":"…","description":"…","location":"…",
  "start_date":"…","end_date":"…","timezone":"UTC","max_capacity":100,
  "is_published":true,"is_cancelled":false,
  "registrations_total":0,"registrations_confirmed":0,"event_url":"…" }

GET /api/v1/me/events/{id}/registrations

Lister les inscrits d'un événement (réservé aux plans payants).

Exemples de réponse

{ "items": [ { "name":"…","email":"…","registered_at":"…",
    "status":"Confirmed","checked_in":false } ], "count": 1 }

POST /api/v1/me/events/{id}/cancel

Annuler un événement (confirmation explicite requise).

Corps de la requête

{ "reason": "string (optional)" }

Exemples de réponse

{ "id":"uuid","cancelled":true,"reason":"…","registrants_notified":12 }

Lecture publique — sans clé

GET /api/v1/events Lister les événements publics, publiés et à venir.

Lister les événements publics, publiés et à venir.

Paramètres

limit  = 1–100 (default 50)
offset = ≥0    (default 0)

GET /api/v1/events/{slug} Détail d'un événement public par son slug.

Détail d'un événement public par son slug.

GET /api/v1/use-cases· /api/v1/guides

Listes statiques des cas d'usage et des guides (slugs + URLs).

OpenAPI

Contrat complet (tous les endpoints, champs et schémas) : spécification OpenAPI. Importable dans Postman, Insomnia ou un générateur de client.

Prêt à connecter votre assistant ?

Générez une clé API en quelques secondes depuis votre tableau de bord.

Générer une clé API