Buses Coruña

What it does

Buses Coruña connects your AI assistant to A Coruña's live bus network. Ask for arrivals at any stop by ID, query the primary configured stop hands-free, or search stops filtered by your lines of interest — all from a natural language prompt.

Key features

• Live arrivals for any stop ID via show_bus_arrivals, with structured output including stop info and upcoming buses
• Default stop shortcut with show_default_bus_arrivals — no parameters needed, returns your configured primary stop
• Stop search with optional text filter and line-of-interest filtering via search_stops
• Deployable as stdio (local) or Streamable HTTP (behind Nginx/systemd on a server)
• Configurable via app_config.json or environment variables for stops source URL, cache TTL, and transport mode

Installation

Claude Desktop

Run in stdio mode. Clone the repo, build, then add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "buses-coruna": {
      "command": "node",
      "args": ["/path/to/mcp-buses-coruna/dist/main.js"]
    }
  }
}

Cursor

For HTTP deployment, add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "buses-coruna": {
      "url": "http://your-server.example.com/mcp"
    }
  }
}

Supported hosts

Claude Desktop (stdio), Cursor, and any MCP-compatible client that supports Streamable HTTP transport.