Servidor MCP da iscabox

Encontrar e reservar um guia de pesca no Brasil de dentro de qualquer assistente que fale MCP: o destino para o peixe, os guias com barco e as pousadas de cada lugar, o orçamento e o pedido de reserva. Junto vêm os dados de pesca da iscabox que ajudam a escolher: espécies, locais, rios, marés e solunar, em português.

É público e gratuito: sem chave, sem cadastro, sem OAuth. A mesma URL serve todos os usuários.

Conexão

https://www.iscabox.com/mcp

Transporte Streamable HTTP, sem sessão: cada POST é atendido por uma instância própria e a resposta volta como JSON. Não há autenticação, então não existe chave para rotacionar.

No Claude, adicione como conector personalizado com essa URL (Configurações, Conectores). No ChatGPT, a iscabox está no diretório de apps. No Cursor, um clique:

Adicionar ao Cursor

Em clientes que leem um arquivo de configuração:

{
  "mcpServers": {
    "iscabox": {
      "url": "https://www.iscabox.com/mcp"
    }
  }
}

Ferramentas

São 12: onze só leem, e a única que escreve é a request_booking, que faz o pedido de reserva.

search_destinations

Destinos de pesca para um peixe, uma região ou perto da cidade de onde o pescador sai: peixes de cada lugar, distância, guias cadastrados e se a piracema fecha a pesca nas datas.

find_guides

Os guias com barco e as pousadas cadastrados para um lugar: peixes, se levam equipamento, preço da diária e, com datas, o total da viagem e a parte paga agora. Sempre traz o link do pedido no site.

get_guide

O perfil público de um guia: fotos, barcos (tipo, tamanho, motor, lugares), os lugares onde atende com o preço e os peixes. Sem telefone, email ou Instagram.

quote_trip

Guia, datas e pessoas: o total da viagem, a parte paga agora pela iscabox, o restante no dia, o último dia para cancelar e o prazo do guia.

request_booking

Faz o pedido de reserva com o WhatsApp do pescador e devolve o link da página de pagamento. Sem guia escolhido, a equipe da iscabox procura um. É a única ferramenta que escreve.

get_booking_status

Em que pé está uma reserva: aguardando o pagamento, aguardando o guia (com o prazo), confirmada, cancelada ou reembolsada.

search_species

Busca espécies por nome, apelido regional ou tipo de água.

get_species

Guia completo de uma espécie: onde vive, o que come, tamanho, melhor época e como pescar.

search_locations

Busca locais por nome, cidade, estado, espécie ou proximidade de uma coordenada.

get_location

Guia de um local: espécies, pontos de pesca, estrutura, melhor época e como chegar.

get_river

Por onde um rio passa: municípios na ordem do curso e os pontos de pesca de cada um.

get_fishing_conditions

Marés, fase da lua, janelas solunares, temperatura da água e previsão para 35 portos. Aceita uma data.

Como funciona a reserva

  • O total da viagem vem no orçamento (quote_trip) e aparece na página da reserva, antes do pagamento.
  • O pescador paga uma parte do total agora, pela iscabox, na página da reserva (cartão ou Pix), e o restante direto ao guia no dia. Esse pagamento dá mais segurança ao pescador e ao guia, e volta inteiro se o guia não aceitar.
  • O pedido chega ao guia depois desse pagamento. Ele tem 24 horas para aceitar (6 horas quando a pescaria é hoje ou amanhã); se não aceitar, o pescador recebe tudo de volta.
  • O pescador pode cancelar até 2 dias antes da pescaria e recebe tudo de volta.
  • Os contatos do guia e do pescador são trocados pelo WhatsApp depois que o guia aceita.

Nenhuma ferramenta recebe dados de pagamento nem devolve o contato de um guia: o assistente entrega o link da reserva, e o pagamento acontece só na página da iscabox. Um lugar ainda sem guia cadastrado continua aceitando pedido: a equipe procura um guia e responde pelo WhatsApp.

Uma chamada

curl -X POST https://www.iscabox.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_destinations",
      "arguments": { "fish": "tucunaré", "near": "Belo Horizonte", "limit": 5 }
    }
  }'

Limites

  • 30 chamadas por minuto e 400 por dia por IP de origem
  • 200 por minuto e 2.000 por dia no total do servidor
  • request_booking: 3 pedidos a cada 10 minutos por IP e200 por dia no total, o mesmo limite do pedido feito no site
  • Só tools/call consome a cota diária. Handshakes (initialize, tools/list) não consomem

Os limites por IP são frouxos de propósito, porque um assistente costuma sair por um endereço compartilhado por muita gente. Um 429 traz Retry-After e, em error.data, os campos retryAfter, limit e scope, que dizem qual limite estourou, para o agente saber se vale esperar ou recuar.

Para modelos de linguagem

Um resumo do site em texto, para quem lê sem o MCP: https://www.iscabox.com/llms.txt.

Não é um agente?

Para uma pessoa, o caminho é a busca de guias de pesca. É guia, piloteiro ou tem pousada? Veja como receber reservas.

Condições de uso

Uso livre, inclusive comercial, desde que a informação seja atribuída à iscabox e os links sejam preservados. Sem garantia de disponibilidade: se você for construir algo que dependa disso em produção, nos avise para combinarmos limites maiores.

Não é permitido copiar o acervo em massa, revender os dados, usá-los para treinar modelos ou montar um catálogo concorrente. Regras oficiais de pesca e fotos de terceiros seguem os termos das fontes. Toda resposta traz o campo license com estes termos; o texto completo está nos termos de uso dos dados.