Utilize a API de transportes com o seu assistente de IA

BusMaps MCP liga o Claude, o ChatGPT, o Codex, o Gemini, o Cursor e outros clientes de IA a percursos, isócronas, partidas, paragens, veículos, geocodificação e informações GTFS. Inicie sessão no BusMaps com email e palavra-passe ou através do Google. Os pedidos utilizam a cobertura e os limites atuais da API da sua conta.

Funciona com

O que é o MCP?

O Model Context Protocol liga assistentes de IA a ferramentas e dados externos. O BusMaps disponibiliza ferramentas de transportes que podem ser chamadas, guias da API, esquemas de resposta e exemplos. O seu assistente pode ler o contrato da interface e fazer pedidos em seu nome. Os pedidos MCP e REST diretos utilizam o mesmo acesso e a mesma quota da conta.

O que o seu agente pode fazer

get_account

Mostra o seu nome de apresentação, plano de API, cobertura permitida e fontes de dados. Não devolve a sua chave de API.

get_gtfs_feeds_catalog

Lista registos GTFS de origem, relatórios de validação, licenças, hashes e ligações de transferência com versão. Os conjuntos de dados melhorados e as exportações personalizadas são pedidos separadamente.

plan_transit_route

Planeia uma viagem entre dois pontos de autocarro, metro, comboio ou elétrico. Devolve opções de percurso com etapas, paragens de embarque e desembarque, horários, transbordos, uma polilinha codificada e horários previstos quando existem dados em direto. O filtro barrierMode pode exigir paragens, viagens ou ambas explicitamente acessíveis em cadeira de rodas.

calculate_transit_isochrone

Calcula as áreas alcançáveis em transportes públicos e a pé a partir de um ponto, ou as áreas a partir das quais é possível chegar a esse ponto até uma hora de chegada. Devolve contornos cumulativos de tempo de viagem, a respetiva área e o número de paragens alcançáveis. Por predefinição, a geometria utiliza anéis codificados com precisão 6; o GeoJSON está disponível mediante pedido.

calculate_transit_isochrone_from_shape

Calcula a mesma alcançabilidade a partir de uma linha ou do limite de uma área com um máximo de 1000 por 1000 metros. Suporta limiares de tempo de viagem, hora de partida ou de chegada, limites de transbordos e opções de percurso a pé.

get_departures

Devolve as partidas programadas e em direto das paragens próximas de um ponto ou de uma paragem específica. O atraso é realtimeDepartureTime menos scheduledDepartureTime. O filtro barrierMode utiliza as mesmas regras estritas de acessibilidade em cadeira de rodas do planeamento de percursos.

find_nearby_stops

Devolve as paragens num raio em torno de um ponto, cada uma com o ID, o nome, as coordenadas e as linhas que a servem.

get_route_timetable

Devolve o horário completo de uma linha: os sentidos, as paragens ordenadas e o horário numa grelha de viagens x paragens. É a ficha de uma linha.

get_service_alerts

Devolve as perturbações atuais do serviço de exatamente uma linha ou um operador. É uma alternativa leve ao carregamento do horário completo da linha quando só são necessários os alertas.

get_trip_schedule

Devolve uma viagem (uma única circulação de um veículo) como lista ordenada de paragens, com horários de chegada e de partida e as regras de embarque GTFS.

get_vehicle_positions_in_area

Devolve um instantâneo das posições atuais dos veículos dentro de um retângulo delimitador, com o ID da linha, as coordenadas, o sentido e a marca temporal. positionType indica se se trata de uma posição GPS real ou estimada; os resultados podem ser filtrados por uma linha ou viagem.

plan_car_route

Devolve percursos de automóvel do serviço OSRM para todo o planeta, com distância, duração, geometria, alternativas e, opcionalmente, instruções passo a passo.

car_distance_matrix

Devolve matrizes de tempo e distância de automóvel entre várias origens e destinos.

plan_pedestrian_route

Devolve um percurso a pé com instruções passo a passo do OSRM para o primeiro e o último troço até uma paragem.

pedestrian_distance_matrix

Devolve uma matriz de tempo e distância a pé entre vários pontos, para que o agente possa comparar que paragem fica mais perto a pé.

nominatim_search

Geocodifica texto livre numa morada postal completa e estruturada em JSON.

nominatim_reverse

Converte coordenadas numa morada postal completa e estruturada em JSON.

Ferramentas com respostas prontas para voz

Estas seis ferramentas chamam os endpoints em direto /compact/v1/* . As respostas JSON, mais pequenas e focadas na resposta, reduzem os tokens das chamadas de ferramentas para modelos de voz, preservando os factos de transporte necessários para respostas faladas. Consulte a documentação dos endpoints prontos para modelos de voz.

compact_plan_transit_route

Devolve até duas viagens compactas estruturalmente distintas, com serviços, paragens, valores programados e em tempo real, acessibilidade e referências a alertas.

compact_get_departures

Devolve partidas compactas, programadas e em tempo real, perto de um ponto ou de uma paragem exata.

compact_find_nearby_stops

Devolve as paragens próximas ordenadas pela distância calculada, com identificadores para pedidos exatos posteriores.

compact_get_route_timetable

Devolve o horário completo de uma linha no formato compacto por colunas.

compact_plan_pedestrian_route

Devolve um resumo do percurso a pé e as principais manobras para orientar o primeiro e o último troço.

compact_nominatim_search

Devolve resultados compactos e estruturados de pesquisa de locais para pesquisas de moradas.

Concebido para ser lido por agentes

Ao ligar-se, o agente lê as instruções, os recursos e os esquemas e, depois, constrói sozinho pedidos corretos.

Instruções ao ligar

O servidor devolve instruções que indicam ao agente por onde deve começar.

busmaps://start-here, busmaps://recipes, busmaps://compact-api

start-here apresenta a visão geral e armadilhas como a ordem das coordenadas. recipes fornece sequências completas de ferramentas para ecrãs habituais. compact-api explica o modelo de resposta compacto, o mapeamento de ferramentas, a verificação em direto e a transição para REST em produção.

busmaps://schema/<tool>, busmaps://example/<tool>

Cada ferramenta de transportes disponibiliza o seu esquema de resposta JSON e um exemplo real abreviado, para o agente conhecer o formato antes da chamada.

build_transit_app, explain_api, explain_compact_api

build_transit_app transforma um pedido num plano de desenvolvimento de aplicação. explain_api descreve a API completa. explain_compact_api lê o contrato compacto e orienta chamadas representativas em direto.

Gerado a partir do contrato

As ferramentas de transportes são geradas a partir do mesmo contrato da API que a documentação, com esquemas de resposta e exemplos correspondentes.

Sem documentação para colar

O agente lê sozinho as ferramentas, os recursos e os prompts, pelo que ninguém tem de colar documentação numa conversa.

Ligar a sua conta BusMaps

URL do servidor: https://mcp.busmaps.com/mcp

Claude / Claude Desktop

  1. Abra as definições dos conectores no Claude ou no Claude Desktop.
  2. Adicione um conector personalizado com o URL do servidor https://mcp.busmaps.com/mcp.
  3. Ligue o servidor e inicie sessão no BusMaps com e-mail e palavra-passe ou através do Google.

A disponibilidade depende do seu plano e das permissões do espaço de trabalho.

ChatGPT

Abra o ChatGPT e escolha + > Add custom MCP server. Introduza o URL do servidor, selecione OAuth e inicie sessão no BusMaps.

Gemini

Na aplicação Web do Gemini, abra Settings > Connected Apps > Custom apps, adicione o URL do servidor e siga os passos de início de sessão no BusMaps. Aplicam-se os requisitos de disponibilidade da Google.

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "busmaps-transit": {
      "type": "http",
      "url": "https://mcp.busmaps.com/mcp"
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "busmaps-transit": {
      "type": "http",
      "url": "https://mcp.busmaps.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http busmaps-transit https://mcp.busmaps.com/mcp

No Claude Code, abra /mcp e autentique o servidor BusMaps no navegador.

Gemini CLI

gemini mcp add busmaps-transit https://mcp.busmaps.com/mcp --transport http

Depois de adicionar o servidor, utilize /mcp auth busmaps-transit no Gemini CLI para concluir o início de sessão no navegador.

Codex (~/.codex/config.toml)

[mcp_servers.busmaps-transit]
url = "https://mcp.busmaps.com/mcp"

Em seguida, autentique-se no Codex. No Codex CLI, execute codex mcp login busmaps-transit e inicie sessão no BusMaps no navegador.

Utilize o URL do servidor no seu cliente de IA. Não é necessário um contentor Docker nem uma instalação local de MCP.

  1. Adicione o URL do servidor nas definições de ligação MCP remota do seu cliente.
  2. Inicie sessão no BusMaps com email e palavra-passe ou através do Google. É necessária uma conta confirmada com acesso ativo à API.
  3. Reveja a aplicação e o acesso pedido e escolha Allow access para regressar ao seu cliente.

O seu cliente pode pedir dados de transportes e ler o seu nome de apresentação, plano de API, cobertura permitida e fontes de dados. Não pode alterar a sua palavra-passe, faturação ou subscrição. A sua palavra-passe e a sua chave de API não são enviadas ao cliente de IA.

Condições de utilização da API · Política de privacidade · Subcontratantes e prestadores de serviços (em inglês)

Pergunte em linguagem natural

Ligue um agente ao servidor e experimente os exemplos. O agente escolhe sozinho a ferramenta.

  • "Planeia um percurso do Rossio até Belém, em Lisboa"plan_transit_route devolve as opções de viagem disponíveis com paragens de embarque, horários e geometria do percurso.
  • "Onde posso chegar a partir da Praça do Comércio em 30 minutos de transportes públicos e a pé?"calculate_transit_isochrone devolve polígonos cumulativos de tempo de viagem e o número de paragens alcançáveis para a hora de partida selecionada.
  • "Encontra paragens de transportes num raio de 300 m de 38.7139,-9.1394"find_nearby_stops devolve os IDs, os nomes e as coordenadas das paragens dentro do raio e as linhas que servem cada uma.
  • "Quando é a próxima partida perto do Cais do Sodré e está atrasada?"get_departures devolve os horários programados e os previstos em direto. O atraso é realtimeDepartureTime menos scheduledDepartureTime.
  • "Mostra os veículos atuais na área 38.69,-9.24,38.78,-9.09"get_vehicle_positions_in_area devolve um instantâneo das posições atuais dentro do retângulo delimitador, com o ID da linha, as coordenadas, o sentido e a marca temporal.
  • "Há alertas de serviço para esta linha?"get_service_alerts devolve as perturbações atuais sem carregar o horário completo da linha.
  • "Como interpreto os atrasos em tempo real nas partidas?"O agente responde com base na descrição e no esquema da ferramenta. Ninguém cola documentação na conversa.
  • "Explica os endpoints prontos para modelos de voz e verifica-os com um pedido de percurso em direto"O agente lê busmaps://compact-api, examina os esquemas e exemplos correspondentes e, depois, chama as ferramentas compact_* através do explorador público.

Pronto para desenvolver?

Consulte o seu acesso atual à API no perfil. As contas confirmadas elegíveis podem testar os exemplos London Demo; o acesso pago ou acordado individualmente utiliza a cobertura e os limites atribuídos.

Pedir dados / acesso à API

O MCP e o REST partilham a quota da sua conta. Ligar um cliente de IA não inicia uma subscrição paga. Peça cobertura ou capacidade adicional quando o seu projeto precisar.