Documentación

Tiska para desarrolladores y agentes de IA

Última actualización: 29 de agosto de 2026

Tiska es el software de agenda y turnos de los negocios de belleza de Argentina (usetiska.com). Esta página lista todo lo que Tiska publica en formato legible por máquinas: el servidor MCP, el archivo llms.txt, la negociación de contenido en markdown, los sitemaps y la forma de las URLs públicas.

Todo lo que hay acá es público: no hace falta clave, token ni registro. Las consultas son de solo lectura; la única operación que escribe es reservar un turno, y hace exactamente lo mismo que el formulario de la página del negocio.

1. Servidor MCP

Tiska expone un servidor Model Context Protocol con transporte Streamable HTTP, para que Claude, ChatGPT y cualquier agente compatible consulten los datos públicos de los negocios sin scrapear HTML.

Endpoint	`https://usetiska.com/mcp`
Transporte	Streamable HTTP (JSON-RPC 2.0 por `POST`)
Versión de protocolo	`2025-06-18`
Autenticación	Ninguna (datos públicos)
Estado	Sin sesión (stateless)

Configuración

{
  "mcpServers": {
    "tiska": {
      "type": "http",
      "url": "https://usetiska.com/mcp"
    }
  }
}

En Claude Code: claude mcp add --transport http tiska https://usetiska.com/mcp

Tools disponibles

Tool	Parámetros	Devuelve
`list_businesses`	`query` (opcional), `limit` (opcional)	Negocios publicados con Tiska: slug y URL pública.
`get_business`	`slug`, `local` (opcional)	Nombre, descripción, dirección, servicios con precio y duración, equipo, horarios de atención, reseñas y URL para reservar.
`get_availability`	`slug`, `date` (`YYYY-MM-DD`), `local` (opcional)	Horario de atención de ese día y los bloques ya ocupados. No calcula los huecos libres: la disponibilidad real depende del servicio, del profesional y de las opciones elegidas, y la resuelve el formulario de reserva.
`create_appointment`	`slug`, `service_id`, `date`, `time`, `first_name`, `last_name`, `phone`, `email`; opcionales `staff_id`, `local`, `note`	Reserva un turno real. Devuelve el id del turno, el resumen y, si el negocio pide seña, el link de pago de Mercado Pago.
`about_tiska`	—	Qué es Tiska, para quién, planes y precios vigentes.

Reservar

create_appointment llama exactamente al mismo procedimiento que el formulario web, así que hereda sus reglas: tope de reservas por minuto, validación de teléfono y email, verificación de que el servicio y el profesional sean de ese negocio, control de superposición y cálculo de la seña en el servidor. Además chequea que la hora caiga dentro del horario de atención.

El email es obligatorio (en el formulario web no lo es). Ahí le llega a la persona la confirmación con los links para modificar o cancelar el turno: es la garantía de que hay alguien real detrás de la reserva y de que se entera de lo que se agendó en su nombre.
El turno queda marcado con la nota [Reservado por un asistente de IA], para que el negocio sepa de dónde vino.
Si el negocio pide seña, el turno se crea con el pago pendiente y la respuesta trae un link_de_pago de Mercado Pago. No queda firme hasta que se pague.
Modificar y cancelar no se hacen por MCP: van por los links del mail de confirmación, que son los que aplican la política de cancelación de cada negocio.
Reservar implica aceptar los Términos y Condiciones. Mostráselos a la persona antes de llamar a la tool.

Antes de reservar, pedí get_business para obtener el id del servicio y get_availability para elegir un horario libre.

Ejemplo

curl -s https://usetiska.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

2. llms.txt

usetiska.com/llms.txt, en el formato de llmstxt.org: resumen del producto, precios, cuándo conviene usar Tiska y el índice completo de páginas y artículos.

3. Contenido en markdown

La home responde en markdown si se lo pedís por Accept, en la misma URL (acceptmarkdown.com):

curl -s -H "Accept: text/markdown" https://usetiska.com/

Devuelve Content-Type: text/markdown; charset=utf-8 y Vary: Accept. Con cualquier otro Accept, la misma URL devuelve el HTML de siempre.

4. Sitemaps y robots

/sitemap.xml — páginas del sitio (landings, blog, legales).
/sitemap-negocios.xml — página pública de cada negocio, generada en vivo.
/robots.txt — sin restricciones para agentes; sólo /api/ queda afuera.

5. URLs públicas de los negocios

https://usetiska.com/<negocio> — página pública: servicios, precios, horarios, equipo, reseñas y reserva.
https://usetiska.com/<negocio>/<sucursal> — una sucursal puntual de una marca con varios locales.
Si el negocio cambia de nombre, la URL vieja redirige con un 301.
Un slug que no existe devuelve un 404 real, no una página vacía con estado 200.

Las páginas de negocios se sirven con noindex a propósito: existen para los clientes de cada salón, no para posicionar en buscadores.

6. Lo que no hay

No hay API REST pública ni claves de API: lo que se puede leer, se lee por MCP o por las páginas públicas.
No se accede a datos privados de un negocio (clientes, caja, comisiones, teléfonos y emails del equipo): eso vive detrás de la cuenta del dueño.
No se cancelan ni se reprograman turnos por MCP: eso va por los links del mail de confirmación, que aplican la política de cada negocio.

7. Contacto

Dudas, integraciones o algo que falte en esta página: hola@usetiska.com.