Cruise Itinerary

com.cruise-itineraryv1.0.0更新于 Oct 4, 2026

Cruise sailings, itineraries, weekly fare history, port capacity and the Cruise Price Index.

已验证Streamable HTTP可网页运行Location & LifestyleData & Analytics

概览

AI 生成的概览

让助手查询真实邮轮数据：航次、逐日行程、每周票价历史、港口运力和邮轮价格指数。

功能
这是一个只读的远程 MCP 服务器，提供邮轮数据。工具可将港口、船只和邮轮公司名称解析为其他工具所需的 id，按船只、公司、港口、地区、日期、航程长度和票价搜索即将出发的航次，返回某航次的逐日行程或某邮轮的停靠港列表，显示某航次的每周票价快照，报告某港口逐月的船日、不同船只数和床位运力，并返回每周邮轮价格指数。每个工具返回与对应 REST 端点相同的 JSON。
适用场景
适合需要调研邮轮的场景：哪些航次停靠某港口、某船只的逐日行程、某航次票价逐周变化、某港口每月有多少运力到达，以及整体票价走势。
运行要求
远程端点 cruise-itinerary.com/mcp，无需本地运行。每个请求（包括 initialize）都需要账户：通过 MCP OAuth 2.1 与 PKCE 以邮件链接登录；不支持 OAuth 的客户端可在 Authorization Bearer 请求头中发送仪表盘生成的 API 密钥。免费账户每月 500 次调用，部分工具需要 Developer 或 Business 套餐。
安装前请注意
每次成功的工具调用都计为一次 API 调用并占用套餐额度，超出套餐的工具会返回提示和定价链接。工具名称及其参数（港口、船只或公司名称、日期、id）会随访问令牌发送到 cruise-itinerary.com，用于应答、计费和限流。请勿将 API 密钥放入共享文件。票价为每周一快照，并非实时或可预订价格；空票价不说明是未提供还是售罄，标记为 estimated 的行程日可能相差一天，部分邮轮公司未覆盖。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Cruise Itinerary，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://cruise-itinerary.com/mcp"
    }
  }
}

README

Cruise Itinerary for Claude, ChatGPT and other MCP clients

[Cruise Itinerary]

Ask an AI assistant about cruises and get answers from real data: which sailings call at a port, what a ship's itinerary looks like day by day, how a sailing's fare has moved week by week, how much ship capacity reaches a port each month, and how cruise prices are trending overall.

This repository holds:

  • the connection details for the Cruise Itinerary remote MCP server at https://cruise-itinerary.com/mcp,
  • a Claude plugin that adds that server plus a cruise-research skill, which teaches Claude the data's caveats,
  • server.json, the server's entry for the official MCP Registry.

The server is run by Cruise Itinerary (Agile Travel Group, Inc., operated as Cruiseable). The data is the same as its REST API: API docs, MCP docs.

What you can ask

  • "Which sailings call at Juneau in July 2027, cheapest balcony first?"
  • "Show me the day-by-day itinerary of that sailing."
  • "Has the fare on this sailing gone up or down since September?"
  • "How many berths of ship capacity reach Cozumel each month next winter?"
  • "What does the Cruise Price Index say about fares this month?"

Tools

All tools are read-only (readOnlyHint: true). Each returns the same JSON as the matching REST endpoint, as structuredContent with an outputSchema.

ToolWhat it answersMinimum plan
resolve_entityA port, ship or cruise line name, however spelt, to the id the other tools takeFree
cruise_price_indexThe weekly Cruise Price Index: latest 12 weeks (Free), or a full series by line, cabin and segment (Business)Free / Business
search_sailingsUpcoming sailings by ship, line, port, departure port, region, dates, length and fare, with the latest weekly faresDeveloper
get_itineraryA sailing's dated day-by-day itinerary, or a cruise's stop listDeveloper
get_price_historyEvery weekly fare snapshot of one sailingBusiness
port_month_capacityShip-days, distinct ships and berths at one port, month by monthBusiness

A free account (an email address, no card) includes 500 calls a month. Every successful tool call counts as one API call. A tool above your plan answers with a short message and a link to pricing.

Setup

Claude (claude.ai, Desktop, mobile)

Add it as a connector: Customize → Connectors → Add custom connector, name it Cruise Itinerary, and paste https://cruise-itinerary.com/mcp. Claude detects the OAuth sign-in and asks you to sign in when you add it: enter your email, open the link we send, then approve the connection.

To get the cruise-research skill as well, install this repository as a plugin (below) or from the Claude directory once it is listed.

Claude Code

As a plugin (server and skill):

/plugin marketplace add BigBalli/cruise-itinerary-mcp/plugin install cruise-itinerary@cruise-itinerary

Or the server only:

claude mcp add --transport http cruise-itinerary https://cruise-itinerary.com/mcp

Then run /mcp and choose cruise-itinerary to sign in.

ChatGPT

Add a custom app (connector) with the URL https://cruise-itinerary.com/mcp and OAuth authentication. Until the listing appears in the ChatGPT directory, this needs developer mode.

Cursor, VS Code, Windsurf and other clients

Point the client at the URL. Clients that support MCP OAuth sign in in the browser:

json
{  "mcpServers": {    "cruise-itinerary": {      "url": "https://cruise-itinerary.com/mcp"    }  }}

Clients without OAuth can send an API key from your dashboard as a header instead. Keep the key out of shared files.

json
{  "mcpServers": {    "cruise-itinerary": {      "url": "https://cruise-itinerary.com/mcp",      "headers": { "Authorization": "Bearer <your API key>" }    }  }}

How sign-in works

The server follows the MCP authorization specification: OAuth 2.1 with PKCE (S256), protected resource metadata at https://cruise-itinerary.com/.well-known/oauth-protected-resource/mcp, and an authorization server at https://cruise-itinerary.com that supports Client ID Metadata Documents and dynamic client registration. Sign-in is by email link; a new address gets a free account. You approve each app on a consent page that shows which app is asking and where it returns you. Access tokens last an hour and refresh tokens rotate on use. Connecting never shares your API keys, email address or billing with the app, and the app can only read.

Every request needs an account, initialize included: without a token the server answers 401 with a WWW-Authenticate header pointing at the protected resource metadata, which is how clients know to start sign-in.

Read the data the right way

  • Fares are weekly snapshots captured every Monday since 6 September 2026, not live or bookable prices. meta.as_of gives the load date.
  • A missing (null) fare means the cabin was not offered or was sold out; the data does not say which.
  • Itinerary days marked estimated were placed from the distance between ports and can be off by a day. exact days come from the cruise line's published itinerary.
  • Port capacity is monthly only, and berths are ship capacity, not passengers.
  • Coverage is strongest for North American cruise lines. TUI Cruises/Marella, AIDA, Saga, Fred. Olsen and Hapag-Lloyd are not covered.

Data and privacy

The plugin contains no code that runs on your machine. It declares one remote MCP server, https://cruise-itinerary.com/mcp, and one skill made of instructions. When your assistant calls a tool, the tool name and its arguments (names of ports, ships or lines, dates, ids) go to cruise-itinerary.com with your access token. They are used to answer the call, count it toward your plan and enforce rate limits. Nothing else is sent, and nothing is sent anywhere else.

License

MIT, see LICENSE. The data served by the API is covered by the Cruise Itinerary terms, not by this license.

来源：README.md，提交 fb8c844

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Oct 4, 2026