SoloWay — Bus Tickets for Ukraine & Europe
RemoteAbout SoloWay — Bus Tickets for Ukraine & Europe
SoloWay MCP Server provides read-only, live intercity bus-trip search for Ukraine and Europe, with no API key or authentication required. Travelers and trip-planning clients can retrieve fares, seat availability, route details, and calendar prices, then follow a booking link on SoloWay.
Key features
- 01Live intercity trip search
- 02Prices, seats, carriers, and transfers
- 03Monthly cheapest-day price calendar
- 04Trip stops and carrier details
- 05Nearby route alternatives with booking links
Use cases
- 01Compare bus trips between cities
- 02Find the cheapest travel date in a month
- 03Inspect stops and seat information for a trip
- 04Check nearby routes when no direct result appears
MCP support
Exposes read-only trip search, calendar pricing, trip details, and liveness tools to MCP clients over stateless streamable HTTP. The hosted endpoint is https://mcp.soloway.com.ua/mcp.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.soloway.com.ua/mcpclaude mcp add --transport http soloway https://mcp.soloway.com.ua/mcp{"mcpServers":{"soloway":{"type":"http","url":"https://mcp.soloway.com.ua/mcp"}}}Open in Cursor{"servers":{"soloway":{"type":"http","url":"https://mcp.soloway.com.ua/mcp"}}}Open in VS Code{"mcpServers":{"soloway":{"type":"http","url":"https://mcp.soloway.com.ua/mcp"}}}{"mcpServers":{"soloway":{"serverUrl":"https://mcp.soloway.com.ua/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4This tool takes no parameters.
Details
From the project READMESoloWay MCP Server
Live intercity bus-trip search across Ukraine and Europe as a remote MCP server. Read-only, no API key, no auth. Powered by soloway.com.ua — bookings are completed there, not through the tools.
Remote endpoint: https://mcp.soloway.com.ua/mcp (streamable HTTP, stateless)
Tools
| Tool | What it does |
|---|---|
search_trips | Trips between two cities on a date — live prices, free seats, carriers, duration, transfers, passenger discounts, and a booking deep-link. City names resolve automatically (uk/en), with disambiguation when several cities match. On an empty result the tool verifies routes via bigger cities within ~60 km of the requested endpoints and returns confirmed ones in nearby_alternatives, each with substitution distances and its own booking link. |
get_calendar_prices | Cheapest price for each day of a month on a route — find the cheapest day to travel. |
get_trip_details | Full details of one trip from search results — stops, carrier discounts, seat info. |
ping | Liveness check. |
All tools declare outputSchema, readOnlyHint: true and openWorldHint: false.
Connect
Works with any MCP client that speaks streamable HTTP. Step-by-step instructions for Claude, ChatGPT and others: soloway.com.ua/connect.
Claude Code:
claude mcp add --transport http soloway https://mcp.soloway.com.ua/mcp
Self-hosting
The server is a thin, cache-friendly proxy over the public SoloWay API — the Docker image works out of the box:
docker build -t soloway-mcp .
docker run -p 8088:8088 soloway-mcp
# then point your MCP client at http://localhost:8088/mcp
Configuration
All settings are env vars with sane defaults — see .env.example. The ones you may care about:
| Var | Default | Notes |
|---|---|---|
PORT | 8088 | HTTP port |
BACKEND_BASE_URL | https://soloway.com.ua (image) | SoloWay API origin |
EXPECTED_HOST | * (image) | CSV of accepted Host values for no-Origin requests. * accepts any host and disables the SDK DNS-rebinding belt — fine for local/sandbox runs; pin your public hostname in production (our prod sets mcp.soloway.com.ua). |
ALLOWED_ORIGINS | claude.ai / openai.com / soloway.com.ua | CSV, suffix wildcards supported (https://*.claude.ai) |
DEFAULT_LOCALE | uk | uk or en |
SEARCH_MAX_RESULTS | 40 | Cap on trips returned per search |
Development
npm install
npm run dev # tsx watch
npm test # vitest
npm run typecheck
server.json is the MCP registry manifest; eval/evals.xml holds stable-answer evaluations in mcp-builder format.
License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.