Servidor MCP

Planea viajes desde tu agente.

El servidor MCP de Tucanoo permite que tu agente cree, lea y edite itinerarios día a día. El viaje vive en Tucanoo, con mapa, horarios y acceso sin internet; los lugares salen de nuestro mapa, nunca inventados.

Dirección del servidor
https://tucanoo.app/mcp
Streamable HTTP · OAuth 2.1 · tucanoo.app
Conectar mi cuenta

Gratis para empezar. Entra con Google o Apple.

claude mcp add --transport http tucanoo https://tucanoo.app/mcp
  1. 1Corre el comando en la terminal.
  2. 2En Claude Code, escribe /mcp e inicia sesión. O corre claude mcp login en la shell.

Claude Code guarda y renueva el token.

Pásale esto a tu agente

Pégalo una vez, después de conectar. Le dice al agente cómo usar bien las herramientas.

Tienes conectado el servidor MCP de Tucanoo (https://tucanoo.app/mcp). Úsalo para planear mis viajes. Llama primero a get_account para ver qué permite mi plan. Lee el viaje con list_trips y get_trip antes de cambiarlo. Nunca elijas lugares por tu cuenta: agrega paradas por nombre con add_stops y deja que Tucanoo encuentre el lugar real. Mándame siempre el enlace del viaje.

Después pide

Crea un viaje a Lisboa del 12 al 16 de mayo para los dos y mándame el enlace.

Pon el Palacio da Pena a las 10 el día 3 del viaje a Lisboa.

¿Cuál es mi próximo viaje y qué hay el primer día?

Herramientas

Leídas directo de las definiciones del servidor: la misma lista que tu agente recibe en tools/list. Nombres y campos en inglés; el agente te habla en tu idioma.

  • get_accountCuenta y plan · solo lectura
    Muestra el plan de la cuenta, cuántas generaciones por el agente quedan en el año y qué permite el gratis.
    Salidaplangenerations_left_this_yearpro_url
    Gratis · Pro
  • list_tripsListar viajes · solo lectura
    Lista los viajes de la persona (dueña o acompañante), con fechas y el enlace de cada uno.
    Salidatrips[]
    Gratis · Pro
  • get_tripVer viaje · solo lectura
    Muestra un viaje: fechas, quién va y cada día con sus paradas.
    Entradatrip_id
    Salidadays[]itinerary_statusurl
    Gratis · Pro
  • get_dayVer día · solo lectura
    Muestra un día con todas las paradas: id, horario, duración, lugar y quién la puso.
    Entradatrip_idday
    Salidastops[]summaryurl
    Gratis · Pro
  • create_tripCrear viaje
    Crea el viaje a partir de la frase de la persona, con fechas y quién va.Gratis: el viaje empieza vacío. Pro: ya puede armar el itinerario.
    Entradadescriptionstart_date?end_date?adults?children?generate_itinerary?request_id?
    Salidatrip_idurlitinerary_status
    Gratis · Pro
  • generate_itineraryGenerar itinerario
    Arma el itinerario día a día de un viaje todavía vacío (nosotros elegimos los lugares).
    Entradatrip_id
    Salidaitinerary_statusgenerations_left_this_year
    Pro
  • get_pro_linkEnlace del Pro · solo lectura
    Devuelve el enlace para suscribirse al Pro.
    Salidaplanpro_url
    Gratis · Pro
  • propose_changeProponer un cambio
    Pide un cambio por el chat del viaje y muestra lo que sale y lo que entra.
    Entradatrip_idrequest
    Salidasummarypreviewchoicescan_apply
    Pro
  • apply_changeAplicar el cambio
    Aplica el cambio propuesto, con las elecciones de la persona.
    Entradatrip_idchoices?
    Salidaapplieddroppedurl
    Pro
  • add_stopsAgregar paradas
    Agrega hasta 20 paradas por llamada, en cualquier día, por el nombre del lugar.Gratis: lugares de nuestro mapa. Pro: también verificados en Google.
    Entradatrip_idstopsbuild_by_hand?
    Salidaresults[]url
    Gratis · Pro
  • update_stopEditar parada
    Edita nombre, horario, duración o nota de una parada.
    Entradatrip_idstop_idtitle?time?duration_min?note?
    Salidachangedfollowing_stops_moved
    Gratis · Pro
  • move_stopMover parada
    Mueve la parada dentro del día o a otro día.
    Entradatrip_idstop_idto_day?to_position?
    Salidachangedmoved_to_day
    Gratis · Pro
  • remove_stopsQuitar paradas
    Quita paradas (se pueden recuperar en la app).
    Entradatrip_idstop_ids
    Salidaresults[]
    Gratis · Pro
  • add_bookingAgregar reserva
    Guarda una reserva que la persona ya tiene (vuelo, hotel, entrada, tren, auto) en la Bóveda y en las reservas del viaje; tren, auto, vuelo entre ciudades y entrada aparecen en la parada del día.
    Entradatrip_idtypetitle?confirmation_code?airline?flight_number?from?to?direction?start_datestart_time?end_date?end_time?place?address?city?names?details?
    Salidabooking_idin_trip_bookingsstopvault_url
    Pro
  • next_stopPróxima parada · solo lectura
    La parada de ahora y la siguiente, por la hora local del viaje (antes del viaje, la primera parada).
    Entradatrip_id
    Salidanownextphase
    Gratis · Pro
  • route_to_nextTrayecto a la siguiente · solo lectura
    Cómo llegar a la próxima parada: desde dónde, el modo, los minutos, la hora de salir y, en transporte público, línea y estaciones.
    Entradatrip_id
    Salidaroutenote
    Gratis · Pro
  • buddy_statusCómo va el viaje · solo lectura
    Antes, durante o después, el día de hoy, lo que ya pasó, lo que falta, qué reservar antes y lo que pasó sin marcar.
    Entradatrip_id
    Salidaphaseday_numberleft_todayto_book_in_advancemissed
    Gratis · Pro
  • share_linkEnlace para compartir
    El enlace público del itinerario, solo lectura (sin la Bóveda), creado la primera vez.
    Entradatrip_id
    Salidashare_url
    Gratis · Pro
  • undoDeshacer
    Deshace el último cambio del chat (hasta 30 minutos) o recupera paradas quitadas.
    Entradatrip_idstop_ids?
    Salidaundoneresults[]removed_stops
    Gratis · Pro

Reglas que el servidor cumple

Solo lugares reales
Armamos el itinerario con lugares reales. La parada que el agente pone por nombre se busca en nuestro mapa (en el Pro, también en Google); lo que no encuentre entra como parada de la persona, marcada "sin verificar".
Marcado
Cada parada que el agente pone o cambia muestra su nombre en la app ("Agregada por Claude").
Solo tus viajes
El token lee y edita los viajes de quien inició sesión. Nada de documentos de la Bóveda, nada de pagos.
El texto se queda con nosotros
Lo que manda el agente queda en nuestra base de datos, como lo que escribe la persona, y nunca va a la herramienta de análisis.
Errores que el agente puede transmitir
El error viene en inglés para el agente y, junto, message_for_user en el idioma de la cuenta. Cuando la app preguntaría algo (una ciudad con dos nombres iguales, fechas que faltan), la herramienta devuelve las preguntas y el enlace para terminar en la app.
Los mismos controles que la app
Cada herramienta corre la misma acción que corre la app, con las mismas reglas de acceso y los mismos límites de IA.

Gratis y Pro

Gratis

  • Crea viajes vacíos
  • Lee viajes y días
  • Agrega, edita, mueve y quita paradas, con lugares de nuestro mapa

Pro

Pro anual, con pago único por un año

  • Todo lo del gratis
  • Arma itinerarios desde el agente: 6 por año
  • Cambia el viaje por el chat (propose_change, apply_change)
  • Lugares verificados en Google

En la cuenta gratis, las herramientas del Pro responden con el enlace para suscribirse (get_pro_link). En la app, armar el itinerario funciona como siempre.

Acceso

Tucanoo es su propio servidor de autorización OAuth 2.1. Un cliente con registro dinámico se conecta solo con la dirección.

Servidor
https://tucanoo.app/mcpStreamable HTTP, sin sesión, respuestas en JSON. Sin token: 401 que apunta al metadata del recurso.
Recurso protegido
/.well-known/oauth-protected-resource/mcpRFC 9728
Servidor de autorización
/.well-known/oauth-authorization-serverRFC 8414
Registro
/oauth/registerDinámico (RFC 7591). Cliente público; redirect https, o http en localhost.
Autorización
/oauth/authorizePKCE S256 obligatorio. La persona entra con Google o Apple y toca Permitir.
Token
/oauth/tokenAcceso: 1 hora. Refresh: 90 días, cambiado en cada uso.
Revocar
/oauth/revokeRFC 7009. Desconectar en la app también revoca.
Alcance
tripsUn solo alcance: los viajes de la persona.

¿El agente no abre el inicio de sesión en el navegador?

  1. 1En Tucanoo, abre Tú y luego Asistentes conectados.
  2. 2Toca Generar código: 6 números, valen 10 minutos y una vez.
  3. 3Escríbelo en la pantalla de conexión y toca Permitir.

Conecta tu cuenta.

Entra y abre Asistentes conectados: la dirección del servidor, el código de vinculación y los agentes conectados están ahí.

Conectar mi cuenta

Gratis para empezar. Entra con Google o Apple.

Términos · Privacidad ·

TUCANOO VENTURES DESENVOLVIMENTO DE SOFTWARE CUSTOMIZAVEL LTDA · CNPJ 69.619.489/0001-80 · Rua Visconde de Pirajá, 414, sala 718, Ipanema, Rio de Janeiro, RJ, CEP 22410-002