Iterpec
API Reference
search
⚡

Conecte sua IA à Iterpec em 2 minutos

Plugue nosso servidor MCP em 20+ clientes de IA (Claude, Cursor, Windsurf, Cline, Zed, ChatGPT, Lovable, n8n…) e seu agente passa a consultar endpoints, montar payloads, ler o changelog e seguir as regras de reserva sozinho. Sem ticket, sem reunião de onboarding. Copie a configuração, cole no seu cliente, comece a integrar.

!
Pré-requisito — virar cliente Iterpec

Para usar MCP, Skills e Vibecoding em produção (chamar Search, GetBookingConditions, DoBooking de verdade) você precisa de 2 credenciais:

  • Bearer Token do MCP — autentica seu agente de IA contra https://iterpec.com/api/mcp.
  • Username + Password da API Iterpec — enviados no body de cada chamada produtiva (Credential.Username / Credential.Password). Sem eles, os endpoints de Search/Booking respondem 401.

Ambas são liberadas só após preencher o formulário comercial e assinar contrato com a Iterpec. Antes disso, o MCP responde apenas documentação (schema, exemplos, changelog) — útil para prototipar, mas sem acesso ao inventário real.

Endpoint
POST https://iterpec.com/api/mcp
Transport: Streamable HTTP (MCP 2025-06-18). Apenas POST é aceito.
Autenticação (2 camadas)
Authorization: Bearer <imcp.xxx.yyy>
1) Bearer no header — autentica o MCP.
2) Username + Password no body — autenticam a API de produção.
Solicite os dois a comercial@iterpec.com após assinar contrato. Nunca comite no código — use variável de ambiente / secret manager.

Tools disponíveis

NomeDescriçãoParâmetros
list_endpointsLista grupos e endpoints da API (com filtro opcional por produto ou termo).product?, search?
get_endpointDetalhes completos de um endpoint: parâmetros, exemplo curl e resposta.endpointId
get_changelogNotas de release da API Cangooroo, ordem cronológica decrescente.service?, since?, limit?
get_referenceFluxo de reserva, status, ReToken e convenções de data/UTC.topic ("booking_statuses" | "retoken" | "date_conventions" | "all")

Teste rápido (tools/list)

Faça um handshake JSON-RPC para listar as tools disponíveis. Substitua SEU_TOKEN_AQUI.

curl --location 'https://iterpec.com/api/mcp' \
  --header 'Authorization: Bearer SEU_SHARED_SECRET_AQUI' \
  --header 'Accept: application/json, text/event-stream' \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Configuração por cliente

20 clientes MCP suportados. Clique no logo para ver a configuração específica.

Claude DesktopConfiguração para Claude Desktop · App nativo Anthropic
{
  "mcpServers": {
    "iterpec-api": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://iterpec.com/api/mcp",
        "--header", "Authorization:${ITERPEC_MCP_TOKEN}"
      ],
      "env": { "ITERPEC_MCP_TOKEN": "Bearer SEU_TOKEN_AQUI" }
    }
  }
}
Notas: o servidor exige o header Accept: application/json, text/event-stream em todas as requisições POST (padrão MCP Streamable HTTP). Apenas o método POST é aceito; GET/DELETE retornam 405. O shared secret é validado por comparação direta — rotacione via Lovable Cloud quando necessário.