VVoyagent
Overview
AI agents8 min

MCP Server

Connect AI tools like Claude Desktop, Cursor or custom agents to RideClaw travel services via MCP.

What is MCP Server

RideClaw MCP Server exposes travel search, pricing and booking capabilities as structured tools that AI assistants can call. Compatible with any client that speaks the Model Context Protocol (MCP), including Claude Desktop, IDE plugins, and custom agent frameworks.

Search flights, hotels, rides, trains and buses from natural language queries.
Get real-time pricing and availability before booking.
Create bookable itineraries with validation built in.
Works with Claude Desktop, Cursor, Windsurf and custom MCP clients.

Available tools

The server provides 9 read-only tools for searching and planning. Write operations (creating orders, payment, cancellation) require explicit user confirmation and are not exposed as auto-callable tools.

flight.search — Search flights by route and date
flight.airport_search — Find airport codes by keyword
flight.pricing — Get bookable offers with pricing
hotel.search — Search hotels by destination and dates
hotel.detail — Get room types and rates
taxi.estimate — Estimate ride pricing and ETA
train.search — Search high-speed rail schedules
bus.search — Search intercity bus routes

Setup for Claude Desktop

Add RideClaw to your Claude Desktop MCP configuration. The server will authenticate using your API key and expose travel tools directly in the chat interface.

Example
// claude_desktop_config.json
{
  "mcpServers": {
    "rideclaw": {
      "command": "curl",
      "args": [
        "-X", "POST",
        "https://open.longxiachuxing.com/api/open/v1/mcp",
        "-H", "Authorization: Bearer YOUR_API_KEY",
        "-H", "Content-Type: application/json",
        "-d", "@-"
      ]
    }
  }
}

Setup for custom agents

Point your MCP client to the RideClaw endpoint and authenticate with your API key. The endpoint accepts standard JSON requests and can also stream responses for real-time progress.

Example
POST https://open.longxiachuxing.com/api/open/v1/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Example queries

Once connected, your AI assistant can handle travel queries in natural language. The MCP server translates these into structured API calls and returns results the assistant can work with.

'Find flights from Shenzhen to Beijing tomorrow' → calls flight.search
'How much is a taxi from the airport to downtown?' → calls taxi.estimate
'Show me 5-star hotels near West Lake' → calls hotel.search
'What trains run from Hangzhou to Shanghai on Friday?' → calls train.search

Safety and validation

All booking-related operations require explicit user confirmation. The MCP server only exposes read-only search and pricing tools — agents cannot create orders or process payments without your approval flow.

Search and quote operations are read-only and safe to auto-call.
Booking operations are not exposed as MCP tools.
Your application must implement confirmation UI before creating orders.
Use webhooks to track order status after booking.