MCP Tools
The All Aboard MCP server exposes the following tools to the model. The model decides which tools to call based on the task at hand.
list_documentation
Lists all available documentation sections and pages with short descriptions. Use this first to discover what is available before fetching specific content.
Parameters: None
Example output:
## Getting Started
- Introduction: Overview of All Aboard products and quick start guide
- Getting Started: Prerequisites, API endpoints, authentication setup
...## Getting Started
- Introduction: Overview of All Aboard products and quick start guide
- Getting Started: Prerequisites, API endpoints, authentication setup
...read_documentation
Fetches one or more documentation pages by slug and returns their content as clean plain-text markdown. Always call list_documentation first to find relevant slugs, then fetch only the pages you need.
A slug is the URL path without the leading slash:
| Slug | Page |
|---|---|
"" or "index" | Introduction |
"intro/getting-started" | Getting Started |
"tickets/index" | Finding Journeys |
"tickets/book-tickets" | Booking Tickets |
"payments/index" | Payment Methods |
"ref/errors" | Error Codes |
Pass multiple slugs to fetch several pages in a single call.
Parameters:
| Parameter | Type | Description |
|---|---|---|
slugs | string | One or more page slugs, comma-separated (e.g. "tickets/index,tickets/book-tickets") |
explore_schema
Browses the live GraphQL schema. Returns operation signatures with argument types and return types, or a list of available types.
Parameters:
| Parameter | Type | Description |
|---|---|---|
category | queries | mutations | subscriptions | types | Which category to list |
filter | string (optional) | Case-insensitive name filter |
Example — list all queries containing "journey":
explore_schema({ category: "queries", filter: "journey" })explore_schema({ category: "queries", filter: "journey" })Example output:
- **getJourneys**(origin: String!, destination: String!, date: String!, filter: JourneyFilterInput): [Journey!]!
Find available train routes between two locations on a specific date.
- **getJourneyOffer**(journey: ID!, passengers: [PassengerInput!]!): JourneyOffer
Get pricing and offers for a journey.- **getJourneys**(origin: String!, destination: String!, date: String!, filter: JourneyFilterInput): [Journey!]!
Find available train routes between two locations on a specific date.
- **getJourneyOffer**(journey: ID!, passengers: [PassengerInput!]!): JourneyOffer
Get pricing and offers for a journey.get_type
Returns full details of a specific GraphQL type: all fields with their argument types and return types, enum values, input fields, interfaces implemented, and possible types for unions/interfaces.
Parameters:
| Parameter | Type | Description |
|---|---|---|
name | string | Exact name of the type (e.g. Journey, Booking, PassBundle) |
Example:
get_type({ name: "Booking" })get_type({ name: "Booking" })If the type is not found, the tool returns suggestions for similarly named types.
execute_query
Executes a GraphQL query or mutation against the All Aboard API and returns the JSON response.
Each call requires the user's own API key passed as the apiKey parameter. The MCP server does not store or inject credentials — the key is sent directly to the API on the user's behalf and is not retained between calls. If the user has not provided their API key, ask for it before calling this tool.
API keys are available from the All Aboard Dashboard.
Parameters:
| Parameter | Type | Description |
|---|---|---|
query | string | GraphQL query or mutation string |
variables | object (optional) | Variables for the operation |
apiKey | string | Your All Aboard API key, available from the dashboard |
environment | live | test (default: test) | Which environment to execute against |
Always use test first
The environment parameter defaults to test. Only switch to live when you are confident the query is correct — live executions create real bookings and charges.
Example:
graphql
query FindJourneys {
getJourneys(
origin: "Sb0ISveC"
destination: "p6fERure"
date: "2025-06-15"
) {
id
itinerary {
duration
}
}
}query FindJourneys {
getJourneys(
origin: "Sb0ISveC"
destination: "p6fERure"
date: "2025-06-15"
) {
id
itinerary {
duration
}
}
}GraphQL errors in the response are surfaced clearly alongside the full response body for debugging.