12306购票搜索服务器

A 12306 train ticket query service based on the MCP protocol, providing function interfaces related to ticket purchasing such as station query, remaining ticket search, and transfer ticket query.

Travel and transportation Search tools #Train ticket query #12306 interface #Station information #Transfer tickets .TypeScript

rating : 2 points

downloads : 4.1K

update time : 2026-01-06

Open Site

What is the 12306 Ticket Purchase Search Server?

This is a dedicated train ticket query tool designed for AI assistants. Through the standardized MCP protocol, AI assistants can query 12306 train ticket information like humans, including train numbers, remaining tickets, station codes, and stop - over stations, helping users quickly obtain travel information.

How to use the 12306 Ticket Purchase Search Server?

You only need to configure this service in an AI assistant that supports MCP (such as Claude Desktop, Cursor, etc.). The AI assistant can then automatically call the relevant tools. When you ask questions related to train tickets, the AI will use this service to query the latest information and give answers.

Applicable Scenarios

• Query the remaining tickets and fares of train tickets • Find station codes and station information • Plan travel routes, including direct and transfer options • Query the stop - over stations and timetables of specific trains • Help users understand the specific dates corresponding to relative dates (such as “tomorrow”, “next Wednesday”)

Main Functions

Intelligent Date Parsing

Automatically convert relative dates (such as “tomorrow”, “next Wednesday”) mentioned by users into accurate date formats to ensure query accuracy.

Multi - dimensional Station Query

Support multiple query methods, such as querying all stations by city name, obtaining representative station codes by city name, and querying codes by specific station names.

Real - time Remaining Ticket Query

Query the remaining ticket information of train tickets for a specified date, departure place, and destination, including train numbers, seat types, fares, and the number of remaining tickets.

Intelligent Transfer Scheme

When direct tickets are sold out, provide transfer scheme queries to help users find feasible travel routes.

Train Details Query

Query the detailed stop - over information of a specific train within a specified section, including arrival time, departure time, and stop time.

Standardized Interface

Based on the MCP protocol, provide a standardized tool call interface for AI assistants to ensure compatibility and ease of use.

Advantages

No manual operation required: The AI assistant calls automatically, and users only need to ask questions in natural language.

Accurate information: Based on official 12306 data to ensure information reliability.

Comprehensive functions: Cover various query functions required for the entire ticket - purchasing process.

Easy to integrate: Support multiple MCP connection methods (SSE, HTTP, STDIO).

Intelligent processing: Automatically handle complex logic such as date conversion and station code mapping.

Limitations

API key required: You need to register with Xiaobenyang Technology to obtain the XBY - APIKEY.

Transfer query limitation: Currently, only the top ten transfer schemes can be queried.

Network dependence: A stable network connection is required.

No direct ticket purchase: Only provide query functions, not including payment and ticket issuance.

AI assistant support required: Must be used in an AI environment that supports MCP.

How to Use

Get an API Key

Visit the Xiaobenyang Technology website (https://xiaobenyang.com) to register an account and obtain your XBY - APIKEY.

Configure the MCP Server

In the configuration file of the AI assistant you are using (such as Claude Desktop), add this service according to the configuration example provided in the README. Select one of the connection methods: SSE, Streamable HTTP, or STDIO.

Restart the AI Assistant

After saving the configuration file, restart your AI assistant application to ensure that the configuration takes effect.

Start Using

Now you can directly ask questions related to train tickets in natural language, and the AI assistant will automatically call this service to obtain the latest information.

Usage Examples

Example 1: Query Direct Tickets

A user wants to query high - speed train tickets from Beijing to Shanghai tomorrow.

Example 2: Query City Stations

A user wants to know which railway stations there are in Wuhan.

Example 3: Query Train Details

A user wants to know the stop - over stations of Train G1.

Example 4: Query Transfer Schemes

Direct tickets are sold out, and the user needs transfer schemes.

Frequently Asked Questions

Is this service free?

Is the data real - time?

Which AI assistants are supported?

How far in advance can I query tickets?

Why does the transfer query only show the top ten results?

How can I test if the tool is working properly?

Related Resources

Xiaobenyang Technology Official Website

Online Testing Tool

Test all tool functions online

MCP Protocol Documentation

Understand the technical specifications of the Model Context Protocol

12306 Official Website

The official ticketing website of Chinese railways

🚀 12306 Ticket Purchase Search Server

This is a 12306 ticket purchase search server based on Model Context Protocol (MCP). It offers a simple API interface, enabling large models to search for 12306 ticket purchasing information via this interface.

✨ Features

Tool List

This MCP service encapsulates the following tools, allowing models to invoke the following functions through a standardized interface.

Tool	Description
get-current-date	Get the current date in the Shanghai time zone (Asia/Shanghai, UTC+8), with the return format being "yyyy-MM-dd". It is mainly used to parse relative dates mentioned by users (e.g., "tomorrow", "next Wednesday") and provide accurate date inputs.
get-stations-code-in-city	Query the names of all railway stations in a city and their corresponding `station_code` by the Chinese city name. The result is a list containing information about multiple stations.
get-station-code-of-citys	Query the `station_code` representing a city by the Chinese city name. This interface is mainly used to prepare the `station_code` parameter for the interface when the user provides the city name as the departure or arrival location.
get-station-code-by-names	Query the `station_code` and station name of a specific railway station by its Chinese name. This interface is mainly used to prepare the `station_code` parameter for the interface when the user provides the specific station name as the departure or arrival location.
get-station-by-telecode	Query the detailed information of a railway station, including its name, pinyin, and the city it belongs to, by the `station_telecode` of the station. This interface is mainly used to obtain more complete station data when the `telecode` is known, or for special queries and debugging purposes. It is less likely to be directly triggered in the general user conversation process.
get-tickets	Query the remaining ticket information on 12306.
get-interline-tickets	Query the transfer ticket information on 12306. Currently, only the top ten results are supported.
get-train-route-stations	Query detailed stop information such as the stations passed by a specific train on a specified section, the arrival time, departure time, and stop time. This interface is used when the user asks about the stops of a specific train.

📋 Inspector

Online Tool test: https://mcp.xiaobenyang.com/inspector/1777316659202051

📦 Installation

How to get XBY-APIKEY?

Visit the XiaoBenYang website https://xiaobenyang.com, register and get the APIKEY.

SSE

{
  "mcpServers": {
    "12306购票搜索服务器": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "sse",
      "url": "https://mcp.xiaobenyang.com/1777316659202051/sse"
    }
  }
}

STREAMABLE HTTP

{
  "mcpServers": {
    "12306购票搜索服务器": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "streamable_http",
      "url": "https://mcp.xiaobenyang.com/1777316659202051/mcp"
    }
  }
}

STDIO

{
    "mcpServers": {
        "12306购票搜索服务器": {
          "command": "npx",
          "args": [
            "-y",
            "xiaobenyang-mcp"
          ],
          "env": {
            "XBY_APIKEY": "<YOUR_XBY_APIKEY>",
            "mcpId": "1777316659202051",
          },
          "transport": "stdio"
        }
      }
}