regiojet-mcp
MCP server (FastMCP) for the RegioJet Affiliate API. Find stations, search connections, inspect routes, prices and free seats. With an account token it can also book, pay from RegioJet credit and cancel tickets.
Tools
| Tool | Description |
|---|---|
find_locations |
Resolve city/station names (any language, diacritics optional) to ids |
search_routes |
Connections between two locations on a date, paginated via cursor + page |
get_route_detail |
Sections (lines, platforms, transfers) and price per seat class |
get_free_seats |
Free seats per vehicle for a seat class |
list_tariffs, list_seat_classes, list_vehicle_standards, list_carriers, list_action_prices |
Reference data (cached) |
get_ticket |
Existing ticket by account code + ticket id |
Account tools (need REGIOJET_API_KEY):
| Tool | Description |
|---|---|
get_account |
Name, default tariff, credit balance |
list_my_tickets, get_my_ticket |
Tickets on the account, filterable by state |
create_reservation |
Reserve seats (UNPAID until paid, expires at expiration_date) |
pay_ticket_with_credit |
Pay UNPAID tickets from account credit (spends money) |
cancel_ticket |
Cancel a reservation or paid ticket (cancel charges may apply) |
Booking flow: search_routes → get_route_detail (price_source per seat class) → get_free_seats
→ create_reservation → pay_ticket_with_credit or cancel_ticket.
Resources: regiojet://tariffs, regiojet://seat-classes.
Run
uv sync
uv run regiojet-mcp # stdio
REGIOJET_MCP_TRANSPORT=http uv run regiojet-mcp # http on 127.0.0.1:8000
uv run fastmcp dev server.py # MCP Inspector
Claude Code:
claude mcp add regiojet -- uv run --directory /path/to/regiojet-mcp regiojet-mcp
Configuration
Variables can also be put in a .env file in the working directory.
| Env var | Default |
|---|---|
REGIOJET_BASE_URL |
https://brn-ybus-pubapi.sa.cz/restapi |
REGIOJET_API_KEY |
unset; RegioJet customer account token (sent as Bearer), enables account tools |
REGIOJET_USER / REGIOJET_PASSWORD |
unset (HTTP Basic auth for affiliate accounts; ignored when REGIOJET_API_KEY is set) |
REGIOJET_LANG |
en |
REGIOJET_CURRENCY |
EUR |
REGIOJET_TIMEOUT |
20 seconds |
REGIOJET_MCP_TRANSPORT / _HOST / _PORT |
stdio / 127.0.0.1 / 8000 |
Tests
uv run pytest
1 maintainer
Metadata
1 maintainer
Release files for regiojet-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| regiojet_mcp-0.1.2.tar.gz | 11.4 kB | Without provenance | Details for regiojet_mcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| regiojet_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for regiojet_mcp-0.1.2-py3-none-any.whl |
Total release size: 24.3 kB
Release files / regiojet_mcp-0.1.2.tar.gz
| Download URL | regiojet_mcp-0.1.2.tar.gz |
|---|---|
| Size | 11.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5d79953e73b0c0e65d4470f13e13537d515d844051f6a70ea735aacbd501f9da
|
|
BLAKE2b-256 checksum How to use checksums |
4c06b9640e0746a27235912439fc4b49e220c6e63a1567a68d5c161025cb1278
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / regiojet_mcp-0.1.2-py3-none-any.whl
| Download URL | regiojet_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 12.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e931e28957f2768f6548515e7d5d86df9e010f40059784e39bc0de5d004123e2
|
|
BLAKE2b-256 checksum How to use checksums |
b54745875852c9952c592d1930176ff5d490e320bc43bcbf6e2530e8ba003721
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for regiojet-mcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
