MCP

Aion dentro de tu asistente

Aion Vibes expone un servidor MCP: conectas Claude — o cualquier otro cliente que hable el mismo protocolo — y desde ahí buscas eventos, te inscribes, sigues una comunidad. Con una cuenta conectada, creas y publicas tus propias noches. Sin abrir el sitio.

La mitad de las herramientas no necesita una cuenta.

Buscar eventos, leer sus detalles, inscribirse y seguir una comunidad funcionan en cuanto añades el servidor: inscribirse envía el QR por correo y los enlaces para el wallet, sin que nadie tenga que registrarse antes. La cuenta sirve para crear y publicar — es decir, para actuar en nombre de alguien.

Conéctalo en cuatro pasos

  1. 1

    Añade el servidor

    En tu cliente MCP indica la dirección. No hace falta ninguna clave: el cliente se registra solo.

    claude mcp add --transport http aion https://api.aionvibes.com/mcp/
  2. 2

    Autoriza desde el navegador

    El cliente abre una página de Aion que dice quién está pidiendo acceso y qué podrá hacer. Inicia sesión con Google o con tu correo, y pulsa Autorizar.

  3. 3

    Vuelve a abrir la terminalProblema habitual

    Close the window you launched the command from and open a new one. The session you had open loaded the tool list when it started — before the token existed — and will keep not seeing Aion: it's not an error to retry. From a fresh terminal, claude mcp list answers ✔ Connected.

  4. 4

    Pregunta

    "Publica un evento el 15 de octubre en Brescia sobre Local AI vs Cloud AI, con una portada nocturna" se convierte en un borrador, una portada y un evento publicado.

Qué pasa con tus credenciales

Ninguna contraseña en el cliente. La conexión pasa por OAuth 2.1: inicias sesión en aionvibes.com, y el cliente recibe un token que solo vale para él.

PKCE obligatorio. El código de autorización que vuelve al cliente no basta por sí solo para obtener un token: hace falta un secreto que el cliente guardó y que nunca pasó por el navegador.

Un solo uso. Los códigos y los refresh token se gastan en el primer uso. El token de acceso dura una hora y se renueva solo; si dejas de usarlo, la conexión caduca a los treinta días.

Tus permisos, nada más. El cliente actúa como tú: ve las comunidades que gestionas, y nada más. Las analíticas de la plataforma solo responden a la cuenta de administración.

Las herramientas

Buscar

Sin cuenta

Qué se hace, y dónde. Funciona incluso para quien nunca ha visto Aion.

find_events

Busca por ciudad, periodo, categoría o texto libre.

Incluye también avisos recopilados de otras plataformas, marcados como tales: se abren en el enlace de origen, no se reservan aquí.

get_event

El detalle de un evento: horario, lugar, precio, aforo.

También dice si la inscripción es inmediata o si el organizador tiene que aprobarla.

list_event_categories

Las categorías, con slug y color.

list_cities

Dónde tiene Aion eventos, y cuántos.

list_featured_communities

Quién organiza con continuidad.

whats_on_digest

Un resumen de lo que se hace en una ciudad, ya condensado y ordenado.

Pensado para reescribirse en un mensaje que se pega en un grupo, no para consultarse.

Participar

Sin cuenta

El punto en el que una conversación se convierte en una persona inscrita en una noche. Siempre sin cuenta.

rsvp_to_event

Inscribe a alguien: nombre, correo, y el QR sale por correo.

Ninguna app que descargar antes, ninguna cuenta que crear antes. La respuesta ya lleva los enlaces para el wallet, y la inscripción queda marcada como llegada desde un asistente.

get_wallet_pass

Los enlaces para añadir una entrada a Apple o Google Wallet.

Para quien ya se ha inscrito y no quiere rebuscar el correo.

follow_community

El enlace para recibir los eventos de una comunidad en tu propio calendario.

Una suscripción iCalendar: los eventos nuevos llegan solos, para siempre, sin instalar nada.

Reclamar

Mixto

¿Tu evento ya está señalado aquí? Buscarlo es libre; reclamarlo necesita una cuenta.

find_my_listingSin cuenta

Busca tu noche entre los avisos, con el interés que ya ha reunido.

Reacciones y seguidores que la gente de Aion ya ha dejado en ese evento — un público que hoy no estás viendo.

claim_listingSe necesita cuenta

Convierte un aviso en tu propio evento de Aion, ya completado.

El nombre, lugar, fecha, descripción y portada vienen del aviso. Nace como borrador: precio y aforo quedan por definir. Requiere una cuenta.

Organizar

Se necesita cuenta

De aquí en adelante necesitas una cuenta conectada.

list_my_communities

Las comunidades que gestionas, con su id.

Es el primer paso: un evento sin calendario no aparece en la página de ninguna comunidad. Cada fila dice si la creaste tú o si la gestionas para otra persona.

create_public_event

Crea un evento — título, cuándo, dónde, precio, aforo.

Nace como borrador: no lo ve nadie hasta que lo publicas.

update_public_event

Corrige un evento, antes o después de publicarlo.

Toca solo los campos que pasas: el resto se queda como está.

design_event_cover

Compone la portada en el color del topic del evento. Gratis.

Ningún modelo detrás: sin créditos, respuesta instantánea, y el mismo evento siempre da la misma imagen.

generate_event_cover

Genera la portada a partir de una descripción y la aplica.

Necesita una escena real — un local, un escenario, un plato. Describe la imagen, no el evento. Consume créditos.

publish_public_event

Publica el borrador.

Desde aquí la dirección es accesible y el evento aparece en Discover.

set_event_coupons

Los códigos de descuento del evento.

Relee la configuración antes de escribir, para no borrar las preguntas de inscripción y las plantillas.

get_event_template

Una estructura ya lista para rellenar: RSVP rápido, reserva por persona, bloques de página.

Las preguntas tienen claves que interactúan — precios, condiciones, páginas — y equivocarse en una produce un formulario que parece correcto y se comporta mal.

set_registration_questions

Las preguntas que rellena quien se inscribe: tipos, precios, condiciones, páginas.

En un evento por persona el precio vive aquí, no en la entrada: el total cuenta la base una sola vez.

set_page_sections

Programa día por día, galería, vídeo, FAQ, enlaces.

Es lo que separa una página de evento de un formulario.

set_community_sections

Los mismos bloques, pero colgados de la comunidad.

Las FAQ describen la comunidad y serían idénticas en cada una de sus ediciones: aquí no hay que duplicarlas.

schedule_event_series

Una noche recurrente: todas las fechas de una vez.

"Todos los jueves hasta diciembre." La regla se expande enseguida en eventos reales, cada uno con su propia página.

list_my_public_events

Lo que tienes por delante, o lo que ya ha pasado.

Planificar y llevar adelante la noche

Se necesita cuenta

Cuándo hacerla, si está lista, y cómo hacer que la gente entre por la puerta.

suggest_event_slot

Qué noche elegir, mirando qué hay ya en la ciudad esa noche.

El recuento viene de los avisos públicos de otras plataformas: es la competencia real de esa noche, no lo lleno que está nuestro propio calendario.

event_health_check

Qué le falta a un evento antes de publicarlo.

Distingue lo que hará rebotar el intento de publicación de lo que solo hará que el lector pase de largo.

create_tracked_invite

Un enlace de invitación distinto para cada canal.

El código viaja en el parámetro ref y queda en la inscripción. Los resultados se ven en Administración › Crecimiento, en "Inscripciones a eventos".

check_in_guest

Marca a una persona como entrada, sin abrir el escáner.

Acepta el QR o el código corto que un invitado lee en voz alta. Volver a escanear a la misma persona no la cuenta dos veces.

Medir

Se necesita cuenta

Cómo va.

event_registrations

Cuántas inscripciones, en qué estado, con las respuestas al cuestionario.

platform_analytics

Usuarios, organizadores, eventos, inscripciones — comparados con el periodo anterior.

Reservado para la cuenta de administración.

Aprender

Sin cuenta

Cómo funciona algo: una respuesta breve y, cuando existe, el vídeo que lo muestra. Elegidas a mano, nunca buscadas.

find_help

Explica un momento concreto — primer evento, entradas, perfil de talent — y adjunta la videoguía cuando existe.

Si no tenemos nada para ese momento, lo dice en vez de ofrecer lo más parecido.

find_guides

Solo las videoguías de Aion para un momento concreto.

Para cuando solo quieres el vídeo.

Del material grabado a los reels

Se necesita cuenta

Las grabaciones de una noche se convierten en clips verticales para aprobar y publicar. El trabajo pesado — quitar el HDR, montar, renderizar — se ejecuta en tu propio ordenador: estas herramientas son el modo en que recoge el trabajo y te devuelve el resultado.

list_content_projects

Los proyectos de vídeo de un evento, y en qué punto está cada uno.

content_project_status

Grabaciones, pasos hechos o fallidos, clips esperando un sí.

claim_content_job

Toma el siguiente trabajo pensado para ejecutarse en este ordenador.

Dos ordenadores no pueden tomar el mismo trabajo, y uno que se apaga a mitad de camino lo devuelve solo.

content_job_heartbeat

Dice que el trabajo sigue en curso.

content_upload_url

Dónde subir lo que sale: proxy, audio, reel, portada.

complete_content_job

Entrega el resultado y hace avanzar el proyecto.

fail_content_job

Devuelve un trabajo que ha fallado, con el motivo.

review_content_clip

Aprueba un clip propuesto — y lo manda a renderizar — o lo descarta.

Al aprobar puedes corregir el título, la frase de apertura y la descripción. Si mueves los tiempos, el corte se reajusta a las palabras.

publish_content_clip

Programa un clip ya renderizado en los canales sociales.

Un clip que ya se envió a un canal nunca se vuelve a enviar allí.

Para quien integra

Transporte Streamable HTTP en https://api.aionvibes.com/mcp/. Sin cabecera Authorization la conexión funciona y las herramientas abiertas responden: las reservadas devuelven un error que explica cómo conectarse, en lugar de un error de transporte.

Un Authorization presente pero no válido recibe un 401 con la cabecera WWW-Authenticate que indica los metadata del recurso: así es como un cliente descubre el authorization server por sí solo.

GET  /.well-known/oauth-protected-resource
GET  /.well-known/oauth-authorization-server
POST /oauth/register    registro dinámico (RFC 7591)
GET  /oauth/authorize   PKCE S256 obligatorio
POST /oauth/token       authorization_code | refresh_token

Los clientes son públicos: no hay client_secret que proteger. Lo que mantiene en pie el flujo es PKCE.

¿Algo no cuadra? Escríbenos a akaion@akaion.com.