Integrate RollingGo Travel MCP into Your Application

RollingGo exposes its travel capabilities — flight search, hotel booking, and itinerary management — as structured tools via the Model Context Protocol (MCP). MCP is an open standard that lets AI agents discover and call external tools over a WebSocket or HTTP connection, turning your application into a capable travel assistant without hand-rolling custom integrations. If you hold an Enterprise or Developer partner account, your API Key is all you need to start making live travel calls today.

Prerequisites

Before you begin, make sure you have:

An active Enterprise or Developer partner account
Your API Key — retrieve it from Partner Center → Credentials → API Keys
Node.js 18+ or Python 3.10+ installed, depending on your stack

MCP Connection Parameters

Use the following parameters when configuring your MCP client:

Parameter	China	International
Base URL	`wss://mcp.rollinggo.cn/v1`	`wss://mcp.rollinggo.ai/v1`
Protocol	WebSocket (streaming) or HTTP (single-turn)	WebSocket (streaming) or HTTP (single-turn)
Authentication	Bearer token in connection handshake	Bearer token in connection handshake

Pass your API Key as a Bearer token in the Authorization header during the WebSocket upgrade handshake:

Authorization: Bearer <YOUR_API_KEY>

Use the China region endpoint (mcp.rollinggo.cn) if your server is deployed within mainland China. The geographically closer endpoint significantly reduces connection latency.

Integration Steps

Install the RollingGo MCP SDK

Add the official client library to your project:

npm install @rollinggo/mcp-client

yarn add @rollinggo/mcp-client

pnpm add @rollinggo/mcp-client

Initialize the client with your API Key

Import the client and configure it with your API Key and target region. Store your key in an environment variable — never hard-code it in source files.

rollinggo-client.js

import { RollingGoMCP } from '@rollinggo/mcp-client';

const client = new RollingGoMCP({
  apiKey: process.env.ROLLINGGO_API_KEY,
  region: 'international', // or 'china'
});

Make a travel search call

Call the travel_search tool with your desired route and travel parameters:

const results = await client.tools.call('travel_search', {
  origin: 'HKG',
  destination: 'NRT',
  departDate: '2025-09-01',
  passengers: 1,
});
console.log(results);

Handle the response

A successful search response returns a status field and a results array. Each result includes flight identifiers, schedule details, and pricing:

{
  "status": "ok",
  "results": [
    {
      "flightId": "CX520",
      "origin": "HKG",
      "destination": "NRT",
      "departureTime": "2025-09-01T10:30:00+08:00",
      "price": { "amount": 3200, "currency": "HKD" }
    }
  ]
}

Iterate over results to present options to your user or agent, and store the flightId of the chosen option for the next step.

Initiate a booking

Pass the selected flightId and passenger details to the booking_create tool to start the reservation flow:

const booking = await client.tools.call('booking_create', {
  flightId: 'CX520',
  passengers: [
    {
      firstName: 'Alex',
      lastName: 'Chan',
      documentType: 'PASSPORT',
      documentNumber: 'HK1234567',
    },
  ],
  contactEmail: 'alex@example.com',
});

console.log('Booking reference:', booking.bookingReference);

Save the returned bookingReference — your user will need it to manage or cancel the reservation later.

Next Steps

Travel Search API Reference

Explore all search parameters, filters, and response fields for the travel_search tool.

Booking API Reference

Full reference for creating, retrieving, and cancelling bookings via the MCP booking tools.

Get Started

Partner Types

Credentials & Access

Guides

Support

Integrate RollingGo Travel MCP into Your Application

Prerequisites

MCP Connection Parameters

Integration Steps

Next Steps

Travel Search API Reference

Booking API Reference

​Prerequisites

​MCP Connection Parameters

​Integration Steps

​Next Steps

Travel Search API Reference

Booking API Reference

Prerequisites

MCP Connection Parameters

Integration Steps

Next Steps