Skip to main content
Glama
kerol1
by kerol1

SoloWay MCP Server

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. 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.

Related MCP server: mcp-lad-lviv-ua

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

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Lviv public transport MCP: stops, timetables, routes, and live vehicle positions. No API key.

  • AI marketplace — flights, tours, activities, transport & more via MCP. No auth required.

  • Entur MCP — Norway public transport, nationwide, all modes (developer.entur.org)

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kerol1/soloway-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server