Saltar al contenido principal
Desarrolladores

Servidor MCP de JustOneEvent

JustOneEvent expone un servidor MCP (Model Context Protocol): conecta Claude Desktop, Cursor o cualquier cliente MCP compatible para crear y gestionar tus eventos en lenguaje natural.

Autenticación

Genera una clave API en tu panel y luego envíala en la cabecera Authorization de cada solicitud (clave personal o token OAuth):

Authorization: Bearer joe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Cada clave actúa solo sobre tu cuenta. Revocable en cualquier momento desde el panel.

Conectar

Genera una clave API en tu panel y luego añade este bloque a la configuración de tu cliente MCP (sustituye el token):

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

Cada clave actúa solo sobre la cuenta que la creó. Revócala cuando quieras desde el panel.

Referencia de endpoints

Haz clic en un endpoint para ver sus parámetros, el cuerpo de la solicitud y un ejemplo de respuesta. Todas las respuestas son JSON.

Autenticado — se requiere clave API

POST /api/v1/events

Crear un evento (título, descripción, lugar, fechas, aforo, visibilidad).

Cuerpo de la solicitud

{
  "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":["…"] }]
}

Ejemplos de respuesta

{ "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

Listar tus eventos (activos, pasados o todos) con el recuento de inscripciones.

Parámetros

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

Ejemplos de respuesta

{ "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}

Obtener los detalles y las estadísticas de inscripción de un evento.

Ejemplos de respuesta

{ "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

Listar los inscritos de un evento (solo planes de pago).

Ejemplos de respuesta

{ "items": [ { "name":"…","email":"…","registered_at":"…",
    "status":"Confirmed","checked_in":false } ], "count": 1 }
POST /api/v1/me/events/{id}/cancel

Cancelar un evento (se requiere confirmación explícita).

Cuerpo de la solicitud

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

Ejemplos de respuesta

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

Público de solo lectura — sin clave

GET /api/v1/events

Lista los eventos públicos, publicados y próximos.

Parámetros

limit  = 1–100 (default 50)
offset = ≥0    (default 0)
GET /api/v1/events/{slug}

Obtiene un único evento público por su slug.

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

Listas estáticas de casos de uso y guías (slugs + URL).

OpenAPI

Contrato completo (todos los endpoints, campos y esquemas): Especificación OpenAPI. Impórtalo en Postman, Insomnia o un generador de clientes.

¿Listo para conectar tu asistente?

Genera una clave API en segundos desde tu panel.

Generar una clave API