API

Sections

Theme switcher

MCP Server

The Retailer API MCP Server is an MCP Server implementation which wraps the functionalities of the Distribusion’s Retailer API functionalities. The purpose of this MCP Server is for it to be used by AI Agents or Agentic applications which support MCP communication, in a Server-to-Server fashion.

Please note that this is an enterprise API feature. Reach out to your Partnership Manager for more information about unlocking this and other advanced features.

Authentication

In order to connect to the MCP Server, clients must pass a key specific to the MCP Server, not the regular key for the API. Contact your Partnership Manager to get access to your MCP Server API key.

How to Use

The MCP Server is intended to be used in a Server-to-Server fashion, in other words, it is not intended to be used in personal AI applications, such as Claude Desktop, or Cursor. Instead, it is targeted towards Agentic application frameworks, such as LangChain, Google ADK, LlamaIndex, and many more.

For instance, using Langchain MCP Adapters, the connection would be setup like this:

Plain text

Note that the above prompt may not work by itself. You may need to add some instructions to the agent to “teach” it how to use the tools correctly. For example:

“First, you must search for station/area/city codes based on the user’s query. After this, you may search for connections and subsequently check for their vacancies. Once vacancy is confirmed, you may generate a checkout link.”

Note that the above setup is not time-aware. You may need to add a tool to the agent so that it knows the current date and time. Otherwise, the user must tell exactly the travel dates, like “I want to travel on August 7th 2025” instead of “I want to travel next friday”.

You can use the MCP Inspector to explore the MCP Server.

Features

The MCP Server exposes the following tools:

Tool
Description
Parameters

search_stations

Find station codes by name

query, top_k

search_cities

Find city codes by name

query, top_k

search_areas

Find area codes by name/IATA

query, top_k

connections_find

Search travel connections

departure/arrival locations, dates, passengers

connections_vacancy

Check connection availability

connection details, fare class

get_checkout_link

Generate booking URLs

connection details, locale, seat selection

price_calendar

Get price calendar data

route, date range, carriers

get_carrier_info

Get carrier information (terms and conditions, luggage policy, cancellation policy)

carrier code

get_fare_info

Get information about a fare class for a marketing carrier, such as ticket validity rules, post-booking conditions, and fare features.

carrier code, fare class code

get_seat_map

Get available seats for a connection, if the connection supports it.

connection ID

All other functionalities, like reservations and bookings are not supported by the MCP Server. More features will soon be added. We are constantly working on bringing as many features as we can into the MCP Server.

Was this section helpful?

What made this section unhelpful for you?

On this page
  • MCP Server
View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot