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.
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
Mostra o seu nome de apresentação, plano de API, cobertura permitida e fontes de dados. Não devolve a sua chave de API.
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.
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.
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.
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é.
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.
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.
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.
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.
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.
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.
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.
Devolve matrizes de tempo e distância de automóvel entre várias origens e destinos.
Devolve um percurso a pé com instruções passo a passo do OSRM para o primeiro e o último troço até uma paragem.
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é.
Geocodifica texto livre numa morada postal completa e estruturada em JSON.
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.
Devolve até duas viagens compactas estruturalmente distintas, com serviços, paragens, valores programados e em tempo real, acessibilidade e referências a alertas.
Devolve partidas compactas, programadas e em tempo real, perto de um ponto ou de uma paragem exata.
Devolve as paragens próximas ordenadas pela distância calculada, com identificadores para pedidos exatos posteriores.
Devolve o horário completo de uma linha no formato compacto por colunas.
Devolve um resumo do percurso a pé e as principais manobras para orientar o primeiro e o último troço.
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.
O servidor devolve instruções que indicam ao agente por onde deve começar.
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.
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 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.
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.
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
- Abra as definições dos conectores no Claude ou no Claude Desktop.
- Adicione um conector personalizado com o URL do servidor
https://mcp.busmaps.com/mcp. - 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.
- Adicione o URL do servidor nas definições de ligação MCP remota do seu cliente.
- Inicie sessão no BusMaps com email e palavra-passe ou através do Google. É necessária uma conta confirmada com acesso ativo à API.
- 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 à APIO 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.