Timergy MCP Server

@timergy/mcp

Servidor MCP para Timergy, la aplicación de encuestas de programación. Crea encuestas, vota en franjas horarias y finaliza reuniones directamente desde agentes de IA como Claude, ChatGPT y Gemini.

No se requiere autenticación. Funciona directamente sin configuración.

¿Qué es Timergy?

Timergy es un servicio de encuestas de programación (como Doodle o When2Meet). Creas una encuesta con opciones de franjas horarias, la compartes con los participantes, todos votan sobre su disponibilidad y eliges la mejor hora.

Inicio Rápido

Claude Desktop / Claude Code

Añade a tu configuración de MCP (~/.claude/claude_desktop_config.json o el proyecto .mcp.json):

{
  "mcpServers": {
    "timergy": {
      "command": "npx",
      "args": ["@timergy/mcp"]
    }
  }
}

Luego simplemente pregunta:

"Crea una encuesta para cenar el viernes o el sábado por la noche"

Smithery (Remoto, sin instalación)

smithery mcp add timergy/timergy

O conéctate directamente vía https://timergy--timergy.run.tools

Otros Clientes MCP

Cualquier cliente compatible con MCP puede usar este servidor. Soporta stdio (local) y HTTP Streamable (remoto en https://api.timergy.com/mcp).

Herramientas

create_poll

Crea una encuesta de programación con opciones de franjas horarias.

Parámetro	Tipo	Obligatorio	Descripción
title	string	sí	Título de la encuesta
options	array	sí	Franjas horarias ({start, end} en ISO 8601 con zona horaria)
description	string	no	Descripción de la encuesta
deadline	string	no	Fecha límite de votación (ISO 8601)
location	string	no	Ubicación del evento
creatorName	string	no	Nombre mostrado como creador de la encuesta

"Create a poll called 'Team Lunch' with slots on Monday 12-13 and Tuesday 12-13"

Devuelve: URL de la encuesta (para compartir), frase de acceso (para acceso de administrador), IDs de opciones.

get_poll

Obtén los detalles de la encuesta y las opciones de franjas horarias (sin votos). Usa esto para recuperar los IDs de opciones antes de votar o finalizar.

Parámetro	Tipo	Obligatorio	Descripción
pollId	string	sí	UUID de la encuesta

"Show me the details of poll abc-123"

vote_on_poll

Envía votos en una encuesta. Cada voto asigna una franja horaria a sí/no/tal vez.

Parámetro	Tipo	Obligatorio	Descripción
pollId	string	sí	UUID de la encuesta
voterName	string	sí	Nombre del votante
voterEmail	string	no	Correo electrónico del votante (para notificaciones)
votes	array	sí	{optionId, availability} donde la disponibilidad es yes/maybe/no

"Vote 'yes' for Monday and 'no' for Tuesday on poll abc-123 as Max"

get_results

Ve quién votó y qué franjas horarias son las más populares.

Parámetro	Tipo	Obligatorio	Descripción
pollId	string	sí	UUID de la encuesta

"Show me the results for poll abc-123"

finalize_poll

Fija la franja horaria ganadora. Notifica a los participantes que proporcionaron un correo electrónico.

Parámetro	Tipo	Obligatorio	Descripción
pollId	string	sí	UUID de la encuesta
optionId	string	sí	UUID de la franja horaria ganadora
passphrase	string	no	Frase de acceso de administrador (se recuerda automáticamente de create_poll)

"Finalize poll abc-123 with the Monday slot"

Flujo de trabajo

1. create_poll  ->  Get poll URL + passphrase
2. Share URL    ->  Send to participants
3. get_results  ->  See who voted yes/maybe/no
4. finalize_poll -> Pick the best time, lock it in

La frase de acceso del paso 1 se recuerda automáticamente para el paso 4 dentro de la misma sesión.

API REST

El servidor MCP llama a la API abierta de Timergy internamente. También puedes usar la API directamente:

Método	Endpoint	Descripción
POST	/api/open/polls	Crear una encuesta
GET	/api/open/polls/:id	Obtener detalles de la encuesta
GET	/api/open/polls/:id/options	Obtener franjas horarias
GET	/api/open/polls/:id/results	Obtener resultados de votación
POST	/api/open/polls/:id/vote	Enviar votos
POST	/api/open/polls/:id/admin-token	Obtener token de administrador
POST	/api/open/polls/:id/finalize	Finalizar encuesta

URL base: https://api.timergy.com

Especificación OpenAPI: https://api.timergy.com/api/open/openapi.json

Configuración

Variable de entorno	Predeterminado	Descripción
TIMERGY_API_URL	https://api.timergy.com	URL base de la API

Para desarrollo local:

{
  "mcpServers": {
    "timergy": {
      "command": "npx",
      "args": ["@timergy/mcp"],
      "env": { "TIMERGY_API_URL": "http://localhost:4000" }
    }
  }
}

Límites de tasa

Acción	Límite
Crear encuesta	5 por hora
Votar	20 por minuto
Obtener encuesta/resultados	60 por minuto
Token de administrador	5 por 10 minutos
Finalizar	3 por hora

Licencia

MIT