tickadoo

npx add-mcp 'https://mcp.tickadoo.com/mcp'

Servidor MCP tickadoo

@tickadoo/mcp-server é o ponto de entrada stdio local para o MCP tickadoo. Desde a v2.0.0, é uma ponte leve para o servidor remoto canônico em:

https://mcp.tickadoo.com/mcp

Conector Meta Muse

O pacote de envio de diretório e o breve resumo que o Muse deve buscar estão em connectors/muse/. Resumo estável:

https://raw.githubusercontent.com/tickadoo/tickadoo-mcp/main/connectors/muse/muse.md

Envie em muse.ai/platform usando connectors/muse/SUBMISSION.md. Sem chave de API. A descoberta é este servidor MCP; o checkout permanece em tickadoo.com.

Plugins de Agente 1.0

Este repositório também é um pacote portátil de Plugins de Agente 1.0.0. Clientes compatíveis descobrem a raiz plugin.json, os sete fluxos de trabalho em skills/ e a configuração Streamable HTTP sem credenciais em mcp.json. A ingestão atual do marketplace Codex usa o adaptador paralelo .codex-plugin/plugin.json; o manifesto raiz portátil permanece a fonte de verdade neutra em relação a fornecedores.

Execute npm run test:plugin para validar o pacote contra os esquemas oficiais fornecidos e suas verificações de contenção, descoberta, transporte e segurança de segredos. O mesmo comando verifica o conteúdo exato do tarball npm e o corpus de aceitação neutro em relação a fornecedores em evals/agent-plugin-scenarios.json. Consulte docs/agent-plugins.md para a decisão de arquitetura, evidências de compatibilidade, processo de atualização/rollback e acompanhamentos.

Sessões da API OpenAI Agents que chamam o MCP público (caminho Book) estão documentadas em docs/openai-agents-api.md. Use https://mcp.tickadoo.com/mcp — o host simples retorna 404.

O pacote não define mais ferramentas, não formata dados de catálogo nem chama um backend tickadoo local. Ele se conecta ao servidor MCP remoto Streamable HTTP e faz proxy de tools/list, tools/call, resources/list, resources/read e ping. O remoto ativo possui a lista de ferramentas, esquemas, resultados e erros.

Nenhuma chave de API é necessária.

Instalação

Use o remoto hospedado diretamente quando seu cliente MCP suportar Streamable HTTP:

{
  "mcpServers": {
    "tickadoo": {
      "url": "https://mcp.tickadoo.com/mcp"
    }
  }
}

Use o pacote npm quando seu cliente MCP precisar de um comando stdio local:

{
  "mcpServers": {
    "tickadoo": {
      "command": "npx",
      "args": ["-y", "@tickadoo/mcp-server"]
    }
  }
}

Use o Gemini CLI:

gemini extensions install https://github.com/tickadoo/tickadoo-mcp

Use o fluxo de marketplace suportado pelo Claude Code:

claude plugin marketplace add tickadoo/tickadoo-mcp
claude plugin install tickadoo@tickadoo-agent-plugins

Configuração

Defina TICKADOO_MCP_URL para apontar a ponte para outro endpoint MCP Streamable HTTP compatível:

TICKADOO_MCP_URL=http://127.0.0.1:8787/mcp npx -y @tickadoo/mcp-server

Aponte TICKADOO_MCP_URL apenas para endpoints em que você confia: a ponte encaminha seus argumentos de ferramenta (nomes de cidades, consultas, IDs de experiência) para o endpoint configurado.

Defina TICKADOO_LOG_LEVEL=none para silenciar os logs de status da ponte no stderr.

Desenvolvimento Local

Use Node.js 22+ e instale Python 3 com um executável python3 no PATH antes de executar as verificações. Os testes de leitura do registro executam o verificador Python do fluxo de trabalho contra fixtures locais; a ponte stdio em si só precisa de Node.js.

python3 --version
npm install
npm run build
npm test

Execute a ponte stdio compilada:

node dist/index.js

Atualize os metadados do registro MCP a partir do remoto ativo:

npm run sync:server-json

Execute o teste de integração ativo opcional:

LIVE=1 npm test

Ferramentas Ativas

A lista atual de ferramentas é fornecida pelo servidor MCP remoto. Visite mcp.tickadoo.com ou execute npm run sync:server-json para atualizar os metadados do registro neste repositório.

Privacidade e Tratamento de Dados

• Nenhuma conta ou chave de API necessária. O servidor é majoritariamente de leitura: ele expõe o catálogo público de experiências da tickadoo (busca, recomendações, disponibilidade, comparação, itinerários) e retorna links de reserva — ele não coleta, armazena nem exige dados pessoais para funcionar.
• O que é enviado: argumentos de ferramenta (por exemplo, um nome de cidade, texto de consulta ou ID de experiência escolhido) são encaminhados ao backend tickadoo para atender à solicitação. A ponte não adiciona rastreamento e não solicita credenciais.
• Serviço de primeira parte. A tickadoo é a operadora do catálogo e do backend; o inventário do fornecedor é apresentado como tickadoo. As reservas são concluídas em tickadoo.com.
• Política completa: tickadoo.com/privacy. Perguntas: support@tickadoo.com.