Traveler Jyoti Content

Conteúdo de viagem econômica em primeira mão para viajantes indianos. Pesquise, navegue e leia conteúdo por meio de ferramentas MCP, com cada resposta retornando uma URL canônica para citação.

Documentação

Meus guias de viagem, programaticamente.

Todo guia em travelerjyoti.com também está disponível através do Model Context Protocol — um único endpoint que assistentes de IA (Claude Desktop, Claude Code, Cursor, GPTs personalizados) podem chamar para pesquisar, navegar e ler conteúdo de viagem em primeira mão, da Índia à Europa e Ásia. Público, somente leitura, gratuito, sem cadastro.

Endpoint

https://mcp.travelerjyoti.com/mcp

Conecte-se em 60 segundos → Explore todos os 16 guias

Público somente leitura <5ms cold start Cloudflare edge (270+ POPs) Protocolo 2025-06-18

O que é isso, em um parágrafo?

MCP é um protocolo JSON-RPC 2.0 que a Anthropic lançou no final de 2024 e que agora foi adotado por OpenAI, Google, Cursor, Continue e a maioria dos principais clientes de IA. Ele permite que um assistente de IA acesse seus dados por meio de ferramentas estruturadas, em vez de adivinhar suas URLs.

Quando um usuário pergunta ao Claude "encontre um guia da Suíça sobre o Swiss Travel Pass", o cliente verifica seus servidores MCP conectados, vê que o meu oferece uma ferramenta search_guides, a chama e envia o JSON de volta ao modelo. O modelo responde com base no meu conteúdo real — com uma citação de volta para travelerjyoti.com.

Essa última parte é o ponto principal: toda resposta inclui um canonical_url para que o assistente de IA cite a fonte. Gera atribuição. Gera tráfego. Resolve o problema de "a IA resumiu meu conteúdo sem me creditar".

As três ferramentas

Feito para consultas de viagem

Cada ferramenta retorna JSON. Cada resultado inclui uma URL canônica. A descrição de cada ferramenta é escrita manualmente para que o modelo escolha a certa sem que você precise ajustar.

list_guides

O índice de todos os 16 guias com metadados — título, país, duração, orçamento, resumo, URL da imagem, datas, URL canônica. A primeira chamada que a maioria dos clientes faz.

Parâmetros

  • country?: string — filtro opcional

Veja um exemplo de resposta

{
  "count": 16,
  "guides": [
    {
      "slug": "swiss-travel-pass-whats-free",
      "title": "What's 100% Free with the Swiss Travel Pass",
      "country": "Switzerland",
      "duration": "3 hours",
      "budget": "Free with pass",
      "canonical_url": "https://travelerjyoti.com/destinations/swiss-travel-pass-whats-free/",
      "updatedAt": "2026-05-19"
    },
    …
  ]
}

get_guide

O Markdown limpo e completo de um guia, além de suas FAQs e frontmatter completo. Use quando você já souber o slug, ou depois que search_guides identificar a melhor correspondência.

Parâmetros

  • slug: string — obrigatório

Veja um exemplo de resposta

{
  "slug": "mount-pilatus-free-cap",
  "title": "How to Get a Free Pilatus Cap…",
  "country": "Switzerland",
  "canonical_url": "https://travelerjyoti.com/destinations/mount-pilatus-free-cap/",
  "body": "# Mount Pilatus Free Cap\n\nThis is one of those…",
  "faqs": [
    { "question": "…", "answer": "…" }
  ]
}

search_guides

Busca com pontuação por palavras-chave em título, corpo e FAQs. Retorna resultados classificados com um trecho mostrando por que cada um foi pontuado — dá ao modelo informações suficientes para decidir qual ler por completo.

Parâmetros

  • query: string — obrigatório
  • limit?: number — mínimo 1, padrão 5

Veja um exemplo de resposta

{
  "query": "Swiss Travel Pass",
  "matches": 3,
  "results": [
    {
      "slug": "swiss-travel-pass-whats-free",
      "score": 57,
      "snippet": "…every public train, bus, tram…",
      "canonical_url": "https://travelerjyoti.com/destinations/swiss-travel-pass-whats-free/"
    },
    …
  ]
}

Conexão rápida

Conecte-se em 60 segundos

Escolha seu cliente. Cole. Pronto.

Claude Code

Local para um projeto

claude mcp add travelerjyoti --transport http https://mcp.travelerjyoti.com/mcp

Claude Desktop

Adicione ao claude_desktop_config.json

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

Cursor

Configurações → Servidores MCP

{
  "travelerjyoti": {
    "type": "streamable-http",
    "url": "https://mcp.travelerjyoti.com/mcp"
  }
}

curl (protocolo bruto)

Para depuração

curl -X POST https://mcp.travelerjyoti.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_guides",
                 "arguments":{"query":"Swiss Travel Pass"}}}'

Para outros clientes (Continue, GPTs personalizados, LangChain, etc.) — aponte-os para o mesmo endpoint com transporte Streamable HTTP. Metadados de descoberta automática em /.well-known/mcp.json.

FAQ

Perguntas frequentes

É gratuito? Preciso de uma chave de API?

Sim, gratuito. Sem chave, sem cadastro, sem cota. Acesso público somente leitura. Eu cubro os custos da Cloudflare porque o servidor MCP não tem taxas de saída de dados dentro da rede da Cloudflare — os guias são empacotados no Worker, então não há serviço upstream para pagar.

Quão atualizados são os dados?

Os guias são empacotados no Worker no momento da implantação. Sempre que publico um novo guia em travelerjyoti.com, um único npm run deploy reimplanta o servidor MCP com o novo conteúdo. A latência entre a publicação e a disponibilidade no MCP geralmente é inferior a 5 minutos.

Qual é o limite de taxa?

O limite do plano gratuito da Cloudflare para Workers é de 100.000 solicitações/dia. Publicarei um limite real se o uso chegar perto disso — por enquanto, sem limite imposto. Se você planeja uso intenso (mais de alguns milhares de chamadas por dia), envie-me um e-mail e conversamos.

Posso usar o conteúdo deste MCP no meu produto?

Citações curtas com atribuição + link de volta para a URL canônica são bem-vindas. Reprodução de página inteira não é permitida (veja Termos). A resposta do servidor MCP em si inclui um canonical_url em cada resultado, justamente para que a atribuição esteja a um campo de distância.

Como isso difere do /llms-full.txt?

/llms-full.txt é uma busca única — qualquer mecanismo de IA ingere todo o arquivo de uma vez, sem necessidade de integração. O MCP é interativo — os clientes chamam ferramentas específicas com argumentos específicos e recebem JSON estruturado de volta. Ambos existem porque atendem públicos diferentes: llms-full é para mecanismos de busca/resposta que rastreiam, MCP é para assistentes que conversam.

Por que isso não está no diretório oficial de servidores MCP ainda?

Enviado. O mcpservers.org leva alguns dias para revisar. Quando listado, aparecerá na categoria 'Travel' (uma categoria quase vazia no momento).

Construí para mim, tornei público.

Se você construir algo com este servidor, adoraria saber. Envie-me um e-mail, marque-me ou apenas deixe um comentário no canal do YouTube.

Diga olá JSON de descoberta Sobre Jyoti