skills.rest
Aradotso
AradotsoOFFICIAL
Explore all skills by this author →
Website𝕏@aradotsoGitHub

mcp-server-12306

Query China Railway 12306 train tickets, prices, and schedules via MCP.

7|2|Updated May 16, 2026
Search Tags:#mcp#train tickets#12306#route planning#price lookup#station search#travel scheduling
One-click install
npx skills add https://github.com/Aradotso/mcp-skills --skill mcp-server-12306
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-server-12306
Source: https://github.com/Aradotso/mcp-skills/tree/main/skills/mcp-server-12306
Command: npx skills add https://github.com/Aradotso/mcp-skills --skill mcp-server-12306

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of finding real-time China Railway 12306 train ticket availability, prices, and schedules without manually searching the 12306 site and cross-referencing station and route details.

Core Features & Use Cases

  • Real-time ticket lookup: Search available seats between two stations for a given date, including train type, times, and seat availability.
  • Station discovery & details: Fuzzy station search by Chinese name, pinyin, or abbreviation, plus retrieving station info by name/code.
  • Route planning (direct and transfer): Query direct train routes and one-transfer connections when direct options are limited.
  • Price and schedule queries: Get price breakdowns by seat type and retrieve full stop-by-stop route schedules.
  • Time utilities for booking: Compute current time and relative booking dates in the desired timezone.

Quick Start

Ask the assistant to set up the mcp-server-12306 connection and then query tickets for Beijing to Shanghai on a specific date.

Frequently Asked Questions about mcp-server-12306

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query real-time China Railway 12306 train tickets and prices?▼

To search China Railway 12306 station codes, use the search_stations MCP tool with a fuzzy match query like Chinese name, pinyin, or abbreviation. It returns matching station info and codes for ticket booking.

Can I plan train routes with one transfer when direct options are unavailable?▼

Yes, you can plan one-transfer train routes when direct options are unavailable by calling the query_transfer MCP tool. It provides connecting train schedules and routes to complete your travel itinerary.

How do I get a full stop-by-stop train schedule for a specific train number?▼

You get a full stop-by-stop train schedule by calling the get_train_route_stations MCP tool with the specific train number. It retrieves the complete chronological route schedule for the queried train.

Does querying 12306 train tickets require an MCP client to work?▼

Yes, querying 12306 train tickets requires an MCP client to call the provided tools and supports both stdio and HTTP deployment modes. The client passes properly formatted parameters to the server for real-time data retrieval.

What are the limitations of using MCP for 12306 ticket availability checks?▼

A limitation of using MCP for 12306 ticket availability checks is that route planning only supports direct routes and one-transfer itineraries. Complex multi-transfer journeys are not supported by the query_transfer tool.

Related Skills

Explore More Education & Research Skills→
caoronglincaoronglin
2

MCP 12306 火车票

Query real-time train schedules, seat availability, and pricing via MCP.

Community
Intermediate
jarrett-aujarrett-au

12306-ticket-assistant

Automate 12306 train ticket searches and preference application for weekend travel.

Community
Advanced
qq5855144qq5855144
23

train-ticket-query

Query Chinese railway schedules, ticket availability, and fares via POST requests.

Community
Intermediate
tzangmstzangms

taipei-parking-query

Query real-time Taipei City parking availability from the official API.

Community
Intermediate