Timergy MCP Server

@timergy/mcp

Servidor MCP para Timergy - o aplicativo de enquetes de agendamento. Crie enquetes, vote em horários e finalize reuniões diretamente de agentes de IA como Claude, ChatGPT e Gemini.

Nenhuma autenticação necessária. Funciona imediatamente.

O que é o Timergy?

Timergy é um serviço de enquetes de agendamento (como Doodle ou When2Meet). Você cria uma enquete com opções de horários, compartilha com os participantes, todos votam em sua disponibilidade e você escolhe o melhor horário.

Início Rápido

Claude Desktop / Claude Code

Adicione à sua configuração MCP (~/.claude/claude_desktop_config.json ou projeto .mcp.json):

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

Então basta perguntar:

"Crie uma enquete para jantar na próxima sexta ou sábado à noite"

Smithery (Remoto, sem instalação)

smithery mcp add timergy/timergy

Ou conecte-se diretamente via https://timergy--timergy.run.tools

Outros Clientes MCP

Qualquer cliente compatível com MCP pode usar este servidor. Suporta stdio (local) e HTTP Streamable (remoto em https://api.timergy.com/mcp).

Ferramentas

create_poll

Crie uma enquete de agendamento com opções de horários.

Parâmetro	Tipo	Obrigatório	Descrição
title	string	sim	Título da enquete
options	array	sim	Intervalos de tempo ({start, end} em ISO 8601 com fuso horário)
description	string	não	Descrição da enquete
deadline	string	não	Prazo de votação (ISO 8601)
location	string	não	Local do evento
creatorName	string	não	Nome exibido como criador da enquete

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

Retorna: URL da enquete (para compartilhar), senha (para acesso administrativo), IDs das opções.

get_poll

Obtenha detalhes da enquete e opções de horários (sem votos). Use isso para recuperar IDs de opções antes de votar ou finalizar.

Parâmetro	Tipo	Obrigatório	Descrição
pollId	string	sim	UUID da enquete

"Show me the details of poll abc-123"

vote_on_poll

Envie votos em uma enquete. Cada voto mapeia um horário para sim/talvez/não.

Parâmetro	Tipo	Obrigatório	Descrição
pollId	string	sim	UUID da enquete
voterName	string	sim	Nome do votante
voterEmail	string	não	E-mail do votante (para notificações)
votes	array	sim	{optionId, availability} onde a disponibilidade é yes/maybe/no

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

get_results

Veja quem votou e quais horários são mais populares.

Parâmetro	Tipo	Obrigatório	Descrição
pollId	string	sim	UUID da enquete

"Show me the results for poll abc-123"

finalize_poll

Confirme o horário vencedor. Notifica os participantes que forneceram e-mail.

Parâmetro	Tipo	Obrigatório	Descrição
pollId	string	sim	UUID da enquete
optionId	string	sim	UUID do horário vencedor
passphrase	string	não	Senha administrativa (lembrada automaticamente do create_poll)

"Finalize poll abc-123 with the Monday slot"

Fluxo de Trabalho

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

A senha da etapa 1 é lembrada automaticamente para a etapa 4 na mesma sessão.

API REST

O servidor MCP chama a Open API do Timergy internamente. Você também pode usar a API diretamente:

Método	Endpoint	Descrição
POST	/api/open/polls	Criar uma enquete
GET	/api/open/polls/:id	Obter detalhes da enquete
GET	/api/open/polls/:id/options	Obter horários
GET	/api/open/polls/:id/results	Obter resultados de votação
POST	/api/open/polls/:id/vote	Enviar votos
POST	/api/open/polls/:id/admin-token	Obter token administrativo
POST	/api/open/polls/:id/finalize	Finalizar enquete

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

Especificação OpenAPI: https://api.timergy.com/api/open/openapi.json

Configuração

Variável de Ambiente	Padrão	Descrição
TIMERGY_API_URL	https://api.timergy.com	URL base da API

Para desenvolvimento local:

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

Limites de Taxa

Ação	Limite
Criar enquete	5 por hora
Votar	20 por minuto
Obter enquete/resultados	60 por minuto
Token administrativo	5 por 10 minutos
Finalizar	3 por hora

Licença

MIT