Content
# Tool List
- **Target Audience**: Third-party developers, AI Agent builders, MCP client users
- **Objective**: Complete the first MCP Tool call within 5 minutes and obtain flight query results
- **Global Flight Booking**: Provides a full-process capability of querying, comparing prices, and booking, available for free use by enterprises and individuals.
## Core Advantages
- **Official Product, Global Coverage**: Over 500 cooperative airlines, covering more than 200 countries and regions, and 1000+ global destinations
- **Rich Routes**: Tens of millions of route combinations, meeting diverse travel needs, supporting direct flights, transfers, and other types of travel
- **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 Groups
- Personal users with flight ticket monitoring, hotel query, and price comparison needs
- Teams or individual developers developing AI Agents
- Developers who want to integrate flight booking capabilities into MCP Clients
- Developers building travel planning, travel management, OTA, and lifestyle 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 booking capabilities, and 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 users' departure, destination, travel dates, budget, and personalized preferences, supporting multi-dimensional demand matching
- **Travel Planning Tool**: Seamlessly embed flight 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 transactions" and build a demonstrable complete closed-loop
## Core Functions
- Support precise search of airport and flight information with various keywords such as city names, airport codes, airline names, and flight numbers
- Provide flexible departure/return date settings, cabin class selection (economy/super economy/business/first class), passenger number configuration, direct flight/transit screening, airline preference, and other professional screening functions
- Based on user personal preferences, provide personalized recommendations and generate high-cost-performance, fastest arrival, least transfer, and popular airline multidimensional 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 to ensure query results are accurate and bookable
## You Can Let Agent Complete the Following Flight-Related Tasks
- Search for flights based on departure, destination, travel dates, and number of passengers
- Query flight prices, seat information, and real-time inventory
- Determine if a flight or seat is bookable
- Construct flight recommendation, price comparison, travel planning, and other AI workflows
- Integrate flight capabilities into Claude, Cursor, Cherry Studio, ChatGPT MCP Client, or other clients that support the MCP protocol
- ⚠️ If you use ClawHub/扣子/Qclaw and other Agent platforms, please use our [Rollinggo全能订机票酒店Skill](https://modelscope.cn/collections/yorklu/RollingGo-quannengdingjiudianjipiao-Skill). Please refer to [RollingGo Skill Configuration Guide](https://rollinggo.store/docs/skill-docs/skill-config).
## 🚀 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, **without writing code**, to enable any MCP-supported AI assistant to 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, automatically approved within 1-3 minutes, and receive an email containing:
API Key
Partner center account (login name + initial password), log in to configure the markup ratio, view orders, and query revenue
3. ⚠️ Pay attention to check the email, if not received, please check the spam box
4. In order to thank the first batch of developers who are willing to try and act quickly, we offer a limited-time benefit: **all who receive API Key within 3 days of completing the first tool call will automatically unlock permanent free unlimited call quota.**
We hope to prioritize support for developers who have real needs and execution capabilities, allowing everyone to experience complete flight MCP capabilities at zero cost.
> The email also contains hotel MCP endpoint and flight MCP endpoint, one key can be accessed, you can choose to use. We also launched [RollingGo Hotel MCP](https://modelscope.cn/mcp/servers/yorklu/AI_Go_Hotel_MCP) product introduction on ModelScope.
**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 suitable interface permissions for you
- Provide technical support during the docking process
- Judge your usage scenario and reduce invalid configuration costs
- Protect interface stability and avoid malicious calls or abnormal traffic
- Be able to contact you in time for issues like test orders, price queries, and inventory verification.
We will only use this information for KEY opening, access support, and service security, not for external sharing or 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
> It is recommended to use Claude CLI, Codex, and Cursor clients. Other MCP-supported clients (such as Kiro, 豆包, etc.) have similar configuration methods.
### 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 it 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 use the same authentication method, the only difference is the URL (`/mcp` vs `/mcp/flight`).
### cURL Direct Test
> **Note**: cURL must bring the `-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": "上海外滩五星酒店",
"place": "上海外滩",
"placeType": "景点",
"checkInParam": {
"checkInDate": "2026-06-01",
"stayNights": 2
},
"filterOptions": {
"starRatings": [5.0]
},
"size": 3
}
},
"id": 1
}'
```
---
## Step 4: First MCP Call
After configuration is complete, say to your AI assistant:
> "Help me search for a flight from Hangzhou to Beijing". The AI will automatically call the Tool and return a list of flights.
### Flight 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": "杭州" }
},
"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 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 Query**
```
1. User says "Help me check flights"
2. Call searchAirports → Get city codes
3. Call searchFlights → Return flight list
4. Display to user (⚠️ Prices and inventory change in real-time)
```
### Common Questions
**Q1: After configuration, the client cannot see the Tool**
1. Check if the JSON configuration format is correct
2. Confirm if `url` and `type` are correct
3. Confirm if the `Authorization` header API Key is correct
4. Restart the client (modification takes effect after restart)
**Q2: Return 401 Unauthorized**
Invalid or incorrect format of API Key:
1. API Key should start with `mcp_`
2. There is a space after `Bearer` in `Authorization: Bearer YOUR_API_KEY`
3. Is there extra space or line break in API Key?
**Q3: Return 400 Bad Request**
Common when directly calling with cURL, check if the 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., "上海外滩" should be matched with "景点")
2. Relax screening conditions (remove star rating/tag restrictions)
3. Confirm if `checkInDate` is not in the past
**Q5: searchFlights reports an error**
1. Confirm if `searchAirports` was called first to get the correct city code
2. Confirm if `fromDate` is not in the past
3. For round-trip journeys, must pass `retDate`
**Q6: Price inconsistent with actual**
The search results price is a reference price, and the real-time price may change. Currently, only query is supported, and online ordering is not supported (planning).
**Q7: How to obtain 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 an application on the developer platform |
| Is API Key required | Yes, all requests require `Authorization: Bearer <API_KEY>` |
| Call limit | Unlimited |
| Fee | Completely free |
| Review cycle | 1-3 minutes automatic approval |
| Supported regions/currency | Global hotel and flight, domestic use CNY, overseas use USD |
| Ordering capability | Currently only supports query, not online ordering (planning) |
### Contact Us
Join the WeChat group to get technical support
Don't worry about any issues during the docking process! Welcome to join our WeChat technical support group, and our core development team will be online all the time, helping you solve environment configuration, interface debugging, and let you quickly run through the first successful hotel booking call.
You can get:
- Docking configuration guidance
- API / MCP call issue troubleshooting
- Hotel search, price, and booking process description
- Integration suggestions suitable for your business scenario
- 💬 WeChat group: [Scan code to join](https://raw.githubusercontent.com/young63/dida-picbed/main/groupchat_QR.jpg)
| 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*
