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 documentation sections and pages, each with a link and the page's first sentence. It returns the site's llms.txt. Use this first to discover what is available before fetching specific content.

Parameters: None

Example output (abridged):

# All Aboard API Documentation

> Tools for selling train tickets and rail passes across Europe via GraphQL API, embeds, and dashboard.

## Getting Started
- [Overview](https://allaboard.eu/docs/index.md): Search and book train tickets and Interrail passes in your apps and AI assistants, from train and bus operators across Europe.
- [Quick Start](https://allaboard.eu/docs/intro/quick-start.md): A ticket booking through the API takes seven operations.
...

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 page's path after /docs/, without .md. The Overview is index, and section index pages end in /index:

Pass multiple slugs to fetch several pages in a single call.

Parameters:

explore_schema

Browses the live GraphQL schema. Returns operation signatures with argument types and return types, or a list of available types.

Parameters:

Example (list all queries containing "journey"):

explore_schema({ category: "queries", filter: "journey" })

Example output (abridged):

Found 8 queries:

- **journeys**(origin: LocationInput!, destination: LocationInput!, date: Date!, filter: JourneyFilterInput, via: [ViaInput!]): [Journey!]!
  Get all possible journeys between origin and destination on given date

See: https://allaboard.eu/docs/tickets
- **journeyOffer**(journeyId: ID!, passengers: [PassengerPlaceholderInput!]!, currency: String = "EUR"): JourneyOffer!
  This will check live availablity with the train operators and return the given
journey with priced offers. Call this when the user has requested prices.

See: https://allaboard.eu/docs/tickets/journey-offer
...

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:

Example:

get_type({ name: "Booking" })

If the type is not found, the tool returns suggestions for similarly named types.

execute_query

Executes a read-only GraphQL query against the All Aboard API and returns the JSON response. Use this tool only for query operations; use execute_mutation for mutations.

Authentication is handled automatically via OAuth 2.1 during MCP connection setup. No API key parameter is required.

If the tool returns an authentication error, reconnect your MCP client to https://mcp.allaboard.eu/mcp to go through the OAuth flow again.

Parameters:

Example:

query FindJourneys {
  journeys(
    origin: { uid: "Sb0ISveC" }
    destination: { uid: "p6fERure" }
    date: "2026-12-02"
  ) {
    id
    itinerary {
      __typename
      ... on SegmentCollection {
        segments {
          departureAt
          arrivalAt
          duration
        }
      }
      ... on Stopover {
        duration
      }
    }
  }
}

GraphQL errors in the response are surfaced alongside the full response body for debugging.

execute_mutation

Executes a GraphQL mutation against the All Aboard API. Use this for operations that create, update, or delete data, such as booking tickets or creating orders. Use execute_query for read-only queries.

Authentication is handled automatically via OAuth 2.1, the same as execute_query.

Parameters:

Example:

mutation CreateBooking($offerIds: [ID!]!) {
  createBooking(offerIds: $offerIds) {
    id
    expiresAt
    totalPrice {
      amount
      currency
    }
  }
}

GraphQL errors in the response are surfaced alongside the full response body for debugging.