Content
# Tool List
[**中文**](#中文版本) | [**English**](README.md)
[](https://github.com/RollingGo-AI/rollinggo-flight-mcp/releases)
[](https://modelscope.cn/)
[](https://github.com/RollingGo-AI/rollinggo-flight-mcp)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
🏠 [Official Website](https://rollinggo.store/) · 🚀 [Quick Start](#quick-start) · 🔧 [Tools](#tools) · 💬 [Technical Support](#technical-support)
## Project Overview
- **Official Product, Global Coverage**: 500+ partner airlines, covering 200+ countries and regions, 1000+ global destinations
- **Rich Routes**: Millions of route combinations, meeting diverse travel needs, supporting direct flights, transfers, and more
- **Price Advantage**: Integrating global high-quality flight ticket resources, providing more competitive real-time prices
- **Service Guarantee**: Professional team support, 7×24 hours full-day customer service response
## Applicable People
- Personal users with flight ticket monitoring, hotel query, and hotel price comparison needs
- Teams or individual developers developing AI Agent
- Developers who want to integrate flight ticket booking capabilities into MCP Client
- Developers building travel planning, travel management, OTA, and life service intelligent agents
- Product teams hoping to verify AI Agent commercial transaction closed-loop
## Application Scenarios
- **General AI Agent**: Let your large model Agent directly have native flight ticket booking capabilities, users can complete the entire process from demand understanding, intelligent recommendation, price comparison, and order creation in natural dialogue
- **AI Travel Assistant**: Accurately recommend flights based on user departure, destination, travel date, budget, and personalized preferences, supporting multi-dimensional demand matching
- **Travel Planning Tool**: Seamlessly embed flight ticket search and booking capabilities into conversational travel planning processes, achieving an integrated experience of "planning and booking"
- **MCP / Agent Demo**: Quickly verify the product capability of "AI Agent directly completing flight ticket transactions," creating a demonstrable complete closed-loop
## Core Features
- Support city name, airport code, airline name, flight number, and other keyword precise searches for airport and flight information
- Provide flexible departure/return date settings, cabin class selection (economy/super economy/business/first class), passenger number configuration, direct flight/transfer screening, airline preference, and other professional screening functions
- Offer personalized recommendations based on user preferences, generating high-cost-effectiveness, fastest arrival, least transfer, popular airline, and other multi-dimensional professional lists
- The entire process of natural language interaction, intelligently completing the complete closed-loop from location analysis, flight query, price comparison, personalized recommendation to order generation
- Real-time synchronization of price and inventory with suppliers, ensuring query results are accurate and bookable
## Tasks You Can Let Agent Complete
- Search for flights based on departure, destination, travel date, and passenger number
- Query flight prices, cabin information, and real-time inventory
- Determine if a flight or cabin is bookable
- Construct flight recommendation, price comparison, travel planning, and other AI workflows
- Integrate flight ticket capabilities into Claude, Cursor, Cherry Studio, ChatGPT MCP Client, or other clients supporting MCP protocol
- ⚠️ If you use ClawHub/Kouzi/Qclaw and other Agent platforms, please use our [Rollinggo All-in-One Flight Ticket Hotel Skill](https://modelscope.cn/collections/yorklu/RollingGo-quannengdingjiudianjipiao-Skill). Please refer to [RollingGo Skill Configuration Guide](https://rollinggo.store/docs/skill-docs/skill-config).
---
## Tools
## 🚀 Quick Start
> 💡 In summary, you only need to do two things: apply for an API Key and configure it in the AI assistant with one click, **no coding required**, to let any MCP-supported AI assistant have hotel search capabilities, and complete the first MCP Tool call within 5 minutes.
### Step 1: Obtain API Key
1. [Click to enter the application address](https://mcp.agentichotel.cn/apply)
2. Fill in basic information, 1-3 minutes automatic review and approval, receive an email containing:
API Key
Partner center account (login name + initial password), log in to configure the price increase ratio, view orders, and query revenue
3. ⚠️ Check the email, if not received, please check the spam mailbox
4. To thank the first batch of developers who are willing to try and take action quickly, we offer a limited-time benefit: **all who receive the API Key within 3 days of completing the first tool call will automatically unlock the permanent free unlimited call quota.**
We hope to prioritize support for developers who have real needs and execution capabilities, so that everyone can experience the complete flight ticket MCP capability at zero cost.
> The email also contains hotel MCP endpoint and flight ticket MCP endpoint, one key can be accessed. We also launched [RollingGo Hotel MCP](https://github.com/RollingGo-AI/rollinggo-hotel-mcp/tree/main).
**Why do I need to fill in information to apply for KEY?**
Hotel price, inventory, and order capabilities involve real transaction links, so we need to open a **free dedicated independent KEY** for each developer. When applying for KEY, you only need to fill in a small amount of information, which is mainly to:
- Open the appropriate interface permissions for you for free
- Provide technical support during the access process
- Judge your usage scenario and reduce invalid configuration costs
- Protect interface stability and avoid malicious calls or abnormal traffic
- In case of test orders, price queries, inventory verification, and other issues, we can contact you in time
We will only use this information for KEY opening, access support, and service security, and will not share it with others or use it for unrelated purposes. If you just want to experience MCP, you can also explain your test goals, and we will try to provide lightweight test support.
### Step 2: Configure in AI Assistant
> Recommended Claude CLI, Codex, Cursor three clients. Other MCP-supported clients (such as Kiro, Dou package, etc.) configuration methods are similar.
### Claude CLI
Create `.mcp.json` in the project root directory:
```json
{
"mcpServers": {
"RollingGo-Hotel": {
"url": "https://mcp.rollinggo.cn/mcp",
"type": "http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
},
"RollingGo-Flight": {
"url": "https://mcp.rollinggo.cn/mcp/flight",
"type": "http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
You can also add directly through the command line:
```bash
claude mcp add \
--transport http \
--header "Authorization: Bearer YOUR_API_KEY" \
RollingGo-Hotel \
https://mcp.rollinggo.cn/mcp
claude mcp add \
--transport http \
--header "Authorization: Bearer YOUR_API_KEY" \
RollingGo-Flight \
https://mcp.rollinggo.cn/mcp/flight
```
### Codex
Configuration file location: project root directory `.codex/config.json` or global `~/.codex/config.json`
```json
{
"mcpServers": {
"RollingGo-Hotel": {
"url": "https://mcp.rollinggo.cn/mcp",
"type": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
},
"RollingGo-Flight": {
"url": "https://mcp.rollinggo.cn/mcp/flight",
"type": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
### Cursor
Configuration file location: project root directory `.cursor/mcp.json` or global `~/.cursor/mcp.json`
```json
{
"mcpServers": {
"RollingGo-Hotel": {
"url": "https://mcp.rollinggo.cn/mcp",
"type": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
},
"RollingGo-Flight": {
"url": "https://mcp.rollinggo.cn/mcp/flight",
"type": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
> Replace `YOUR_API_KEY` with the actual API Key you received. Hotel and flight tickets use the same authentication method, the difference is only in the URL (`/mcp` vs `/mcp/flight`).
### cURL Direct Test
> **Note**: cURL must bring `-H "Accept: application/json, text/event-stream"` header, otherwise the server returns 400.
```bash
curl -X POST https://mcp.rollinggo.cn/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "searchHotels",
"arguments": {
"originQuery": "Shanghai Bund five-star hotel",
"place": "Shanghai Bund",
"placeType": "attraction",
"checkInParam": {
"checkInDate": "2026-06-01",
"stayNights": 2
},
"filterOptions": {
"starRatings": [5.0]
},
"size": 3
}
},
"id": 1
}'
```
---
## Step 4: First MCP Call
After configuration, say to your AI assistant:
> "Help me search for flight tickets from Hangzhou to Beijing". AI will automatically call the Tool and return the flight ticket list.
### Flight Ticket Query Example (two steps)
**Step 1**: Search for airports and get city codes
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "searchAirports",
"arguments": { "keyword": "Hangzhou" }
},
"id": 1
}
```
**Step 2**: Use city codes to query flights
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "searchFlights",
"arguments": {
"adultNumber": 1,
"childNumber": 0,
"cabinGrade": "ECONOMY",
"tripType": "ONE_WAY",
"fromCity": "HGH",
"toCity": "CTU",
"fromDate": "2026-06-01"
}
},
"id": 1
}
```
---
## Step 5: View Results and Display Cases
### Flight Ticket Query Results (actual data)
> Hangzhou → Chengdu, one-way, economy, returned **95 flights**:
| Flight Number | Route | Time | Price |
|--------------|------|------|------|
| CA1741 | Hangzhou Xiaoshan → Chengdu Tianfu | 07:40 - 10:40 | ¥2,869 |
| CZ6198 | Hangzhou Xiaoshan → Wuhan | 13:10 - 15:00 | ¥4,631 |
| CA3338 | Hangzhou Xiaoshan → Shenzhen | 12:55 - 15:15 | ¥5,341 |
---
## Appendix
[mcp tool reference documentation](https://rollinggo.store/docs/mcp-docs/mcp-tool-reference)
### Recommended Call Process
**Flight Ticket Query**
```
1. User says "Help me check flight tickets"
2. Call searchAirports → Get city codes
3. Call searchFlights → Return flight list
4. Display to user (⚠️ Prices and inventory change in real-time)
```
### Frequently Asked Questions
**Q1: After configuration, the client can't see the Tool**
1. Check if the JSON configuration format is correct
2. Confirm if `url` and `type` are correct
3. Confirm if `Authorization` header API Key is correct
4. Restart the client (modification configuration takes effect after restart)
**Q2: Return 401 Unauthorized**
API Key invalid or format error:
1. API Key should start with `mcp_`
2. `Authorization: Bearer YOUR_API_KEY` has a space after Bearer
3. Is the API Key have extra spaces or line breaks
**Q3: Return 400 Bad Request**
Common when calling directly with cURL, check if Accept header is brought:
```bash
-H "Accept: application/json, text/event-stream"
```
**Q4: searchHotels returns empty results**
1. Check if `place` and `placeType` match (e.g., "Shanghai Bund" should be matched with "attraction")
2. Relax screening conditions (remove star rating/tag restrictions)
3. Confirm if `checkInDate` is not a past time
**Q5: searchFlights reports an error**
1. Confirm if `searchAirports` was called first to get the correct city code
2. Confirm if `fromDate` is not a past time
3. Round-trip journey must pass `retDate`
**Q6: Price inconsistent with actual**
Search results prices are reference prices, real-time prices may vary. Currently only support queries, not online ordering.
**Q7: How to get API Key?**
Go to [https://rollinggo.store/apply](https://rollinggo.store/apply) to submit an application, approved within 1-3 minutes, free and unlimited.
### Access Threshold and Limitations
| Item | Description |
|------|------|
| Is registration required | Yes, need to submit application on developer platform |
| Is API Key required | Yes, all requests need `Authorization: Bearer <API_KEY>` |
| Call limit | Unlimited |
| Fee | Completely free |
| Review cycle | 1-3 minutes automatic approval |
| Supported regions/currencies | Global hotel and flight tickets, domestic use CNY, overseas use USD |
| Ordering capability | Currently only support queries, not online ordering (planning) |
### Technical Support
Join the WeChat group to get technical support
Don't worry about any problems during the access process! Welcome to join our WeChat technical support group, our core development team will be online, hand-in-hand help you solve environment configuration, interface debugging, accompany you to run through the first successful flight ticket query call, let you quickly go online without obstacles.
You can get in the group:
- Access configuration guidance
- API / MCP call problem troubleshooting
- Flight ticket search, price, inventory query process description
- Integration suggestions suitable for your business scenario
| Other types | Method |
|------|------|
| API Key application | [https://rollinggo.store/apply](https://rollinggo.store/apply) |
| Business cooperation | contact@rollinggo.cn |
| Partner Center | [https://travelportal-partner-center.dida.com](https://travelportal-partner-center.dida.com) |
| Skill Hub | [https://rollinggo.store/solutions/skills](https://rollinggo.store/solutions/skills) |
| GitHub | [https://github.com/RollingGo-AI/rollinggo-readme](https://github.com/RollingGo-AI/rollinggo-readme) |
*Document version: v1.0*
