Infobus

v1.0.0Search & Data Extractionstable

Model Context Protocol server enabling AI assistants to access transit information through standardized interfaces

mcpmcp-clientmcp-server
Share:
93
Stars
0
Downloads
0
Weekly
0/5

What is Infobus?

Infobus is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server enabling ai assistants to access transit information through standardized interfaces

Model Context Protocol server enabling AI assistants to access transit information through standardized interfaces

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Model Context Protocol server enabling AI assistants to acce

Use Cases

Access public transit information
Query transportation schedules
simovilab

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedDec 25, 2025
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx infobus

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Infobus

Infobus MCP Server provides AI assistants with real-time access to public transit information through a standardized MCP interface, connecting to the Infobús GTFS-based transit API to answer questions about bus arrivals, stop information, and route details. Built in Python with the official MCP SDK, it exposes tools that accept GTFS stop identifiers and ISO 8601 timestamps to retrieve the next arriving buses at any stop in the connected transit network. Transit agencies, city planners, and commuters can use this server to enable natural-language transit queries within their AI workflows.

Prerequisites

  • Python 3.14 or later
  • uv Python package manager installed
  • Access to the Infobús API (public endpoint at https://infobus.bucr.digital/api or a self-hosted instance)
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository

Clone the infobus-mcp repository from GitHub. The server code lives in the server/ subdirectory.

git clone https://github.com/simovilab/infobus-mcp.git
cd infobus-mcp
2

Create a virtual environment and install dependencies

Use uv to create a virtual environment in the server directory and install all required packages including the MCP SDK, httpx, and python-decouple.

cd server
uv venv
source .venv/bin/activate
uv sync
3

Configure the API endpoint

Create a .env file in the server directory to set the Infobús API base URL. For the public Costa Rica transit network, use the production endpoint. For self-hosted GTFS APIs, use your own URL.

# server/.env
INFOBUS_API_BASE=https://infobus.bucr.digital/api
USER_AGENT=transit-app/1.0
4

Test the server locally

Run the server directly to verify it starts without errors before integrating it with Claude Desktop.

uv --directory server run transit.py
5

Configure Claude Desktop

Add the Infobus MCP server to your Claude Desktop configuration. Use absolute paths for the command and directory.

{
  "mcpServers": {
    "infobus": {
      "command": "/absolute/path/to/infobus-mcp/server/.venv/bin/python",
      "args": ["/absolute/path/to/infobus-mcp/server/transit.py"],
      "env": {
        "INFOBUS_API_BASE": "https://infobus.bucr.digital/api",
        "USER_AGENT": "transit-app/1.0"
      }
    }
  }
}

Infobus Examples

Client configuration

Claude Desktop configuration for the Infobus MCP server pointing to the public Infobús API for Costa Rica transit data.

{
  "mcpServers": {
    "infobus": {
      "command": "/absolute/path/to/infobus-mcp/server/.venv/bin/python",
      "args": ["/absolute/path/to/infobus-mcp/server/transit.py"],
      "env": {
        "INFOBUS_API_BASE": "https://infobus.bucr.digital/api",
        "USER_AGENT": "transit-app/1.0"
      }
    }
  }
}

Prompts to try

These prompts exercise the stops_next_trips and stops_info tools using GTFS stop identifiers.

- "When is the next bus arriving at stop ID 1042?"
- "Show me the next 4 buses at stop 2203 as of right now"
- "What information is available for stop ID 500?"
- "Get the next bus arrivals at stop 1001 at 2025-09-15T08:30:00"
- "List all available transit routes"

Troubleshooting Infobus

uv sync fails or dependencies cannot be installed

Ensure you are using Python 3.14 as specified in the project requirements. Run 'uv python install 3.14' to download the correct Python version if needed. Confirm uv is up to date with 'uv self update'.

API returns empty results or connection refused

Verify that INFOBUS_API_BASE is correctly set to https://infobus.bucr.digital/api (no trailing slash). Test the API directly in a browser or with curl: 'curl https://infobus.bucr.digital/api/stops/1042/next_trips'. For self-hosted instances, confirm the API service is running and accessible.

stops_next_trips returns no arrivals

The tool uses the current timestamp if none is provided. Outside of service hours or for inactive stops, results may be empty. Verify the stop ID is valid by checking the Infobús API documentation or querying the agencies_info tool. Use ISO 8601 format (e.g., 2025-09-15T08:30:00) when providing explicit timestamps.

Frequently Asked Questions about Infobus

What is Infobus?

Infobus is a Model Context Protocol (MCP) server that model context protocol server enabling ai assistants to access transit information through standardized interfaces It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Infobus?

Follow the installation instructions on the Infobus GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Infobus?

Infobus works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Infobus free to use?

Yes, Infobus is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "infobus": { "command": "npx", "args": ["-y", "infobus"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Infobus?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides