Skip to main content
Glama
kerol1

soloway-mcp

by kerol1
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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: AgniGateway Marketplace

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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • openbusdata

    AndrewAubury
    A
    license
    C
    quality
    C
    maintenance
    MCP server for the UK Bus Open Data Service, enabling timetable queries, stop search, route discovery, journey planning, and real-time bus tracking.
    16
    23 PyPI
    MIT

  • RZD Tickets MCP

    ex3lite
    A
    license
    Not graded
    quality
    D
    maintenance
    Read-only MCP server that queries Russian Railways (ticket.rzd.ru) for train schedules, car types, prices, and seat availability. It provides official RZD links for manual booking but does not log in, book, or pay.
    31 npm
    2
    MIT