Referencia de API

dotoo API v1

Un contrato personal para que un cliente actúe en nombre de una cuenta de dotoo. Lee la cuenta y los retos de quien emite el token y escribe en su nombre: marca el día, crea retos y se apunta a ellos, escribe en el chat, gasta dotoos, lleva clubes y cambia ajustes.

Funciona, pero todavía no es una API pública estable

Este corte existe para uso personal antes de abrir una plataforma para terceros.

Por MCP, tu agente se conecta con OAuth desde tu cuenta; los tokens de la API se siguen emitiendo a mano.
La versión del contrato es 0.1.0 y puede cambiar antes de una apertura pública.
Lee y escribe. Se quedan en la app hablar con el companion, los avisos push nativos, la presencia en vivo en una fogata y el alta de la cuenta.

Operaciones

Recurso	Operación	Qué devuelve
Cuenta	GET `/api/v1/yo`	Tu nivel, XP, dotoos y días cumplidos, sin correo.
Retos	GET `/api/v1/cohortes`	Tus retos abiertos o en marcha, con su día y si hoy toca.
Retos	GET `/api/v1/cohortes/{id}`	La ficha completa de uno de tus retos, también si ya terminó; uno ajeno responde 404.
Retos	GET `/api/v1/cohortes/publicas`	Retos públicos por empezar, con plazas y en tu idioma.
Retos	GET `/api/v1/cohortes/plantillas`	Las plantillas disponibles para crear un reto.
Retos	GET `/api/v1/cohortes/historial`	Tus retos en curso, terminados o abandonados.
Retos	GET `/api/v1/cohortes/{id}/invitables`	Gente del reto anterior que puedes invitar a uno de tus retos.
Retos	GET `/api/v1/hoy`	Invitaciones pendientes y retos disueltos que aún no has visto.
Retos	GET `/api/v1/invitaciones/{token}`	Un reto visto desde su enlace de invitación.
Retos	GET `/api/v1/temas`	El tema vigente de retos, o uno pasado por su clave.
Retos	POST `/api/v1/cohortes`	Crea un reto; nace en revisión salvo las familias de textos fijos.
Retos	PATCH `/api/v1/cohortes/{id}`	Cambia descripción, categoría, plazas o los campos del diario de un reto.
Retos	POST `/api/v1/cohortes/{id}/reintentar_revision`	Vuelve a pasar por moderación un reto que se quedó sin veredicto.
Retos	POST `/api/v1/cohortes/{id}/participacion`	Te une a un reto público por su id.
Retos	POST `/api/v1/invitaciones/{token}`	Te une a un reto por su enlace de invitación, también privado.
Retos	DELETE `/api/v1/cohortes/{id}/participacion`	Sales de un reto, o lo disuelves si lo creaste.
Retos	POST `/api/v1/cohortes/{id}/invitaciones`	Invita a gente del reto anterior, con el resultado de cada uno.
Retos	PUT `/api/v1/cohortes/{id}/voto_de_franja`	Tu voto de franja del día mientras el reto está en su lobby.
Retos	POST `/api/v1/cohortes/{id}/toques`	Un toque a quien aún no ha hecho hoy su check-in.
Check-ins y juegos	POST `/api/v1/subidas`	Una subida reservada para la foto de un check-in.
Check-ins y juegos	POST `/api/v1/cohortes/{id}/checkins`	El check-in de hoy de un reto: nuevo o el que ya había.
Check-ins y juegos	POST `/api/v1/cohortes/{id}/regla/intentos`	Tu envío a la pizarra de La regla oculta, con su veredicto.
Check-ins y juegos	POST `/api/v1/cohortes/{id}/regla/formulaciones`	Tu propuesta de regla, pendiente del juez.
Check-ins y juegos	GET `/api/v1/blurs_del_dia/{id}`	Un día de Blur: turno, opciones y tu respuesta.
Check-ins y juegos	POST `/api/v1/blurs_del_dia/{id}/respuesta`	Tu respuesta al Blur del día y si acertaste.
Check-ins y juegos	GET `/api/v1/fotos_de_blur/{id}`	La foto desenfocada de un día de Blur.
Check-ins y juegos	GET `/api/v1/fotos_de_blur/{id}/nitida`	La foto nítida de un día de Blur, si ya puedes verla.
Atrevimientos	GET `/api/v1/fotos_de_atrevimientos/{id}`	La foto de un atrevimiento cumplido del grupo.
Atrevimientos	POST `/api/v1/atrevimientos_del_dia/{id}/valoracion`	Tu valoración (si/no) de un atrevimiento que ya cumpliste.
Chat	GET `/api/v1/chat/mensajes`	El hilo de un reto o de una sala compartida.
Chat	POST `/api/v1/chat/novedades`	Lo nuevo de todos tus chats desde la última llamada de esta app.
Chat	POST `/api/v1/chat/mensajes`	Escribe un mensaje en el chat de un reto o de una sala.
Chat	DELETE `/api/v1/chat/mensajes/{id}`	Borra un mensaje propio.
Chat	PUT `/api/v1/chat/mensajes/{id}/reaccion`	Pone, cambia o quita tu reacción sobre un mensaje.
Chat	POST `/api/v1/chat/mensajes/{id}/denuncia`	Deja un mensaje marcado para que se revise.
Economía	GET `/api/v1/tesoreria`	Saldo de dotoos y los últimos movimientos del ledger.
Economía	GET `/api/v1/apuestas`	Apuestas de dotoos pendientes y resueltas, con el balance.
Economía	POST `/api/v1/cohortes/{id}/apuestas`	Apuesta dotoos a cumplir la semana de un reto en marcha.
Economía	GET `/api/v1/armario`	Catálogo de prendas y pelajes, con lo comprado y lo puesto.
Economía	POST `/api/v1/armario/compras`	Compra una prenda del armario con dotoos.
Economía	PATCH `/api/v1/armario/compras/{id}`	Pone o quita una prenda ya comprada.
Economía	PATCH `/api/v1/armario/pelaje`	Pone un pelaje, comprándolo primero si es de pago.
Clubes	GET `/api/v1/clubs`	Tus clubes, con su estado de revisión y tu límite.
Clubes	GET `/api/v1/clubs/publicos`	Clubes abiertos cuyo nombre contiene un texto.
Clubes	POST `/api/v1/clubs`	Crea un club del que eres owner; queda en revisión.
Clubes	GET `/api/v1/clubs/{id}`	Un club tuyo: socios, revisión y, si eres owner, la bandeja.
Clubes	POST `/api/v1/clubs/{id}/reintentar_revision`	Vuelve a pedir la revisión de un club que quedó sin veredicto.
Clubes	GET `/api/v1/clubs/invitaciones/{token}`	La ficha pública que abre el enlace de un club.
Clubes	POST `/api/v1/clubs/{id}/solicitudes`	Pide entrar en un club abierto desde el buscador.
Clubes	POST `/api/v1/clubs/invitaciones/{token}`	Pide entrar en un club por su enlace.
Clubes	POST `/api/v1/clubs/{id}/solicitudes/{solicitud_id}/aceptar`	Admite en tu club a quien pidió entrar.
Clubes	DELETE `/api/v1/clubs/{id}/solicitudes/{solicitud_id}`	Rechaza a quien pidió entrar en tu club.
Clubes	GET `/api/v1/clubs/{id}/personas`	Un owner busca por username exacto a quién invitar.
Clubes	POST `/api/v1/clubs/{id}/invitaciones`	Un owner invita a una persona; si acepta, entra sin aprobación.
Clubes	GET `/api/v1/clubs/invitaciones_recibidas`	Las invitaciones a un club que tienes pendientes.
Clubes	POST `/api/v1/clubs/{id}/invitaciones/{invitacion_id}/aceptar`	Acepta una invitación y entra en el club.
Clubes	DELETE `/api/v1/clubs/{id}/invitaciones/{invitacion_id}`	Rechaza una invitación sin avisar a quien invitó.
Companion	GET `/api/v1/cohortes/{id}/acompanamiento`	La configuración del companion en un reto tuyo.
Companion	GET `/api/v1/cohortes/{id}/acompanamiento/mensajes`	La conversación de hoy y el estado del último consejo.
Companion	GET `/api/v1/cohortes/{id}/acompanamiento/recuerdos`	Lo que el companion recuerda de ti en ese reto.
Perfiles	GET `/api/v1/usuarios/{username}`	El perfil de una persona: el tuyo, completo.
Ajustes	GET `/api/v1/ajustes`	Idioma, recordatorio diario, avisos y franja de no molestar.
Ajustes	PATCH `/api/v1/ajustes`	Cambia idioma, recordatorio diario, avisos o franja de no molestar.
Ajustes	PATCH `/api/v1/cohortes/{id}/recordatorio`	Enciende o apaga el recordatorio de uno de tus retos.
Ajustes	GET `/api/v1/ajustes/apps-conectadas`	Las apps conectadas a tu cuenta.
Ajustes	DELETE `/api/v1/ajustes/apps-conectadas/{id}`	Desconecta una app conectada.
Dejar de fumar	POST `/api/v1/cohortes/{id}/consumos`	Suma una unidad fumada hoy.
Dejar de fumar	DELETE `/api/v1/cohortes/{id}/consumos/ultimo`	Resta el último consumo de hoy.
Dejar de fumar	PATCH `/api/v1/cohortes/{id}/dejar_de_fumar/confianza`	Guarda la confianza para mañana en el plan poco a poco.
Dejar de fumar	POST `/api/v1/cohortes/{id}/antojos`	Apunta un antojo y si lo superaste.
Dejar de fumar	PATCH `/api/v1/cohortes/{id}/dejar_de_fumar/contador`	Elige el contador que destaca tu ficha.
Greetings	GET `/api/v1/saludos`	El feed de Greetings Room, con tus apoyos y denuncias.
Greetings	POST `/api/v1/saludos`	Publica un greeting; queda en revisión.
Greetings	GET `/api/v1/saludos/{id}`	Un greeting tuyo y su revisión, también si la moderación lo borró.
Greetings	POST `/api/v1/saludos/{id}/reintentar_revision`	Vuelve a pedir la revisión de un greeting que quedó sin veredicto.
Greetings	DELETE `/api/v1/saludos/{id}`	Borra un greeting tuyo.
Greetings	PUT `/api/v1/saludos/{id}/apoyo`	Apoya un greeting del feed.
Greetings	DELETE `/api/v1/saludos/{id}/apoyo`	Quita tu apoyo a un greeting.
Greetings	POST `/api/v1/saludos/{id}/denuncia`	Marca un greeting del feed para que se revise.
Fogatas	GET `/api/v1/fogatas`	Tus fogatas vivas.
Fogatas	POST `/api/v1/fogatas`	Crea una fogata de 25 o 50 minutos.
Fogatas	GET `/api/v1/fogatas/{id}`	La sala: reloj, tu intención y tu resultado.
Fogatas	POST `/api/v1/fogatas/{id}/empezar`	Arranca una fogata que creaste.
Fogatas	PATCH `/api/v1/fogatas/{id}/resultado`	Cuenta cómo te fue al terminar.
Fogatas	DELETE `/api/v1/fogatas/{id}`	Borra una fogata que creaste.
Journal	GET `/api/v1/journal`	Lista tu diario, con sus cifras.
Journal	GET `/api/v1/journal/hoy`	Abre la entrada de hoy desde un reto Journal.
Journal	PUT `/api/v1/journal/hoy`	Guarda la entrada de hoy y marca el día.
Journal	GET `/api/v1/journal/{fecha}`	Lee una entrada por su fecha.
Journal	GET `/api/v1/journal/ajustes`	Mira si se rescata un agradecimiento.
Journal	PATCH `/api/v1/journal/ajustes`	Activa o apaga ese recordatorio.

Antes de llamar

Autenticación y reglas comunes

Cada petición representa al sujeto del token. Un identificador recibido por la ruta solo selecciona recursos a los que esa cuenta ya tiene acceso.

Dirección base

https://app.do-too.com/api/v1

Todas las operaciones documentadas pertenecen a la versión v1.

Bearer personal

Authorization: Bearer <token>

El token es revocable, caduca y solo autoriza los scopes con los que se emitió.

Respuestas

application/json · application/problem+json

El éxito usa un sobre data. Los errores usan el formato problem+json con un code estable: parametros_invalidos (400), scope_insuficiente (403), recurso_no_encontrado (404), validacion (422) y limite_de_peticiones (429). Un 400 parametros_invalidos o un 422 validacion lista en errors cada campo que falla, como «plazas: debe ser al menos 5». Una ruta que no existe bajo /api contesta el mismo 404 recurso_no_encontrado. Todas las respuestas llevan X-Request-Id y no se cachean.

Límites y cursores

120 req/min · 30 escrituras/min · 20 moderadas/hora

Hay un límite de 120 peticiones por minuto y token. Las escrituras gastan además 30 por minuto y persona, compartidas entre la API y el MCP; las que acaban en un modelo de lenguaje (moderación, visión) gastan también 20 por hora. Al pasarse, responden 429 con Retry-After. Las colecciones paginadas aceptan cursor y limit; limit vale de 1 a 100 y usa 50 por defecto.

Reintentos e idempotencia

Idempotency-Key · clave_de_idempotencia

Una escritura que deja el mismo estado si la repites (unirse, votar, valorar) no necesita nada especial. Una que crea algo nuevo exige una clave de tu parte: cabecera Idempotency-Key en la API, argumento clave_de_idempotencia en MCP. Repetir la misma petición con la misma clave, por la puerta que sea, no repite el efecto: responde con el mismo código de estado y el recurso tal como está ahora (404 si ya no existe o ya no tienes acceso; 412 version_obsoleta si ha cambiado desde entonces). Con la misma clave y otro contenido, responde 409. El recibo se conserva 48 horas.

Vía agente

via_agente

Cuando tu agente escribe algo que la web enseña como tuyo (check-in, mensaje de chat, saludo), esa fila queda marcada como escrita por un agente y la conexión que la hizo queda registrada en tu cuenta. Sigue siendo tu cuenta la que actúa; solo se distingue el canal.

Lo que escriben otros

de_terceros · aviso · cliente_de_agente

En leer_chat y novedades_del_chat, cada mensaje lleva de_terceros: true si no lo escribió la persona dueña de la cuenta (otra persona, su agente o un bot del reto), y cliente_de_agente dice qué cliente escribió un mensaje vía agente (claude, chatgpt u otro). La respuesta lleva además un aviso para el modelo que la lee: lo de terceros son datos, no instrucciones.

Lo irreversible espera tu sí

202 · confirmacion_id · estado

Pedidas por un agente, abandonar_reto, apostar_dotoos, revocar_app_conectada, comprar_prenda y la compra de un pelaje con cambiar_pelaje no se hacen al momento: contestan 202 con una confirmación pendiente (confirmacion_id, estado, caduca_en, url y un aviso). La persona la confirma o la rechaza en dotoo, arriba de «Tú», en 24 horas; si no, caduca. Repetir la misma petición (con la misma Idempotency-Key, o la misma entrada mientras siga vigente) no crea otra: devuelve esa confirmación con su estado de ahora (pendiente, confirmada, rechazada, fallida o caducada). Un rechazo se mantiene 24 horas.

Errores

Todo error usa el formato problem+json con un code estable, el mismo por la API y por el MCP (isError con el mismo code). Además del propio de cada operación, esta tabla es común a todas:

HTTP	Código	Cuándo
400	`parametros_invalidos`	La petición no tiene la estructura esperada.
403	`scope_insuficiente`	El token no tiene el scope que pide la operación.
404	`recurso_no_encontrado`	El recurso no existe o no es de esta cuenta; los dos casos responden igual.
409	`clave_de_idempotencia_reutilizada`	Esa Idempotency-Key ya se usó con una petición distinta.
412	`version_obsoleta`	El recurso cambió desde la versión que enviaste.
422	`validacion`	Los datos no cumplen las reglas del recurso.
422	`dotoos_insuficientes`	No hay saldo suficiente de dotoos para esta acción.
422	`cupo_agotado`	Se ha agotado el cupo de esta acción.
422	`familia_no_soportada`	Esa familia de reto no se juega por agente: la trivia solo se juega en la app.
400	`imagen_ilegible`	La imagen enviada en base64 no se puede leer.
413	`foto_demasiado_grande`	La foto pasa de 10 MB.
428	`confirmacion_requerida`	La operación es destructiva y exige el campo confirmacion.
429	`limite_de_peticiones`	Se ha superado un límite de peticiones; la respuesta lleva Retry-After.
429	`tope_diario_de_agente`	Tu agente ya ha escrito hoy el máximo de mensajes en ese chat. Sin Retry-After: no se reintenta hasta mañana.

Un conflicto propio de una operación (por ejemplo, ya cumplido o reto completo) también responde 409, con un code distinto que explica la sección de esa operación.

Scopes disponibles

Cada operación pide el permiso mínimo indicado en su sección. Un token sin él recibe 403. Los scopes van por dominio: leer uno no permite escribir en él, y dotoos:gastar va aparte. Al conectar por OAuth das de golpe los que pida tu agente; si no pide ninguno, todos menos dotoos:gastar; una conexión anterior conserva solo los de lectura hasta que vuelvas a conectarla.

perfil:leer cohortes:leer chat:leer social:leer journal:leer companion:leer spa:leer perfil:escribir cohortes:escribir checkins:escribir chat:escribir social:escribir dotoos:gastar journal:escribir spa:escribir

Cuenta

Quién representa el token

Una lectura mínima del estado personal, sin correo ni credenciales.

GET /api/v1/yo

Scope perfil:leer

Obtener mi estado

Resume la cuenta personal representada por el Bearer.

Devuelve 200 con el objeto bajo data.
Incluye id, username, nivel, xp, dotoos y dias_cumplidos.
No expone el correo, sesiones, tokens ni credenciales.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/yo' \
  -H 'Authorization: Bearer <token>'

Retos

Retos vivos y oferta pública

Los retos abiertos o en marcha de la cuenta y la oferta pública: leerlos, crearlos, ajustarlos, unirse, invitar, votar la franja, dar toques y abandonarlos.

GET /api/v1/cohortes

Scope cohortes:leer

Listar mis retos

Devuelve los retos vivos a los que pertenece la cuenta.

Incluye estados abierta y en_marcha; los retos cerrados quedan fuera.
No pagina: data contiene el conjunto vivo completo.
Cada reto incluye fechas, estado, plazas, personas, día actual y ventana de check-in.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/cohortes/publicas

Scope cohortes:leer

Listar retos públicos

Descubre oferta pública futura a la que la cuenta todavía puede unirse.

Solo devuelve retos aprobados, públicos, con plazas y del idioma de la cuenta.
Excluye los retos a los que la cuenta ya pertenece.
Acepta cursor y limit; devuelve limit y next_cursor bajo meta.
Acepta filtro (pronto/todos), categoria, sistema (solo/sin bots) y busqueda por nombre.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes/publicas?limit=20' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/cohortes/{id}

Scope cohortes:leer

Obtener uno de mis retos

Lee la ficha completa de un reto dentro de las pertenencias de la cuenta, en marcha o ya cerrado.

El parámetro id es obligatorio en la ruta.
Un recurso inexistente o ajeno devuelve el mismo 404.
Incluye moderación, sala_id, qué se puede editar, miembros, tu check-in de hoy y el juego del día.
No prepara nada: si el juego del día todavía no existe, disponible sale en false.
En Dejar de fumar, dejar_de_fumar trae el contador de hoy, la clave de su último consumo, el cupo, la confianza, el contador fijado y los antojos superados; en otra familia sale null.
recordatorio_activo es el interruptor del recordatorio de ese reto; en un reto cerrado, cierre trae las cifras de su pantalla final y juego_del_dia sale null.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes/42' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/cohortes/plantillas

Scope cohortes:leer

Listar plantillas de reto

Devuelve las plantillas con las que se puede crear un reto nuevo.

Acepta categoria para filtrar; sin ella, devuelve todas.
Cada plantilla incluye su clave, categoría, nombre, descripción y duración en días.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes/plantillas' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/cohortes/historial

Scope cohortes:leer

Historial de retos

Devuelve las filas del historial de retos de la cuenta.

Acepta estado: en_curso, terminados o abandonados; por defecto en_curso.
Una fila abandonada distingue si el reto se disolvió por falta de miembros.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes/historial?estado=en_curso' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/cohortes/{id}/invitables

Scope cohortes:leer

Invitables a un reto

Lista la gente del reto anterior que se puede invitar a uno de los retos de la cuenta.

El parámetro id es obligatorio en la ruta; un reto ajeno responde 404.
Cada persona marca si ya está dentro del reto o si ya fue invitada.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes/42/invitables' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/hoy

Scope cohortes:leer

Resumen de hoy

Invitaciones pendientes y retos disueltos sin avisar de la cuenta.

No marca las disoluciones como avisadas: esa escritura la hace la web al abrir /tu.
Sin parámetros; siempre el estado actual de la cuenta.
Cada invitación trae su token_invitacion: con él unirse_a_reto entra también en un reto privado, como el botón de la web.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/hoy' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/invitaciones/{token}

Scope cohortes:leer

Ver una invitación

Consulta un reto desde su enlace de invitación.

El parámetro token es obligatorio en la ruta; un token inválido responde 404.
estado dice si la cuenta ya es miembro, si el reto está lleno o si puede unirse.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/invitaciones/abc123' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/temas

Scope cohortes:leer

Retos temáticos

Consulta el tema vigente de retos, o uno pasado por su clave.

Sin clave devuelve el tema vigente; con una clave pasada, ese tema.
Nunca responde 404: sin tema vigente, tema sale en null.
pasados lista los temas anteriores, sin el que ya viene en tema.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/temas' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/cohortes

Scope cohortes:escribir

Crear un reto

Crea un reto con la cuenta como creadora: la misma alta que el formulario de la web.

Exige la cabecera Idempotency-Key; repetirla con el mismo cuerpo devuelve el mismo reto.
modo elige una familia con alta propia (journal, atrevimiento, blur, dejar_de_fumar, regla_oculta) que fija sus textos; sin modo es el formulario general.
Nace en revisión salvo las familias de textos fijos: el desenlace se lee en GET /api/v1/cohortes/{id} (moderacion), y un rechazo borra el reto (404).
El tope de retos y el de familia responden 409 con code tope_de_retos o tope_de_familia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"nombre":"Leer 20 minutos","categoria":"aprendizaje","duracion_dias":14,"tipo_de_check":"simple"}'

PATCH /api/v1/cohortes/{id}

Scope cohortes:escribir

Editar un reto

Cambia los ajustes de un reto: los mismos que la rueda de ajustes de la web.

Antes de arrancar, su creador cambia descripcion, categoria, plazas y, en un Journal, los campos del diario.
Con el Journal en marcha solo se editan los campos del diario; lo demás responde 409 fuera_de_alcance.
Quitar un campo del diario (borrar: true) exige confirmacion: true; sin ella responde 428.
Duración, tipo y arranque no se editan.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/cohortes/42' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"plazas":10}'

POST /api/v1/cohortes/{id}/reintentar_revision

Scope cohortes:escribir

Reintentar la revisión

Vuelve a pedir el veredicto de moderación de un reto sin_veredicto.

Devuelve el id y la moderación, que queda pendiente; el resultado se lee después en la ficha.
Con el reto ya pendiente responde lo mismo sin pagar otro juicio; uno aprobado responde 409.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/reintentar_revision' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/cohortes/{id}/participacion

Scope cohortes:escribir

Unirse a un reto público

Apunta a la cuenta a un reto público y aprobado por su id, sin enlace.

Un reto privado, en revisión o ajeno a la oferta responde 404: se entra por su enlace.
Si la cuenta ya estaba dentro devuelve la misma ficha.
Reto empezado, completo o topes alcanzados responden 409 con su code.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/participacion' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/invitaciones/{token}

Scope cohortes:escribir

Unirse por invitación

Apunta a la cuenta a un reto desde su enlace de invitación, como la web.

Vale también para un reto privado; un token inválido responde 404.
Si la cuenta ya estaba dentro devuelve la misma ficha.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/invitaciones/abc123' \
  -H 'Authorization: Bearer <token>'

DELETE /api/v1/cohortes/{id}/participacion

Scope cohortes:escribir

Abandonar un reto

Saca a la cuenta de un reto; si lo creó, lo disuelve para todos.

Exige confirmacion=true y la cabecera Idempotency-Key; sin confirmación responde 428 y dice si lo disolvería.
Se pierden las apuestas pendientes en ese reto.
No sale al momento: contesta 202 con una confirmación pendiente (confirmacion_id, estado, caduca_en). La persona la confirma o la rechaza en dotoo, arriba de «Tú»; hasta entonces no se hace nada. Repetir la petición devuelve esa confirmación con su estado de ahora.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/cohortes/42/participacion?confirmacion=true' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/cohortes/{id}/invitaciones

Scope cohortes:escribir

Invitar a un reto

Invita a varias personas a la vez y devuelve el resultado de cada una.

user_ids admite de 1 a 50 ids; salen de GET /api/v1/cohortes/{id}/invitables.
Cada resultado es invitado, ya_es_miembro, no_invitable o no_admite.
Repetir la llamada deja el mismo estado.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/invitaciones' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"user_ids":["7","12"]}'

PUT /api/v1/cohortes/{id}/voto_de_franja

Scope cohortes:escribir

Votar la franja

Vota mañana, mediodía o tarde_noche como franja del día del reto.

Solo mientras el reto está en su lobby; después responde 409 voto_cerrado.
Votar otra vez cambia el voto. Devuelve tu opción y el recuento.

Petición de ejemplo

curl -s -X PUT \
  'https://app.do-too.com/api/v1/cohortes/42/voto_de_franja' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"opcion":"manana"}'

POST /api/v1/cohortes/{id}/toques

Scope cohortes:escribir

Dar un toque

Avisa a alguien del reto que hoy aún no ha hecho su check-in.

Uno por persona, reto y día del reto: repetir responde lo mismo sin volver a avisar.
Si hoy no procede (reto fuera de marcha o check-in ya hecho) responde 409 no_procede.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/toques' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"user_id":"7"}'

Check-ins y juegos

Marcar el día y jugar

Lo mismo que el botón del día y los juegos de la ficha del reto. Lo que marca tu agente se ve en el reto con la etiqueta «vía agente».

POST /api/v1/subidas

Scope checkins:escribir

Preparar la subida de una foto

Reserva la subida de una foto para marcar el día en un reto de foto, atrevimiento o Blur.

El cuerpo lleva nombre_de_archivo, bytes, checksum (el MD5 de los bytes en base64) y tipo_mime. Exige Idempotency-Key.
Devuelve 201 con signed_id, y la url y cabeceras del PUT con el que mandas los bytes. Después, hacer_checkin con imagen_signed_id.
La subida es solo tuya y sirve una vez; caduca a las seis horas. Más de 10 MB responde 413 foto_demasiado_grande.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/subidas' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"nombre_de_archivo":"foto.jpg","bytes":183422,"checksum":"1B2M2Y8AsgTpgAmY7PhCfg==","tipo_mime":"image/jpeg"}'

POST /api/v1/cohortes/{id}/checkins

Scope checkins:escribir

Marcar el día

Marca el día de hoy de un reto tuyo, con lo que pida su familia, como el botón del día en la web.

Cuerpo según la familia: nada (simple), items_marcados (checklist), cantidad (número, colectivo, dejar de fumar), texto o segundos (timer). La trivia solo se juega en la app: responde 422 familia_no_soportada. zona es opcional, tu zona horaria (como Europe/Madrid) para Journal; por defecto, la de la cuenta.
Devuelve 200 con id, dia, cumplido y via_agente. Repetirla el mismo día devuelve el mismo check-in, y la recompensa se paga una sola vez.
Quedarte por debajo del objetivo también gasta el día (cumplido false). Un dato que no vale responde 422 y no gasta el día.
Foto, atrevimiento y Blur llevan la foto: imagen_signed_id (de preparar_subida, con los bytes ya subidos) o imagen_base64 con tipo_mime, hasta 10 MB; Blur, además, opcion_de_blur. Responde 202 con verificacion pendiente, como la web mientras revisa la foto.
Una subida ajena da 404; una ya usada, 409 subida_ya_usada; una foto de más de 10 MB, 413 foto_demasiado_grande. La regla oculta responde 409 sin_gesto_del_dia: se marca acertando la regla.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/checkins' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"cantidad":30}'

POST /api/v1/cohortes/{id}/regla/intentos

Scope checkins:escribir

Probar una palabra

Prueba una palabra contra la regla oculta de hoy. Queda en la pizarra del grupo, como en la ficha.

El cuerpo lleva texto (hasta 80 caracteres). Devuelve el envío con su veredicto y los intentos que te quedan hoy.
El mismo texto el mismo día devuelve el mismo envío sin gastar intento. Si el juez es un modelo de lenguaje responde 202 con veredicto pendiente.
Sin regla abierta hoy responde 409 regla_no_disponible, salvo si repites un texto que ya enviaste: devuelve ese envío. Con los intentos gastados, 422 cupo_agotado.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/regla/intentos' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"texto":"perro"}'

POST /api/v1/cohortes/{id}/regla/formulaciones

Scope checkins:escribir

Formular la regla

Propone cuál es la regla oculta de hoy. Si aciertas, cierras el día del grupo y cumples.

El cuerpo lleva texto. La juzga un modelo de lenguaje: responde 202 con veredicto pendiente, y el veredicto se ve después en la ficha y en ver_reto (juego_del_dia.mis_intentos).
Tres al día. Repetir el mismo texto no gasta ninguna; con las tres gastadas responde 422 cupo_agotado.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/regla/formulaciones' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"texto":"palabras de cinco letras"}'

GET /api/v1/blurs_del_dia/{id}

Scope cohortes:leer

Ver un día de Blur

Un día de Blur de un reto tuyo: de quién es el turno, las cuatro opciones y tu respuesta.

La opción de la foto (elegida) solo sale si es tu turno o ya respondiste. La foto no va en esta respuesta: se pide con ver_foto_de_blur.
Solo lee: no marca nada ni responde por ti.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/blurs_del_dia/42' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/blurs_del_dia/{id}/respuesta

Scope checkins:escribir

Responder al Blur

Elige qué hay en la foto desenfocada del día, como la mesa de cuatro opciones de la web.

El cuerpo lleva opcion, de 0 a 3. Acertar marca el día y paga; fallar lo cierra sin pagar.
Una respuesta por día: repetirla devuelve la que ya diste. En tu turno responde 409 es_tu_turno.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/blurs_del_dia/42/respuesta' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"opcion":2}'

GET /api/v1/fotos_de_blur/{id}

Scope cohortes:leer

Ver la foto desenfocada

La foto desenfocada de un día de Blur de un reto tuyo, la que hay que adivinar.

Devuelve la imagen en contenido_base64 con su tipo_mime, no un enlace: quién puede verla se comprueba en cada lectura.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/fotos_de_blur/42' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/fotos_de_blur/{id}/nitida

Scope cohortes:leer

Ver la foto nítida

La foto original de un día de Blur.

Solo para quien la subió o ya respondió ese día, como en la web; para el resto, 404.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/fotos_de_blur/42/nitida' \
  -H 'Authorization: Bearer <token>'

Atrevimientos

Lo que haces en tus retos de atrevimiento

Escrituras en nombre de la cuenta. Repetir la misma petición deja el mismo estado.

POST /api/v1/atrevimientos_del_dia/{id}/valoracion

Scope checkins:escribir

Valorar un atrevimiento

Guarda si te gustó (si o no) el atrevimiento del día que ya cumpliste, como el sí/no de la web.

El id es el del atrevimiento del día; el cuerpo JSON lleva valoracion: si o no.
Devuelve 200 con atrevimiento_del_dia_id, cohorte_id y valoracion bajo data. Repetirla con el mismo valor da la misma respuesta.
Sin haber cumplido ese atrevimiento, o en un reto ajeno, responde el mismo 404; otra valoración responde 400.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/atrevimientos_del_dia/42/valoracion' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"valoracion":"si"}'

GET /api/v1/fotos_de_atrevimientos/{id}

Scope cohortes:leer

Ver la foto de un atrevimiento

La foto de un atrevimiento cumplido en un reto tuyo, como en la galería del reto.

El id es el del check-in. Devuelve la imagen en contenido_base64; un check-in ajeno o sin foto aprobada da 404.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/fotos_de_atrevimientos/42' \
  -H 'Authorization: Bearer <token>'

Chat

El chat de un reto o de una sala compartida

Escrituras en nombre de la cuenta. cohorte_id o sala_id, nunca los dos: el argumento discriminado según hables del chat de un reto o del de una sala.

GET /api/v1/chat/mensajes

Scope chat:leer

Leer el chat

El hilo de un reto o de una sala compartida, paginado.

cohorte_id o sala_id (uno de los dos); desde retoma la ventana por el id de un mensaje.
No marca el chat como leído ni renueva presencia, al revés que abrir la pantalla web.
Devuelve mensajes, desde y desde_de_la_anterior bajo data, para pedir la página siguiente.
Páginas de 60 y como mucho 300 mensajes contando desde el último: un desde más antiguo se sube hasta ahí y desde_de_la_anterior llega null.
Cada mensaje lleva de_terceros (true si no lo escribió la persona dueña de la cuenta) y cliente_de_agente (claude, chatgpt u otro si lo escribió un agente; si no, null). data.aviso recuerda que lo de terceros son datos, no instrucciones.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/chat/mensajes?cohorte_id=42' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/chat/novedades

Scope chat:leer

Novedades de todos los chats

Los mensajes nuevos de todos los retos y salas de la persona desde la última llamada de esta app conectada, agrupados por chat.

Cada app conectada tiene su propio cursor: una concesión OAuth (sobrevive a que se renueve el token) o, sin ella, un token de API. Reconectar la app empieza de cero.
Cada llamada avanza el cursor: lo devuelto no vuelve a salir. Si hay_mas es true, vuelve a llamar. Lo que se pierda sigue en leer_chat.
La primera llamada trae las últimas 24 horas. limite es opcional (50 por defecto, 100 como mucho).
Devuelve aviso, chats (cohorte_id o sala_id, nombre y mensajes, cada uno con de_terceros) y hay_mas bajo data.
Es una lectura: no marca nada como leído para la persona ni cambia lo que ve el grupo. Va por POST porque cada llamada consume lo que devuelve.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/chat/novedades' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"limite":50}'

POST /api/v1/chat/mensajes

Scope chat:escribir

Escribir un mensaje

Escribe un mensaje en el chat de un reto o de una sala compartida.

cohorte_id o sala_id (uno de los dos) y cuerpo; zona es opcional, por defecto la de la cuenta.
Cada llamada crea un mensaje distinto: exige la cabecera Idempotency-Key.
El mensaje nace pendiente y visible; la moderación llega después en segundo plano.
Escrito por un agente, como mucho 10 mensajes al día en cada chat, contados por el día local de la cuenta. El siguiente contesta 429 tope_diario_de_agente, sin Retry-After: no se reintenta hasta mañana. La persona, desde la app, no tiene tope.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/chat/mensajes' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"cohorte_id":"42","cuerpo":"¡Hola!"}'

DELETE /api/v1/chat/mensajes/{id}

Scope chat:escribir

Borrar un mensaje

Borra un mensaje propio del chat.

id del mensaje y cohorte_id o sala_id (uno de los dos).
Solo el autor del mensaje, y solo si el chat sigue servido.
Es un borrado real: exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/chat/mensajes/99?cohorte_id=42' \
  -H 'Authorization: Bearer <token>'

PUT /api/v1/chat/mensajes/{id}/reaccion

Scope chat:escribir

Reaccionar a un mensaje

Pone, cambia o quita la reacción de la cuenta sobre un mensaje.

id del mensaje, cohorte_id o sala_id (uno de los dos) y tipo.
tipo es el estado deseado: no alterna como el botón de la web. null retira la reacción.

Petición de ejemplo

curl -s -X PUT \
  'https://app.do-too.com/api/v1/chat/mensajes/99/reaccion?cohorte_id=42' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"tipo":"aplauso"}'

POST /api/v1/chat/mensajes/{id}/denuncia

Scope chat:escribir

Denunciar un mensaje

Deja un mensaje del chat marcado para que se revise.

id del mensaje y cohorte_id o sala_id (uno de los dos).
No retira el mensaje. Repetir la misma denuncia es éxito idempotente.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/chat/mensajes/99/denuncia?cohorte_id=42' \
  -H 'Authorization: Bearer <token>'

Economía

Tesorería, apuestas y armario

Lecturas del saldo de dotoos y del armario, y las escrituras que gastan dotoos: apostar, comprar una prenda, equiparla o cambiar el pelaje.

GET /api/v1/tesoreria

Scope perfil:leer

Ver la tesorería

Saldo de dotoos de la cuenta y sus últimos movimientos, del más reciente al más antiguo.

Lee del mismo ledger que Tesorería en la app: hasta 100 movimientos.
Cada movimiento lleva su tipo, fecha, cambio y saldo tras aplicarse.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/tesoreria' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/apuestas

Scope perfil:leer

Ver mis apuestas

Apuestas de dotoos pendientes y resueltas de la cuenta, con el balance ganado o perdido.

balance sale del ledger, no de recontar apuestas: cuadra con Tesorería.
Las resueltas van recortadas a las últimas 100; las pendientes, todas.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/apuestas' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/cohortes/{id}/apuestas

Scope dotoos:gastar

Apostar dotoos en un reto

Apuesta 3 dotoos a cumplir 6 de los 7 días de la semana natural en marcha; premio 6, sin cancelación.

Solo los lunes y una vez por semana por reto; repetirla, o fuera de lunes, es un conflicto (409).
El reto tiene que admitir apuesta (práctica diaria, semana entera dentro de su duración).
Exige la cabecera Idempotency-Key: cada llamada intenta crear una apuesta nueva.
Si hoy se puede apostar, no apuesta al momento: contesta 202 con una confirmación pendiente (confirmacion_id, estado, caduca_en). La persona la confirma o la rechaza en dotoo, arriba de «Tú»; hasta entonces no se hace nada. Repetir la petición devuelve esa confirmación con su estado de ahora.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/apuestas' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/armario

Scope perfil:leer

Ver el armario

Catálogo de prendas y pelajes, con lo que la cuenta ya tiene comprado y lo que lleva puesto.

Catálogo cerrado en código: el mismo para todas las cuentas, sin paginar.
Cada prenda y cada tono llevan su precio, su nivel y el estado de la cuenta.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/armario' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/armario/compras

Scope dotoos:gastar

Comprar una prenda

Compra una prenda del armario con dotoos; sin devolución.

confirmacion es el precio que el agente leyó al consultar ver_armario; si cambió, 409.
Ya comprada o nivel insuficiente también es un conflicto (409); sin dotoos, 422.
Exige la cabecera Idempotency-Key: cada llamada intenta crear una compra nueva.
Si hoy se puede comprar, no compra al momento: contesta 202 con una confirmación pendiente (confirmacion_id, estado, caduca_en). La persona la confirma o la rechaza en dotoo, arriba de «Tú»; al confirmar se cobra el precio leído. Repetir la petición devuelve esa confirmación con su estado de ahora.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/armario/compras' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"prenda":"gorro_de_lana","confirmacion":20}'

PATCH /api/v1/armario/compras/{id}

Scope perfil:escribir

Equipar o quitar una prenda

Pone (equipada: true) o quita (equipada: false) una prenda ya comprada por la cuenta.

El id es el de la fila de compras, siempre de la cuenta dueña del token.
Estado deseado: repetir el mismo valor no cambia nada más.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/armario/compras/42' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"equipada":true}'

PATCH /api/v1/armario/pelaje

Scope perfil:escribir

Cambiar el pelaje

Pone un pelaje ya desbloqueado por nivel, o lo compra con dotoos la primera vez si es de pago.

Un tono con patrón exige además el scope dotoos:gastar; sin él, scope_insuficiente.
Repetir el mismo tono ya comprado no vuelve a cobrar.
La primera compra de un tono con patrón no se hace al momento: contesta 202 con una confirmación pendiente que la persona confirma o rechaza en «Tú»; al confirmar se compra y se pone.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/armario/pelaje' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"tono":"a8edcb"}'

Clubes

Clubes: crear, buscar, pedir entrar, invitar y la bandeja del owner

Lecturas con social:leer y escrituras con social:escribir. Un club que no es tuyo, o que aún no está aprobado y no es tuyo, responde lo mismo que uno que no existe.

GET /api/v1/clubs

Scope social:leer

Mis clubes

Los clubes de la cuenta, también los que siguen en revisión.

Cada club lleva moderacion, cuántos socios tiene y si la cuenta es owner.
clubs_activos y limite dicen cuántos clubes más caben.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/clubs' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/clubs/publicos

Scope social:leer

Buscar clubes

Clubes aprobados cuyo nombre contiene el texto de busqueda.

busqueda es obligatoria; devuelve 20 clubes como mucho, sin socios.
Para pedir entrar, usa el id de un resultado.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/clubs/publicos?busqueda=correr' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/clubs

Scope social:escribir

Crear un club

Crea un club del que la cuenta es owner.

nombre y, opcional, descripcion; los dos son públicos.
Responde 202 con moderacion pendiente: la revisión llega después y se lee con la ficha del club.
Cada llamada crea un club: exige la cabecera Idempotency-Key. En el límite de clubes, 409 tope_de_clubs.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/clubs' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"nombre":"Corremos a las nueve"}'

GET /api/v1/clubs/{id}

Scope social:leer

Ver un club

La ficha de un club de la cuenta.

moderacion: pendiente, sin_veredicto (reintentable), aprobada o rechazada si la revisión borró un club del que eras owner.
Aprobado, trae los socios; al owner, además, token_invitacion y las solicitudes por resolver.
Un club sin aprobar solo lo ve su owner.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/clubs/42' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/clubs/{id}/reintentar_revision

Scope social:escribir

Reintentar la revisión

Vuelve a pedir la revisión de un club propio que quedó sin veredicto.

Solo su owner. Responde 202 y el club vuelve a pendiente.
Repetirlo mientras sigue en revisión no pide otra; un club aprobado da 409 no_reintentable.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/clubs/42/reintentar_revision' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/clubs/invitaciones/{token}

Scope social:leer

Ver la invitación a un club

Lo que se ve al abrir el enlace de un club.

Nombre, descripción y cuántos socios tiene; nunca quiénes.
es_socio y solicitud dicen si la cuenta ya está dentro o ya pidió entrar.
Un enlace inventado o de un club sin aprobar responde 404.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/clubs/invitaciones/AbCdEfGhJkLmNpQrStUvWxYz' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/clubs/{id}/solicitudes

Scope social:escribir

Pedir entrar en un club

Pide entrar en un club abierto por su id.

No mete a nadie: un owner del club decide.
Repetirlo devuelve la misma solicitud. Si la cuenta ya es socia, 409 ya_eres_socio.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/clubs/42/solicitudes' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/clubs/invitaciones/{token}

Scope social:escribir

Pedir entrar por el enlace

La misma petición, con el token del enlace del club en vez de su id.

Mismo cuerpo de respuesta que por id; repetirlo devuelve la misma solicitud.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/clubs/invitaciones/AbCdEfGhJkLmNpQrStUvWxYz' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/clubs/{id}/solicitudes/{solicitud_id}/aceptar

Scope social:escribir

Aceptar una solicitud

Un owner admite en su club a quien pidió entrar.

id del club y solicitud_id, de las solicitudes de su ficha.
Solo un owner; para cualquier otra cuenta, 404. Club completo, persona en su límite o ya socia: 409.
La solicitud se consume: exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/clubs/42/solicitudes/7/aceptar' \
  -H 'Authorization: Bearer <token>'

DELETE /api/v1/clubs/{id}/solicitudes/{solicitud_id}

Scope social:escribir

Rechazar una solicitud

Un owner rechaza a quien pidió entrar en su club.

Borra la solicitud; esa persona puede volver a pedirlo.
Solo un owner; para cualquier otra cuenta, 404. Exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/clubs/42/solicitudes/7' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/clubs/{id}/personas

Scope social:leer

Buscar a quién invitar

Un owner busca a una persona por su username exacto para invitarla.

Sin búsqueda parcial: cero o una personas, nunca una cuenta automatizada.
Cada persona lleva su vinculo con el club: socio, invitada, pidio_entrar o sin_vinculo.
Solo un owner de un club aprobado; para cualquier otra cuenta, 404.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/clubs/42/personas?username=marta' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/clubs/{id}/invitaciones

Scope social:escribir

Invitar a un club

Un owner invita a una persona por su username exacto.

Si acepta, entra sin aprobación; plazas y límite de clubs se miran al aceptar.
Repetirlo devuelve la misma invitación. Ya socia o ya pidió entrar: 409.
Solo un owner de un club aprobado; un username que no existe también es 404.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/clubs/42/invitaciones' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"username":"marta"}'

GET /api/v1/clubs/invitaciones_recibidas

Scope social:leer

Mis invitaciones a clubes

Las invitaciones que la cuenta tiene por aceptar o rechazar.

Cada una lleva el club con su recuento, quién invita y su id.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/clubs/invitaciones_recibidas' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/clubs/{id}/invitaciones/{invitacion_id}/aceptar

Scope social:escribir

Aceptar una invitación

Entra en el club sin esperar a que lo apruebe un owner.

id del club e invitacion_id, de mis_invitaciones_a_clubs.
Club completo, cuenta en su límite o ya socia: 409, y la invitación sigue ahí.
La invitación se consume: exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/clubs/42/invitaciones/9/aceptar' \
  -H 'Authorization: Bearer <token>'

DELETE /api/v1/clubs/{id}/invitaciones/{invitacion_id}

Scope social:escribir

Rechazar una invitación

Borra la invitación sin avisar a quien invitó.

Una invitación ajena o que ya no está, 404. Exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/clubs/42/invitaciones/9' \
  -H 'Authorization: Bearer <token>'

Companion

Companion: leer su configuración, la conversación y lo que recuerda

Solo lectura, con companion:leer. Un agente lee el companion pero no habla con él por ti: configurarlo, escribirle y corregir o borrar lo que recuerda se hace en la web. El companion es privado y vive en cada reto: un reto que no es tuyo, que ya terminó o que no admite companion responde lo mismo que uno que no existe.

GET /api/v1/cohortes/{id}/acompanamiento

Scope companion:leer

Ver el companion

La configuración del companion en un reto de la cuenta.

activo, funcion y personalidad, con las opciones disponibles en ese reto.
puede_pedir_consejo dice si hoy le puedes escribir desde la web.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes/42/acompanamiento' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/cohortes/{id}/acompanamiento/mensajes

Scope companion:leer

Leer la conversación

Los mensajes de hoy con el companion y el último consejo pedido.

Cada mensaje lleva rol: persona o companion, y via_agente si el de la persona lo escribió un agente.
ultimo_consejo dice si sigue pendiente, si llegó (con su respuesta) o si falló y es reintentable.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes/42/acompanamiento/mensajes' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/cohortes/{id}/acompanamiento/recuerdos

Scope companion:leer

Listar los recuerdos

Lo que el companion recuerda de la cuenta en ese reto.

Cada recuerdo trae su texto y si lo aprendió solo o lo corregiste.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/cohortes/42/acompanamiento/recuerdos' \
  -H 'Authorization: Bearer <token>'

Perfiles

Perfiles: ver el de una persona

Lectura con social:leer. Un username que no existe responde 404.

GET /api/v1/usuarios/{username}

Scope social:leer

Ver un perfil

El perfil de una persona por su username.

El propio trae nivel, días cumplidos y sus retos; uno ajeno, solo user_id y username.
Un username que no existe responde 404.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/usuarios/marta' \
  -H 'Authorization: Bearer <token>'

Ajustes

Ajustes de la cuenta, recordatorios y apps conectadas

Lecturas con perfil:leer y escrituras con perfil:escribir. Desconectar la app del propio agente le deja sin acceso.

GET /api/v1/ajustes

Scope perfil:leer

Ver los ajustes

Los ajustes de la cuenta.

idioma (nulo si sigue el del navegador), zona_horaria y hora_de_recordatorio (nula, sin recordatorio).
avisos: los seis avisos opcionales; no_molestar_desde y no_molestar_hasta, la franja.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/ajustes' \
  -H 'Authorization: Bearer <token>'

PATCH /api/v1/ajustes

Scope perfil:escribir

Cambiar los ajustes

Cambia los ajustes de la cuenta; solo lo que se manda.

idioma (es o en), hora_de_recordatorio de 0 a 23 (null la apaga) con zona_horaria opcional (también sola), avisos y la franja de no molestar.
Todo o nada: una zona que no se reconoce responde 422 y no guarda nada.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/ajustes' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"idioma":"es","hora_de_recordatorio":20}'

PATCH /api/v1/cohortes/{id}/recordatorio

Scope perfil:escribir

Recordatorio de un reto

Enciende o apaga el recordatorio de un reto de la cuenta.

activo true o false: el estado deseado, no alterna.
Un reto del que la cuenta no es miembro responde 404.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/cohortes/42/recordatorio' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"activo":false}'

GET /api/v1/ajustes/apps-conectadas

Scope perfil:leer

Apps conectadas

Las apps conectadas a la cuenta, con sus permisos.

Cada app lleva su nombre, sus scopes y cuándo se conectó.
esta_app marca la conexión que usa el propio agente.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/ajustes/apps-conectadas' \
  -H 'Authorization: Bearer <token>'

DELETE /api/v1/ajustes/apps-conectadas/{id}

Scope perfil:escribir

Desconectar una app

Desconecta una app: pierde el acceso a la cuenta.

Exige confirmacion desconectar; sin ella, 428.
No desconecta al momento: contesta 202 con una confirmación pendiente (confirmacion_id, estado, caduca_en). La persona la confirma o la rechaza en dotoo, arriba de «Tú»; hasta entonces no se hace nada. Repetir la petición devuelve esa confirmación con su estado de ahora.
Confirmada, si era la del propio agente, su siguiente petición responde 401. Una app ya desconectada contesta 200, sin confirmación.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/ajustes/apps-conectadas/7' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"confirmacion":"desconectar"}'

Dejar de fumar

Dejar de fumar: el contador del día, los antojos y la confianza

Escrituras con checkins:escribir sobre un reto Dejar de fumar de la cuenta; uno ajeno o de otra familia responde lo mismo que uno que no existe. El estado de hoy se lee en dejar_de_fumar de la ficha del reto, y cada gesto lo devuelve.

POST /api/v1/cohortes/{id}/consumos

Scope checkins:escribir

Sumar un consumo

Suma una unidad fumada hoy, como el «+1» de la ficha.

En poco a poco, pasar del cupo del día cuenta como desliz; en de golpe, cada consumo lo es.
Devuelve la clave_de_consumo que pide deshacer el último consumo.
Si escribe el check-in de hoy, queda marcado como hecho por un agente.
Exige la cabecera Idempotency-Key: la misma clave suma una sola vez, también al día siguiente.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/consumos' \
  -H 'Authorization: Bearer <token>'

DELETE /api/v1/cohortes/{id}/consumos/ultimo

Scope checkins:escribir

Deshacer el último consumo

Resta el último consumo de hoy, como el «-1» de la ficha.

clave_de_consumo es la de ese consumo; si ya no es el último de hoy, no resta nada y devuelve el estado.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/cohortes/42/consumos/ultimo?clave_de_consumo=<uuid>' \
  -H 'Authorization: Bearer <token>'

PATCH /api/v1/cohortes/{id}/dejar_de_fumar/confianza

Scope checkins:escribir

Fijar la confianza

Guarda tu confianza para mañana, de 1 a 10, en el plan poco a poco.

En de golpe no existe: 409 no_en_marcha.
Se guarda en el check-in de hoy, que queda marcado como hecho por un agente.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/cohortes/42/dejar_de_fumar/confianza' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"confianza":7}'

POST /api/v1/cohortes/{id}/antojos

Scope checkins:escribir

Registrar un antojo

Apunta un antojo y si lo superaste.

superado es true o false; la hora la pone el servidor.
Exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/cohortes/42/antojos' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"superado":true}'

PATCH /api/v1/cohortes/{id}/dejar_de_fumar/contador

Scope checkins:escribir

Fijar el contador destacado

Elige qué contador destaca la ficha: dias, unidades, dinero o antojos, o null para ninguno.

Solo vale uno de contadores_disponibles; si no, 422.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/cohortes/42/dejar_de_fumar/contador' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"contador":"dias"}'

Greetings

Greetings: leer el feed, publicar, apoyar y denunciar

Lecturas con spa:leer y escrituras con spa:escribir. Un greeting ajeno que no está en el feed responde lo mismo que uno que no existe.

GET /api/v1/saludos

Scope spa:leer

Leer los greetings

Los greetings aprobados de los últimos siete días, del más nuevo al más viejo.

De cada autor sale solo su inicial, como en la app.
Cada uno lleva cuántos apoyos tiene, si la cuenta ya lo apoyó o denunció y si es suyo.
Los tuyos en revisión no salen aquí: se leen con su id.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/saludos' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/saludos

Scope spa:escribir

Publicar un greeting

Publica un greeting de hasta 160 caracteres en Greetings Room.

texto y, opcional, zona, tu zona horaria (como Europe/Madrid) para contar el día; por defecto, la de la cuenta.
Responde 202 con moderacion pendiente: la revisión llega después y se lee con la ficha del greeting.
Tres al día (422 cupo_agotado) y cinco por minuto, sumando la app. Cada llamada publica uno: exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/saludos' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"texto":"Buenos días desde Girona"}'

GET /api/v1/saludos/{id}

Scope spa:leer

Ver un greeting

Un greeting de la cuenta y su revisión.

moderacion: pendiente, sin_veredicto (reintentable), aprobada o rechazada si la revisión borró un greeting publicado por esta API.
Un greeting ajeno responde 404.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/saludos/42' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/saludos/{id}/reintentar_revision

Scope spa:escribir

Reintentar la revisión

Vuelve a pedir la revisión de un greeting propio que quedó sin veredicto.

Responde 202 y el greeting vuelve a pendiente.
Repetirlo mientras sigue en revisión no pide otra; uno aprobado da 409 no_reintentable.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/saludos/42/reintentar_revision' \
  -H 'Authorization: Bearer <token>'

DELETE /api/v1/saludos/{id}

Scope spa:escribir

Borrar un greeting

Borra un greeting de la cuenta, con sus apoyos.

No se puede deshacer. La segunda vez ya no está: exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/saludos/42' \
  -H 'Authorization: Bearer <token>'

PUT /api/v1/saludos/{id}/apoyo

Scope spa:escribir

Apoyar un greeting

Deja el apoyo de la cuenta en un greeting del feed.

Es un estado: repetirlo no suma otro apoyo.
Devuelve cuántos apoyos tiene y si la cuenta lo apoya y lo denunció.

Petición de ejemplo

curl -s -X PUT \
  'https://app.do-too.com/api/v1/saludos/42/apoyo' \
  -H 'Authorization: Bearer <token>'

DELETE /api/v1/saludos/{id}/apoyo

Scope spa:escribir

Retirar el apoyo

Quita el apoyo de la cuenta a un greeting del feed.

Sin apoyo que quitar, responde lo mismo.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/saludos/42/apoyo' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/saludos/{id}/denuncia

Scope spa:escribir

Denunciar un greeting

Marca un greeting del feed para que se revise.

No lo retira ni pide motivo. Repetirla deja la misma denuncia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/saludos/42/denuncia' \
  -H 'Authorization: Bearer <token>'

Fogatas

Fogatas: crear, empezar y contar cómo fue

Lecturas con spa:leer y escrituras con spa:escribir. Una fogata en la que no participas responde lo mismo que una que no existe. Cada fogata es individual: solo participa quien la creó.

GET /api/v1/fogatas

Scope spa:leer

Mis fogatas

Las fogatas que siguen pidiendo algo: esperando, en marcha o con tu resultado sin contar.

Una fogata con tu resultado ya contado deja de salir.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/fogatas' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/fogatas

Scope spa:escribir

Crear una fogata

Una fogata de 25 o 50 minutos con tu intención, que solo ves tú.

duracion_minutos (25 o 50) e intencion.
Nace esperando y solo con quien la crea.
Cada llamada crea una: exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/fogatas' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"duracion_minutos":25,"intencion":"Terminar el informe"}'

GET /api/v1/fogatas/{id}

Scope spa:leer

Ver una fogata

Estado, hora de fin, y tu intención y tu resultado.

Leerla no te marca como presente.
Tu intención y tu resultado solo salen para ti.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/fogatas/42' \
  -H 'Authorization: Bearer <token>'

POST /api/v1/fogatas/{id}/empezar

Scope spa:escribir

Empezar una fogata

Arranca el reloj de una fogata que creaste.

Solo quien la creó. Repetirla no reinicia el reloj.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/api/v1/fogatas/42/empezar' \
  -H 'Authorization: Bearer <token>'

PATCH /api/v1/fogatas/{id}/resultado

Scope spa:escribir

Contar cómo fue

Al terminar, cuenta cómo te fue: hecho, sigo o cambio.

Solo lo ves tú. Antes de terminar responde 409 todavia_en_marcha.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/fogatas/42/resultado' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"resultado":"hecho"}'

DELETE /api/v1/fogatas/{id}

Scope spa:escribir

Borrar una fogata

Borra una fogata que creaste.

No se puede deshacer: sin confirmacion=borrar responde 428.
La segunda vez ya no está: exige la cabecera Idempotency-Key.

Petición de ejemplo

curl -s -X DELETE \
  'https://app.do-too.com/api/v1/fogatas/42?confirmacion=borrar' \
  -H 'Authorization: Bearer <token>'

Journal

Journal: tu diario privado

Lecturas con journal:leer y escrituras con journal:escribir sobre el diario de la cuenta, que nadie más ve. El día es el natural de la persona: zona, como Europe/Madrid, o sin ella, la zona de la cuenta.

GET /api/v1/journal

Scope journal:leer

Listar el diario

Tus entradas, más nuevas primero, con su primera línea, los días escritos y con agradecimientos.

Si el recordatorio está activo, trae el agradecimiento anterior que se rescata hoy.
El texto entero de una entrada se lee por su fecha.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/journal?zona=Europe/Madrid' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/journal/hoy

Scope journal:leer

Ver la entrada de hoy

Los bloques del reto desde el que escribes, lo ya escrito hoy y su version (0 si nada).

cohorte_id es un reto Journal tuyo con el día abierto; otro responde 404.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/journal/hoy?cohorte_id=42&zona=Europe/Madrid' \
  -H 'Authorization: Bearer <token>'

PUT /api/v1/journal/hoy

Scope journal:escribir

Escribir la entrada de hoy

Guarda la entrada de hoy y marca el día de tus retos Journal, como el botón de la web.

Reemplaza la entrada entera: diario, agradecimientos y bloques_personalizados (clave del bloque → texto, número o lista de opciones).
Exige la version de la entrada de hoy; si cambió entretanto, 412 version_obsoleta. Repetir lo mismo no es conflicto.
El texto se guarda aunque falle el check-in, y queda marcado como escrito por un agente.

Petición de ejemplo

curl -s -X PUT \
  'https://app.do-too.com/api/v1/journal/hoy' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"cohorte_id":"42","version":0,"diario":"…","agradecimientos":"…"}'

GET /api/v1/journal/{fecha}

Scope journal:leer

Leer una entrada

Una entrada entera por su fecha (como 2026-09-24); sin entrada ese día, 404.

Devuelve diario, agradecimientos, los bloques del reto con su valor y la version.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/journal/2026-09-24' \
  -H 'Authorization: Bearer <token>'

GET /api/v1/journal/ajustes

Scope journal:leer

Ver los ajustes del Journal

Si la portada rescata cada día un agradecimiento anterior.

Los campos del diario son del reto: se cambian editando el reto.

Petición de ejemplo

curl -s \
  'https://app.do-too.com/api/v1/journal/ajustes' \
  -H 'Authorization: Bearer <token>'

PATCH /api/v1/journal/ajustes

Scope journal:escribir

Cambiar los ajustes del Journal

Activa o apaga el agradecimiento rescatado.

recordar_agradecimientos es true o false; repetirlo deja lo mismo.

Petición de ejemplo

curl -s -X PATCH \
  'https://app.do-too.com/api/v1/journal/ajustes' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"recordar_agradecimientos":true}'

MCP remoto

Conecta tu agente por MCP

Todas las operaciones también se sirven como servidor MCP. Tu agente se conecta con OAuth, sin token: te pide permiso en dotoo y hace lo mismo que con la API, por las mismas operaciones.

Endpoint

POST https://app.do-too.com/mcp

Transporte Streamable HTTP sin estado: cada POST lleva un mensaje JSON-RPC y recibe una respuesta JSON, sin sesión ni Mcp-Session-Id. GET y DELETE responden 405.

OAuth

/.well-known/oauth-protected-resource/mcp

Sin token, /mcp responde 401 y anuncia el servidor de autorización de dotoo. El agente se registra solo, abre dotoo para que entres y des permiso, y canjea el código con PKCE. El access token dura una hora y solo vale en /mcp; el refresh rota en cada uso. Se corta en Ajustes → Apps conectadas.

El mismo Bearer

Authorization: Bearer <token>

Alternativa avanzada: el token de la API personal, con su caducidad, su revocación y el mismo límite de 120 peticiones por minuto. Sin un token válido responde 401 en problem+json, igual que /api/v1.

Respuestas

content · structuredContent

Cada tool devuelve el mismo sobre data que su operación de la API, como texto JSON y como structuredContent.

Lectura y escritura

readOnlyHint · idempotentHint

Las tools de lectura no cambian nada y las de escritura lo declaran en sus anotaciones, también si repetirlas deja el mismo estado. Los argumentos siguen el inputSchema de cada tool. Cada una exige su scope y los mismos controles que su operación de la API: un error responde isError con el mismo code, como scope_insuficiente o parametros_invalidos, y los mismos errors.

TOOL quien_soy

Scope perfil:leer

Quién soy

Tu perfil: el mismo cuerpo que GET /api/v1/yo. Ver la operación equivalente.

Incluye id, username, nivel, xp, dotoos y dias_cumplidos.
No expone el correo, sesiones, tokens ni credenciales.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"quien_soy","arguments":{}}}'

TOOL retos_activos

Scope cohortes:leer

Retos activos

Tus retos abiertos o en marcha: el mismo cuerpo que GET /api/v1/cohortes. Ver la operación equivalente.

Los retos en marcha van primero; los cerrados nunca salen.
Cada reto incluye fechas, estado, plazas, personas, día actual y ventana de check-in.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"retos_activos","arguments":{}}}'

TOOL ver_reto

Scope cohortes:leer

Ver un reto

La ficha completa de uno de tus retos: el mismo cuerpo que GET /api/v1/cohortes/{id}. Ver la operación equivalente.

Incluye moderación, sala_id, miembros, tu check-in de hoy y el juego del día.
No prepara el juego del día: solo lee si ya existe.
El juego del día trae el id que piden ver_blur y responder_blur; en La regla oculta, además el estado de la regla y tus envíos de hoy con su veredicto.
En Dejar de fumar, dejar_de_fumar trae el estado de hoy, con la clave que pide deshacer_ultimo_consumo.
Incluye la descripción, el token_invitacion que ven los miembros, los items del checklist (su posición es el índice de items_marcados), los objetivos, descripcion_foto y el progreso del grupo en un colectivo.
checkin_de_hoy trae verificacion: el veredicto de la foto tras el 202 de hacer_checkin.
En el lobby, votos_del_lobby da tu voto de franja y el recuento; en El atrevimiento, el título y la consigna de hoy; en La regla oculta, la pizarra con los envíos de todo el grupo.
En El atrevimiento, galeria trae las fotos aprobadas de hoy de todo el grupo, con el id que pide ver_foto_de_atrevimiento.
recordatorio_activo dice si el recordatorio de ese reto está encendido, el que cambia configurar_recordatorio_de_reto.
En La regla oculta, dias_anteriores trae los días acabados con la regla revelada y quién la resolvió; en Dejar de fumar de golpe, hito_de_salud trae el próximo hito desde la última calada y su fuente.
Un reto cerrado también se abre: trae cierre con tus días cumplidos, los XP y dotoos del reto, la cifra del grupo, el regalo, los niveles que cruzaste y el día del mural, y sin juego del día.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_reto","arguments":{}}}'

TOOL buscar_retos_publicos

Scope cohortes:leer

Buscar retos públicos

Oferta pública a la que todavía puedes unirte: el mismo cuerpo que GET /api/v1/cohortes/publicas. Ver la operación equivalente.

Acepta filtro, categoria, sistema y busqueda además de cursor y limit.
Cada reto trae su descripción.
Cada reto trae su token_invitacion, el del enlace al que lleva la tarjeta del campamento.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buscar_retos_publicos","arguments":{}}}'

TOOL resumen_de_hoy

Scope cohortes:leer

Resumen de hoy

Invitaciones pendientes y retos disueltos: el mismo cuerpo que GET /api/v1/hoy. Ver la operación equivalente.

No marca nada como visto; es una lectura pura.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"resumen_de_hoy","arguments":{}}}'

TOOL listar_plantillas_de_reto

Scope cohortes:leer

Listar plantillas de reto

Las plantillas para crear un reto: el mismo cuerpo que GET /api/v1/cohortes/plantillas. Ver la operación equivalente.

Acepta categoria para filtrar.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"listar_plantillas_de_reto","arguments":{}}}'

TOOL historial_de_retos

Scope cohortes:leer

Historial de retos

El historial de retos de la cuenta: el mismo cuerpo que GET /api/v1/cohortes/historial. Ver la operación equivalente.

Acepta estado: en_curso, terminados o abandonados.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"historial_de_retos","arguments":{}}}'

TOOL ver_tema_de_retos

Scope cohortes:leer

Retos temáticos

El tema vigente o uno pasado: el mismo cuerpo que GET /api/v1/temas. Ver la operación equivalente.

Acepta clave para pedir un tema pasado concreto.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_tema_de_retos","arguments":{}}}'

TOOL ver_invitacion_a_reto

Scope cohortes:leer

Ver una invitación

Un reto visto desde su enlace: el mismo cuerpo que GET /api/v1/invitaciones/{token}. Ver la operación equivalente.

Requiere token; un token inválido responde 404.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_invitacion_a_reto","arguments":{}}}'

TOOL listar_invitables_a_reto

Scope cohortes:leer

Invitables a un reto

Gente del reto anterior que se puede invitar: el mismo cuerpo que GET /api/v1/cohortes/{id}/invitables. Ver la operación equivalente.

Requiere id; un reto ajeno responde 404.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"listar_invitables_a_reto","arguments":{}}}'

TOOL crear_reto

Scope cohortes:escribir

Crear un reto

Crea un reto: la misma operación que POST /api/v1/cohortes. Ver la operación equivalente.

Requiere clave_de_idempotencia; el desenlace de la moderación se lee después en ver_reto.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"crear_reto","arguments":{"nombre":"Leer 20 minutos","duracion_dias":14,"tipo_de_check":"simple","clave_de_idempotencia":"<uuid>"}}}'

TOOL editar_reto

Scope cohortes:escribir

Editar un reto

Cambia los ajustes de un reto: la misma operación que PATCH /api/v1/cohortes/{id}. Ver la operación equivalente.

Quitar un campo del diario exige confirmacion: true.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"editar_reto","arguments":{"id":"42","plazas":10}}}'

TOOL reintentar_revision_de_reto

Scope cohortes:escribir

Reintentar la revisión

Vuelve a pedir el veredicto de moderación: la misma operación que POST /api/v1/cohortes/{id}/reintentar_revision. Ver la operación equivalente.

Solo desde sin_veredicto.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reintentar_revision_de_reto","arguments":{"id":"42"}}}'

TOOL unirse_a_reto

Scope cohortes:escribir

Unirse a un reto

Te une a un reto por id (público) o por token (su enlace): las mismas operaciones que POST /api/v1/cohortes/{id}/participacion y POST /api/v1/invitaciones/{token}. Ver la operación equivalente.

Uno de los dos, id o token; un reto privado por id responde 404.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"unirse_a_reto","arguments":{"id":"42"}}}'

TOOL abandonar_reto

Scope cohortes:escribir

Abandonar un reto

Sales de un reto o lo disuelves si lo creaste: la misma operación que DELETE /api/v1/cohortes/{id}/participacion. Ver la operación equivalente.

Requiere confirmacion: true y clave_de_idempotencia.
Deja una confirmación pendiente (202) que la persona confirma o rechaza en «Tú».

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"abandonar_reto","arguments":{"id":"42","confirmacion":true,"clave_de_idempotencia":"<uuid>"}}}'

TOOL invitar_a_reto

Scope cohortes:escribir

Invitar a un reto

Invita a varias personas: la misma operación que POST /api/v1/cohortes/{id}/invitaciones. Ver la operación equivalente.

Devuelve el resultado de cada persona.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"invitar_a_reto","arguments":{"id":"42","user_ids":["7","12"]}}}'

TOOL votar_franja

Scope cohortes:escribir

Votar la franja

Tu voto de franja del día: la misma operación que PUT /api/v1/cohortes/{id}/voto_de_franja. Ver la operación equivalente.

Solo mientras el reto está en su lobby.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"votar_franja","arguments":{"id":"42","opcion":"manana"}}}'

TOOL dar_toque

Scope cohortes:escribir

Dar un toque

Un toque a alguien del reto: la misma operación que POST /api/v1/cohortes/{id}/toques. Ver la operación equivalente.

Uno por persona, reto y día del reto.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"dar_toque","arguments":{"id":"42","user_id":"7"}}}'

TOOL preparar_subida

Scope checkins:escribir

Preparar la subida de una foto

Reserva una subida: la misma operación que POST /api/v1/subidas. Ver la operación equivalente.

Argumentos: nombre_de_archivo, bytes, checksum, tipo_mime y clave_de_idempotencia. Por MCP suele ser más directo imagen_base64 en hacer_checkin.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preparar_subida","arguments":{"nombre_de_archivo":"foto.jpg","bytes":183422,"checksum":"1B2M2Y8AsgTpgAmY7PhCfg==","tipo_mime":"image/jpeg","clave_de_idempotencia":"<uuid>"}}}'

TOOL hacer_checkin

Scope checkins:escribir

Marcar el día

El check-in de hoy de un reto tuyo: la misma operación que POST /api/v1/cohortes/{id}/checkins. Ver la operación equivalente.

Argumentos: id y lo que pida la familia (cantidad, texto, segundos, resultado, items_marcados), y, opcional, zona para Journal.
Con foto: imagen_base64 y tipo_mime en la misma llamada, o imagen_signed_id tras preparar_subida. Repetirla devuelve el mismo check-in.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hacer_checkin","arguments":{"id":"42","cantidad":30}}}'

TOOL probar_palabra

Scope checkins:escribir

Probar una palabra

Una palabra contra la regla oculta de hoy: la misma operación que POST /api/v1/cohortes/{id}/regla/intentos. Ver la operación equivalente.

Argumentos: id (el del reto) y texto.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"probar_palabra","arguments":{"id":"42","texto":"perro"}}}'

TOOL formular_regla

Scope checkins:escribir

Formular la regla

Tu propuesta de regla oculta: la misma operación que POST /api/v1/cohortes/{id}/regla/formulaciones. Ver la operación equivalente.

Argumentos: id (el del reto) y texto. El veredicto llega después.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"formular_regla","arguments":{"id":"42","texto":"palabras de cinco letras"}}}'

TOOL ver_blur

Scope cohortes:leer

Ver un día de Blur

Turno, opciones y tu respuesta: la misma operación que GET /api/v1/blurs_del_dia/{id}. Ver la operación equivalente.

Argumento: id (el del día de Blur).

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_blur","arguments":{"id":"42"}}}'

TOOL responder_blur

Scope checkins:escribir

Responder al Blur

Tu respuesta al Blur del día: la misma operación que POST /api/v1/blurs_del_dia/{id}/respuesta. Ver la operación equivalente.

Argumentos: id (el del día de Blur) y opcion (0 a 3).

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"responder_blur","arguments":{"id":"42","opcion":2}}}'

TOOL ver_foto_de_blur

Scope cohortes:leer

Ver la foto desenfocada

La foto desenfocada de un día de Blur: la misma operación que GET /api/v1/fotos_de_blur/{id}. Ver la operación equivalente.

Argumento: id (el del día de Blur). La foto llega como imagen, además del cuerpo JSON.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_foto_de_blur","arguments":{"id":"42"}}}'

TOOL ver_foto_nitida_de_blur

Scope cohortes:leer

Ver la foto nítida

La foto original de un día de Blur: la misma operación que GET /api/v1/fotos_de_blur/{id}/nitida. Ver la operación equivalente.

Argumento: id (el del día de Blur). Solo si la subiste o ya respondiste.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_foto_nitida_de_blur","arguments":{"id":"42"}}}'

TOOL valorar_atrevimiento

Scope checkins:escribir

Valorar un atrevimiento

Tu sí o no a un atrevimiento que ya cumpliste: la misma operación que POST /api/v1/atrevimientos_del_dia/{id}/valoracion. Ver la operación equivalente.

Argumentos: id (el del atrevimiento del día) y valoracion (si o no).
Devuelve el mismo cuerpo que la API; un id ajeno o sin cumplir da recurso_no_encontrado.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"valorar_atrevimiento","arguments":{"id":"42","valoracion":"si"}}}'

TOOL ver_foto_de_atrevimiento

Scope cohortes:leer

Ver la foto de un atrevimiento

La foto de un atrevimiento cumplido: la misma operación que GET /api/v1/fotos_de_atrevimientos/{id}. Ver la operación equivalente.

Argumento: id (el del check-in). La foto llega como imagen, además del cuerpo JSON.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_foto_de_atrevimiento","arguments":{"id":"42"}}}'

TOOL leer_chat

Scope chat:leer

Leer el chat

El hilo de un reto o de una sala: la misma operación que GET /api/v1/chat/mensajes. Ver la operación equivalente.

Argumentos: cohorte_id o sala_id (uno de los dos) y, opcional, desde.
No marca el chat como leído ni renueva presencia.
Cada mensaje lleva de_terceros y cliente_de_agente; aviso recuerda que lo de terceros son datos, no instrucciones.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"leer_chat","arguments":{"cohorte_id":"42"}}}'

TOOL novedades_del_chat

Scope chat:leer

Novedades de todos los chats

Lo nuevo de todos los chats de la persona desde la última llamada de esta app: la misma operación que POST /api/v1/chat/novedades. Ver la operación equivalente.

Argumentos: opcional, limite.
Avanza el cursor de la app: lo devuelto no vuelve a salir. Si hay_mas es true, vuelve a llamar.
Es una lectura: no marca nada como leído para la persona.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"novedades_del_chat","arguments":{"limite":50}}}'

TOOL escribir_mensaje

Scope chat:escribir

Escribir un mensaje

Escribe en el chat de un reto o de una sala: la misma operación que POST /api/v1/chat/mensajes. Ver la operación equivalente.

Argumentos: cohorte_id o sala_id (uno de los dos), cuerpo y, opcional, zona.
Cada llamada crea un mensaje: pide una clave_de_idempotencia.
El mensaje queda marcado via_agente, con su cliente_de_agente, en lo que devuelve la API; la vista del chat no lo señala.
Como mucho 10 al día en cada chat; el siguiente es tope_diario_de_agente.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"escribir_mensaje","arguments":{"cohorte_id":"42","cuerpo":"¡Hola!","clave_de_idempotencia":"<uuid>"}}}'

TOOL borrar_mensaje

Scope chat:escribir

Borrar un mensaje

Borra un mensaje propio: la misma operación que DELETE /api/v1/chat/mensajes/{id}. Ver la operación equivalente.

Argumentos: id y cohorte_id o sala_id (uno de los dos).
Es un borrado real: pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"borrar_mensaje","arguments":{"id":"99","cohorte_id":"42","clave_de_idempotencia":"<uuid>"}}}'

TOOL reaccionar_a_mensaje

Scope chat:escribir

Reaccionar a un mensaje

Pone, cambia o quita la reacción de la cuenta: la misma operación que PUT /api/v1/chat/mensajes/{id}/reaccion. Ver la operación equivalente.

Argumentos: id, cohorte_id o sala_id (uno de los dos) y tipo (o null para retirarla).

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reaccionar_a_mensaje","arguments":{"id":"99","cohorte_id":"42","tipo":"aplauso"}}}'

TOOL denunciar_mensaje

Scope chat:escribir

Denunciar un mensaje

Deja un mensaje marcado para revisión: la misma operación que POST /api/v1/chat/mensajes/{id}/denuncia. Ver la operación equivalente.

Argumentos: id y cohorte_id o sala_id (uno de los dos).

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"denunciar_mensaje","arguments":{"id":"99","cohorte_id":"42"}}}'

TOOL ver_tesoreria

Scope perfil:leer

Ver la tesorería

Saldo y últimos movimientos de dotoos: el mismo cuerpo que GET /api/v1/tesoreria. Ver la operación equivalente.

Hasta 100 movimientos, del más reciente al más antiguo.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_tesoreria","arguments":{}}}'

TOOL listar_apuestas

Scope perfil:leer

Ver mis apuestas

Apuestas pendientes y resueltas con el balance: el mismo cuerpo que GET /api/v1/apuestas. Ver la operación equivalente.

El balance sale del ledger, igual que en la API.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"listar_apuestas","arguments":{}}}'

TOOL apostar_dotoos

Scope dotoos:gastar

Apostar dotoos

Apuesta 3 dotoos en un reto en marcha; premio 6. Exige clave_de_idempotencia. Ver la operación equivalente.

Solo los lunes; repetirla en la misma semana es un conflicto.
Deja una confirmación pendiente (202) que la persona confirma o rechaza en «Tú».

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"apostar_dotoos","arguments":{}}}'

TOOL ver_armario

Scope perfil:leer

Ver el armario

Catálogo de prendas y pelajes con lo comprado y lo puesto: el mismo cuerpo que GET /api/v1/armario. Ver la operación equivalente.

Incluye el precio y el nivel de cada prenda y cada tono.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_armario","arguments":{}}}'

TOOL comprar_prenda

Scope dotoos:gastar

Comprar una prenda

Compra una prenda con dotoos. Exige clave_de_idempotencia y confirmacion con el precio leído. Ver la operación equivalente.

Sin devolución; precio desactualizado es un conflicto.
Deja una confirmación pendiente (202) que la persona confirma o rechaza en «Tú».

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"comprar_prenda","arguments":{}}}'

TOOL equipar_prenda

Scope perfil:escribir

Equipar o quitar una prenda

Pone o quita una prenda ya comprada, con el id de su fila de compras. Ver la operación equivalente.

equipada: false la quita del slot.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"equipar_prenda","arguments":{}}}'

TOOL cambiar_pelaje

Scope perfil:escribir

Cambiar el pelaje

Pone un pelaje; si es de pago y aún no lo tiene, lo compra (exige dotoos:gastar). Ver la operación equivalente.

Un tono liso solo pide el nivel desbloqueado.
Comprar un tono con patrón deja una confirmación pendiente (202) que la persona confirma o rechaza en «Tú».

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cambiar_pelaje","arguments":{}}}'

TOOL mis_clubs

Scope social:leer

Mis clubes

Los clubes de la cuenta: la misma operación que GET /api/v1/clubs. Ver la operación equivalente.

Sin argumentos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mis_clubs","arguments":{}}}'

TOOL buscar_clubs

Scope social:leer

Buscar clubes

Clubes abiertos por nombre: la misma operación que GET /api/v1/clubs/publicos. Ver la operación equivalente.

Argumento: busqueda.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buscar_clubs","arguments":{"busqueda":"correr"}}}'

TOOL crear_club

Scope social:escribir

Crear un club

Crea un club en revisión: la misma operación que POST /api/v1/clubs. Ver la operación equivalente.

Argumentos: nombre y, opcional, descripcion.
Cada llamada crea un club: pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"crear_club","arguments":{"nombre":"Corremos a las nueve","clave_de_idempotencia":"<uuid>"}}}'

TOOL ver_club

Scope social:leer

Ver un club

La ficha de un club propio y su revisión: la misma operación que GET /api/v1/clubs/{id}. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_club","arguments":{"id":"42"}}}'

TOOL reintentar_revision_de_club

Scope social:escribir

Reintentar la revisión

Vuelve a pedir la revisión de un club sin veredicto: la misma operación que POST /api/v1/clubs/{id}/reintentar_revision. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reintentar_revision_de_club","arguments":{"id":"42"}}}'

TOOL ver_invitacion_a_club

Scope social:leer

Ver la invitación a un club

La ficha pública del enlace: la misma operación que GET /api/v1/clubs/invitaciones/{token}. Ver la operación equivalente.

Argumento: token.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_invitacion_a_club","arguments":{"token":"<token>"}}}'

TOOL pedir_entrar_en_club

Scope social:escribir

Pedir entrar en un club

Pide entrar por id o por el token del enlace: la misma operación que POST /api/v1/clubs/{id}/solicitudes. Ver la operación equivalente.

Argumentos: id o token, uno de los dos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pedir_entrar_en_club","arguments":{"id":"42"}}}'

TOOL aceptar_solicitud_de_club

Scope social:escribir

Aceptar una solicitud

Un owner admite a quien pidió entrar: la misma operación que POST /api/v1/clubs/{id}/solicitudes/{solicitud_id}/aceptar. Ver la operación equivalente.

Argumentos: id y solicitud_id; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"aceptar_solicitud_de_club","arguments":{"id":"42","solicitud_id":"7","clave_de_idempotencia":"<uuid>"}}}'

TOOL rechazar_solicitud_de_club

Scope social:escribir

Rechazar una solicitud

Un owner rechaza a quien pidió entrar: la misma operación que DELETE /api/v1/clubs/{id}/solicitudes/{solicitud_id}. Ver la operación equivalente.

Argumentos: id y solicitud_id; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"rechazar_solicitud_de_club","arguments":{"id":"42","solicitud_id":"7","clave_de_idempotencia":"<uuid>"}}}'

TOOL buscar_persona_para_club

Scope social:leer

Buscar a quién invitar

Username exacto, solo para owners: la misma operación que GET /api/v1/clubs/{id}/personas. Ver la operación equivalente.

Argumentos: id y username.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buscar_persona_para_club","arguments":{"id":"42","username":"marta"}}}'

TOOL invitar_a_club

Scope social:escribir

Invitar a un club

Un owner invita por username: la misma operación que POST /api/v1/clubs/{id}/invitaciones. Ver la operación equivalente.

Argumentos: id y username.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"invitar_a_club","arguments":{"id":"42","username":"marta"}}}'

TOOL mis_invitaciones_a_clubs

Scope social:leer

Mis invitaciones a clubes

Las invitaciones pendientes: la misma operación que GET /api/v1/clubs/invitaciones_recibidas. Ver la operación equivalente.

Sin argumentos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mis_invitaciones_a_clubs","arguments":{}}}'

TOOL aceptar_invitacion_a_club

Scope social:escribir

Aceptar una invitación

Entra en el club sin aprobación: la misma operación que POST /api/v1/clubs/{id}/invitaciones/{invitacion_id}/aceptar. Ver la operación equivalente.

Argumentos: id e invitacion_id; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"aceptar_invitacion_a_club","arguments":{"id":"42","invitacion_id":"9","clave_de_idempotencia":"<uuid>"}}}'

TOOL rechazar_invitacion_a_club

Scope social:escribir

Rechazar una invitación

Borra la invitación sin avisar: la misma operación que DELETE /api/v1/clubs/{id}/invitaciones/{invitacion_id}. Ver la operación equivalente.

Argumentos: id e invitacion_id; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"rechazar_invitacion_a_club","arguments":{"id":"42","invitacion_id":"9","clave_de_idempotencia":"<uuid>"}}}'

TOOL ver_companion

Scope companion:leer

Ver el companion

La configuración del companion: la misma operación que GET /api/v1/cohortes/{id}/acompanamiento. Ver la operación equivalente.

Argumento: id del reto.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_companion","arguments":{"id":"42"}}}'

TOOL leer_conversacion_con_companion

Scope companion:leer

Leer la conversación

Los mensajes de hoy y el último consejo: la misma operación que GET /api/v1/cohortes/{id}/acompanamiento/mensajes. Ver la operación equivalente.

Argumento: id del reto.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"leer_conversacion_con_companion","arguments":{"id":"42"}}}'

TOOL listar_recuerdos

Scope companion:leer

Listar los recuerdos

Lo que recuerda el companion: la misma operación que GET /api/v1/cohortes/{id}/acompanamiento/recuerdos. Ver la operación equivalente.

Argumento: id del reto.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"listar_recuerdos","arguments":{"id":"42"}}}'

TOOL ver_perfil

Scope social:leer

Ver un perfil

El perfil de una persona: la misma operación que GET /api/v1/usuarios/{username}. Ver la operación equivalente.

Argumento: username.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_perfil","arguments":{"username":"marta"}}}'

TOOL ver_ajustes

Scope perfil:leer

Ver los ajustes

Los ajustes: la misma operación que GET /api/v1/ajustes. Ver la operación equivalente.

Sin argumentos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_ajustes","arguments":{}}}'

TOOL cambiar_ajustes

Scope perfil:escribir

Cambiar los ajustes

Cambia los ajustes: la misma operación que PATCH /api/v1/ajustes. Ver la operación equivalente.

Argumentos: idioma, hora_de_recordatorio, zona_horaria, avisos, no_molestar_desde, no_molestar_hasta; al menos uno.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cambiar_ajustes","arguments":{"avisos":{"toque":false}}}}'

TOOL configurar_recordatorio_de_reto

Scope perfil:escribir

Recordatorio de un reto

El recordatorio de un reto: la misma operación que PATCH /api/v1/cohortes/{id}/recordatorio. Ver la operación equivalente.

Argumentos: id y activo.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"configurar_recordatorio_de_reto","arguments":{"id":"42","activo":false}}}'

TOOL listar_apps_conectadas

Scope perfil:leer

Apps conectadas

Las apps conectadas: la misma operación que GET /api/v1/ajustes/apps-conectadas. Ver la operación equivalente.

Sin argumentos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"listar_apps_conectadas","arguments":{}}}'

TOOL revocar_app_conectada

Scope perfil:escribir

Desconectar una app

Desconecta una app: la misma operación que DELETE /api/v1/ajustes/apps-conectadas/{id}. Ver la operación equivalente.

Argumentos: id y confirmacion "desconectar".
Deja una confirmación pendiente (202) que la persona confirma o rechaza en «Tú».

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"revocar_app_conectada","arguments":{"id":"7","confirmacion":"desconectar"}}}'

TOOL registrar_consumo

Scope checkins:escribir

Sumar un consumo

Suma una unidad fumada hoy: la misma operación que POST /api/v1/cohortes/{id}/consumos. Ver la operación equivalente.

Argumento: id del reto; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"registrar_consumo","arguments":{"id":"42","clave_de_idempotencia":"<uuid>"}}}'

TOOL deshacer_ultimo_consumo

Scope checkins:escribir

Deshacer el último consumo

Resta el último consumo de hoy: la misma operación que DELETE /api/v1/cohortes/{id}/consumos/ultimo. Ver la operación equivalente.

Argumentos: id y clave_de_consumo.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deshacer_ultimo_consumo","arguments":{"id":"42","clave_de_consumo":"<uuid>"}}}'

TOOL fijar_confianza_de_fumar

Scope checkins:escribir

Fijar la confianza

Guarda la confianza para mañana: la misma operación que PATCH /api/v1/cohortes/{id}/dejar_de_fumar/confianza. Ver la operación equivalente.

Argumentos: id y confianza, de 1 a 10.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fijar_confianza_de_fumar","arguments":{"id":"42","confianza":7}}}'

TOOL registrar_antojo

Scope checkins:escribir

Registrar un antojo

Apunta un antojo: la misma operación que POST /api/v1/cohortes/{id}/antojos. Ver la operación equivalente.

Argumentos: id y superado; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"registrar_antojo","arguments":{"id":"42","superado":true,"clave_de_idempotencia":"<uuid>"}}}'

TOOL fijar_contador_de_fumar

Scope checkins:escribir

Fijar el contador destacado

Elige el contador de la ficha: la misma operación que PATCH /api/v1/cohortes/{id}/dejar_de_fumar/contador. Ver la operación equivalente.

Argumentos: id y contador, o null para ninguno.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fijar_contador_de_fumar","arguments":{"id":"42","contador":"dias"}}}'

TOOL leer_saludos

Scope spa:leer

Leer los greetings

El feed de Greetings Room: la misma operación que GET /api/v1/saludos. Ver la operación equivalente.

Sin argumentos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"leer_saludos","arguments":{}}}'

TOOL publicar_saludo

Scope spa:escribir

Publicar un greeting

Publica un greeting en revisión: la misma operación que POST /api/v1/saludos. Ver la operación equivalente.

Argumentos: texto y, opcional, zona.
Cada llamada publica uno: pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"publicar_saludo","arguments":{"texto":"Buenos días desde Girona","clave_de_idempotencia":"<uuid>"}}}'

TOOL ver_saludo

Scope spa:leer

Ver un greeting

Un greeting propio y su revisión: la misma operación que GET /api/v1/saludos/{id}. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_saludo","arguments":{"id":"42"}}}'

TOOL reintentar_revision_de_saludo

Scope spa:escribir

Reintentar la revisión

Vuelve a pedir la revisión de un greeting sin veredicto: la misma operación que POST /api/v1/saludos/{id}/reintentar_revision. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reintentar_revision_de_saludo","arguments":{"id":"42"}}}'

TOOL borrar_saludo

Scope spa:escribir

Borrar un greeting

Borra un greeting propio: la misma operación que DELETE /api/v1/saludos/{id}. Ver la operación equivalente.

Argumento: id; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"borrar_saludo","arguments":{"id":"42","clave_de_idempotencia":"<uuid>"}}}'

TOOL apoyar_saludo

Scope spa:escribir

Apoyar un greeting

Apoya un greeting del feed: la misma operación que PUT /api/v1/saludos/{id}/apoyo. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"apoyar_saludo","arguments":{"id":"42"}}}'

TOOL retirar_apoyo_a_saludo

Scope spa:escribir

Retirar el apoyo

Quita el apoyo a un greeting: la misma operación que DELETE /api/v1/saludos/{id}/apoyo. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"retirar_apoyo_a_saludo","arguments":{"id":"42"}}}'

TOOL denunciar_saludo

Scope spa:escribir

Denunciar un greeting

Marca un greeting para revisión: la misma operación que POST /api/v1/saludos/{id}/denuncia. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"denunciar_saludo","arguments":{"id":"42"}}}'

TOOL mis_fogatas

Scope spa:leer

Mis fogatas

Tus fogatas vivas: la misma operación que GET /api/v1/fogatas. Ver la operación equivalente.

Sin argumentos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mis_fogatas","arguments":{}}}'

TOOL crear_fogata

Scope spa:escribir

Crear una fogata

Crea una fogata: la misma operación que POST /api/v1/fogatas. Ver la operación equivalente.

Argumentos: duracion_minutos e intencion; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"crear_fogata","arguments":{"duracion_minutos":25,"intencion":"Terminar el informe","clave_de_idempotencia":"<uuid>"}}}'

TOOL ver_fogata

Scope spa:leer

Ver una fogata

La sala, sin marcarte como presente: la misma operación que GET /api/v1/fogatas/{id}. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_fogata","arguments":{"id":"42"}}}'

TOOL empezar_fogata

Scope spa:escribir

Empezar una fogata

Arranca una fogata que creaste: la misma operación que POST /api/v1/fogatas/{id}/empezar. Ver la operación equivalente.

Argumento: id.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"empezar_fogata","arguments":{"id":"42"}}}'

TOOL registrar_resultado_de_fogata

Scope spa:escribir

Contar cómo fue

Tu resultado al terminar: la misma operación que PATCH /api/v1/fogatas/{id}/resultado. Ver la operación equivalente.

Argumentos: id y resultado.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"registrar_resultado_de_fogata","arguments":{"id":"42","resultado":"hecho"}}}'

TOOL borrar_fogata

Scope spa:escribir

Borrar una fogata

Borra una fogata que creaste: la misma operación que DELETE /api/v1/fogatas/{id}. Ver la operación equivalente.

Argumentos: id y confirmacion "borrar"; pide una clave_de_idempotencia.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"borrar_fogata","arguments":{"id":"42","confirmacion":"borrar","clave_de_idempotencia":"<uuid>"}}}'

TOOL listar_entradas_de_journal

Scope journal:leer

Listar el diario

Tus entradas con su primera línea y tus cifras: la misma operación que GET /api/v1/journal. Ver la operación equivalente.

Argumento opcional: zona.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"listar_entradas_de_journal","arguments":{"zona":"Europe/Madrid"}}}'

TOOL ver_journal_de_hoy

Scope journal:leer

Ver la entrada de hoy

Bloques, texto y version de hoy: la misma operación que GET /api/v1/journal/hoy. Ver la operación equivalente.

Argumentos: cohorte_id y, opcional, zona.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_journal_de_hoy","arguments":{"cohorte_id":"42","zona":"Europe/Madrid"}}}'

TOOL escribir_journal_de_hoy

Scope journal:escribir

Escribir la entrada de hoy

Guarda la entrada de hoy: la misma operación que PUT /api/v1/journal/hoy. Ver la operación equivalente.

Argumentos: cohorte_id, version, diario, agradecimientos, bloques_personalizados y, opcional, zona.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"escribir_journal_de_hoy","arguments":{"cohorte_id":"42","version":0,"diario":"…","agradecimientos":"…"}}}'

TOOL leer_entrada_de_journal

Scope journal:leer

Leer una entrada

Una entrada por su fecha: la misma operación que GET /api/v1/journal/{fecha}. Ver la operación equivalente.

Argumento: fecha, como 2026-09-24.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"leer_entrada_de_journal","arguments":{"fecha":"2026-09-24"}}}'

TOOL ver_ajustes_de_journal

Scope journal:leer

Ver los ajustes del Journal

El recordatorio de agradecimientos: la misma operación que GET /api/v1/journal/ajustes. Ver la operación equivalente.

Sin argumentos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ver_ajustes_de_journal","arguments":{}}}'

TOOL cambiar_ajustes_de_journal

Scope journal:escribir

Cambiar los ajustes del Journal

Activa o apaga el recordatorio: la misma operación que PATCH /api/v1/journal/ajustes. Ver la operación equivalente.

Argumento: recordar_agradecimientos.

Petición de ejemplo

curl -s -X POST \
  'https://app.do-too.com/mcp' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cambiar_ajustes_de_journal","arguments":{"recordar_agradecimientos":true}}}'

¿Necesitas acceso para probarlo?

Cuéntanos el cliente que quieres conectar. El acceso sigue siendo manual mientras validamos este primer contrato.

Pedir acceso