SoloWay MCP Server

Name: soloway-mcp
Author: kerol1

kerol1/soloway-mcp 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.
`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.

Related MCP server: sbb-mcp

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

MIT

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

soloway-mcp