VoyageHacks

com.voyagehacks由 voyagehacks.com 發布官方發布者v2.1.0更新於 Oct 24, 2026

Multilingual travel guides, gear picks and booking links for AI travel agents.

已驗證Streamable HTTP可網頁執行位置與生活網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

VoyageHacks 為助理提供多語言旅遊指南、裝備推薦,以及機票、飯店、租車、接送、eSIM 和 VPN 的聯盟搜尋連結。

可以做什麼
  • 搜尋與閱讀指南:在每種語言約 680 篇經事實查核的文章中全文檢索,並把任一頁面以 Markdown 取回,附標題、欄位與日期
  • 搜尋與推薦旅遊裝備:瀏覽約 320 項產品的目錄,並依行程描述產生打包裝備清單
  • 產生預訂搜尋連結:機票、飯店(另含 Expedia、Vrbo、Agoda、IHG)、汽車與機車租賃、機場接送、eSIM、VPN 及信用卡頁面
  • 一次呼叫彙整整趟行程的預訂連結,或依月份、旅遊類型、預算和同行者產生三個目的地建議
  • 提供 where_to_go、plan_trip、pack_for_trip 等內建提示詞,支援十種語言
適用情境
適合助理回答旅遊問題、需要引用編輯類指南、推薦裝備,或提供機票、住宿、租車與上網的預填搜尋連結時使用。也適合從月份、預算和旅遊風格出發的行程規劃對話。
執行需求
遠端 Streamable HTTP 端點 voyagehacks.com/mcp,無需驗證、API 金鑰或本機執行環境。可選 research、guides 等設定檔以限制開放的工具。每個 IP 約每分鐘 90 次請求的限流。
安裝前請注意
VoyageHacks 由聯盟行銷資助:許多預訂與購物連結為聯盟連結,發布方可能獲得佣金,回應中會加以揭露。信用卡工具連結到金融商品申請頁,VPN 工具連結到訂閱註冊頁。不提供即時票價、房價或可訂狀態,也不執行預訂或付款。裝備資料不含價格、評分或庫存。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 VoyageHacks,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.voyagehacks%2Ftravel/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "voyagehacks": {
      "type": "http",
      "url": "https://voyagehacks.com/mcp"
    }
  }
}

README

VoyageHacks MCP Server

The official Model Context Protocol server for VoyageHacks.com, a travel publisher with about 680 fact-checked guides in each of 10 languages, covering flights, airline reviews, hotels, destinations, car rental, trains, airport transfers, eSIM, travel VPN, travel credit cards and travel gear.

Live endpoint: https://voyagehacks.com/mcp Version: 2.3.0 Docs: https://voyagehacks.com/en/mcp-server/

Stateless Streamable HTTP transport (JSON-RPC 2.0 over POST, single JSON responses, no SSE, no sessions), no authentication. Any MCP client can connect and start calling tools immediately. A GET returns 405 by design: the server offers no SSE stream, which is what the Streamable HTTP specification asks for in that case.

Listed on the official MCP Registry as com.voyagehacks/travel.

Connect

Claude Code

bash
claude mcp add --transport http voyagehacks https://voyagehacks.com/mcp

Claude.ai / Claude Desktop: Settings, Connectors, Add custom connector, https://voyagehacks.com/mcp, authentication "No authentication".

ChatGPT: Settings, Connectors, add https://voyagehacks.com/mcp, no auth.

Perplexity (Pro, Max, Enterprise): Settings, Connectors, Custom connector, Remote, https://voyagehacks.com/mcp, authentication "None".

Gemini Enterprise: create a custom MCP server data store with the HTTPS endpoint and "No Authentication". The transport is StreamableHTTP, which is what Gemini Enterprise requires.

MCP Inspector

bash
npx @modelcontextprotocol/inspector

Tools

All twelve are read-only, annotated readOnlyHint: true and destructiveHint: false, and have no side effect outside their response. Each declares an outputSchema and returns structuredContent alongside readable text.

ToolWhat it does
search_articlesFull-text search over the guides in one language, with an optional section filter
get_articleOne page as Markdown, plus its title, language, section, publication date and last-updated date read from the page itself
search_travel_gearSearch the VoyageHacks travel gear catalog, about 320 products picked across roughly 50 published buying guides
recommend_travel_gearTurn a trip description into a packing kit, one product per category, with optional structured hints
get_flight_linksFlight search links for a route and dates
get_hotel_linksHotel search links for a city, dates, guests and rooms
get_car_rental_linksCar and scooter rental comparison links
get_airport_transfer_linksAirport taxi and pre-booked transfer links
get_esim_linksTravel eSIM store links for a destination
get_travel_vpn_linksTravel VPN links
get_credit_card_linksOfficial American Express Germany and Revolut pages, plus verified German fee figures (no referral links)
get_booking_linksSeveral categories of one trip in a single call, filtered by include
find_destinationThree destinations for a month, trip type, budget and party, with guides, dated hotel and flight links and packing picks; takes a nightly hotel range (budget) or a whole-trip total (trip_budget, flights plus hotel) and nights, and returns the open questions when the month or trip type is missing

get_hotel_links also returns the same search on Expedia, Vrbo and Agoda (Stay22). Gear products link to their card on the VoyageHacks guide that reviews them (productUrl, <guide>#p-<asin>), never straight to Amazon: Amazon's policies allow tagged links only on the publisher's own site.

In-chat trip finder (MCP Apps)

find_destination declares an MCP Apps view, ui://voyagehacks/trip-finder.html (functions/_mcp-app.js). Hosts that render MCP Apps (Claude, ChatGPT, VS Code and others) show three destination cards and a quiz that re-runs the tool through the host. It follows the host's light or dark theme and opens links with ui/open-link. Other clients get the same answer as text.

Prompts

where_to_go, plan_trip and pack_for_trip, listed by clients that show MCP prompts as slash commands.

Every vertical tool also returns up to 4 matching VoyageHacks guides in the requested language, so agents can cite full articles alongside the links.

Languages: en, de, fr, es, it, pl, cs, ja, nl, pt, zh. Every tool takes a lang parameter, defaulting to en. Each language is an independently written version of the guide, not a machine translation.

Profiles

ProfileEndpointTools
full (default)https://voyagehacks.com/mcp13
researchhttps://voyagehacks.com/mcp?profile=research11
guideshttps://voyagehacks.com/mcp?profile=guides5

The research profile omits get_travel_vpn_links and get_credit_card_links, whose links land on a subscription signup and a financial-product application. It exists for app directories whose guidelines restrict linking to pages that initiate a subscription or purchase.

The guides profile goes further and omits every booking tool, leaving search_articles, get_article, search_travel_gear, recommend_travel_gear and find_destination, which there returns picks, guides and packing picks with no booking links. Its products link to the VoyageHacks guides, which sell physical travel gear on Amazon, so it satisfies directories that allow commerce for physical goods only. It also serves its own initialize instructions, which describe the five tools it actually has rather than the full thirteen.

Each profile is addressable two ways: /mcp?profile=guides and /mcp/guides are the same handler. The path form exists because the OpenAI plugin submission portal rejects a query string in its MCP Server URL field.

An unrecognized profile, in either form, falls back to the full tool set, so a typo can never silently serve fewer tools than intended.

What it does not do

The server returns published editorial content and search links. It has no live fares, no live room rates, no availability check, no star ratings or review counts, and it cannot make a booking or take a payment.

The travel gear catalog is VoyageHacks' own editorial selection, not a search of all of Amazon. It carries no prices, ratings, review counts or stock: the Amazon Product Advertising API is not enabled for this account, so any such value would be invented. The tools never return those fields.

Limits

About 90 requests per minute per IP, 256 KB per request body, 25 messages per JSON-RPC batch, articles truncated at 60,000 characters. Over the rate limit the server returns HTTP 429 with Retry-After. See SECURITY.md.

Markdown for agents

The whole site is agent-readable, not just this server:

Transparency

VoyageHacks is an affiliate-funded publisher. Some booking and shopping links returned by these tools are affiliate links (Booking.com and other advertisers through CJ Affiliate, Travelpayouts, Stay22). No Amazon or referral link appears in tool output. VoyageHacks may earn a commission from qualifying bookings or purchases at no additional cost to the user.

Every commercial tool states this in its description, and every commercial response repeats it in both its text content and structuredContent.disclosure, so an assistant can disclose it to the end user. The word "affiliate" is kept out of tool name and title values because agents route on those strings and it measurably suppresses selection; it belongs in the description and the response, which is where disclosure obligations actually attach.

Article content is free to read, with no paywall and no authentication.

Self-hosting

This is a Cloudflare Pages Function (functions/mcp.js). To run your own instance:

  1. Deploy the functions/ directory with a Cloudflare Pages project.
  2. The server reads its content live from the site it fronts: a Hugo build that emits /<lang>/index.json (search index) and /<lang>/gear.json (gear catalog). Point the SITE constant at your deployment.
  3. Replace the affiliate constants near the top of mcp.js (Travelpayouts marker, CJ ids, Stay22 aid) with your own program ids. find_destination also reads the trip finder data block from /<lang>/trip-finder/ and the shared matching rules in assets/js/trip-match.mjs. For whole-trip budgets it prices flights with functions/_fares.js (Travelpayouts Data API); set a TP_TOKEN secret on the project, or the fare lookup is skipped and only the hotel side is budgeted.

This repository mirrors the production function. The only intentional difference is the htmlToMarkdown import: production imports htmlToMarkdown from the site's _middleware.js, this mirror from its own html-to-markdown.js. If you fork it, keep the affiliate constants in sync with your own site config.

Privacy, terms and support

License

MIT

來源:README.md,提交 5ebeb34

工具

13

search_articles

Search VoyageHacks travel guides

Full-text search across the VoyageHacks travel guides, about 680 published pages per language, covering flights, airline reviews, hotels, destinations, car rental, trains, airport transfers, eSIM, travel VPN, travel credit cards, travel gear and month-by-month "where to go" guides. Returns ranked matches with the title, canonical URL, section and a matching excerpt for each. Useful when a travel question needs published prices, comparisons, best-time-to-visit advice or step-by-step detail that can be attributed to a source URL. It searches VoyageHacks content only: not the wider web, not live fares or hotel availability, and it returns no booking or product links (the get_..._links tools do that).

輸入參數langlimitquery必填section

get_article

Read a VoyageHacks guide as Markdown

Fetch one VoyageHacks page by URL or site path (for example "/en/hotels/best-budget-hotels-in-rome/") and return its body as Markdown, together with the title, canonical URL, language, section, publication date and last-updated date read from the page itself. Useful when the full text of a guide is needed to quote figures accurately, and when a source needs to be cited with a real date. Only HTML pages on voyagehacks.com can be read: the tool cannot fetch other websites, data files or images, and very long pages are truncated with a marker at the cut.

輸入參數url必填

search_travel_gear

Search the VoyageHacks travel gear catalog

Search the VoyageHacks travel gear catalog: about 320 products that appear as picks in roughly 50 published buying guides, including carry-on backpacks, packing cubes and compression bags, universal travel adapters, GaN chargers, airline-compliant power banks, luggage trackers, neck pillows, earplugs and eye masks, toiletry and makeup bags, travel-size bottles, travel routers, translation earbuds and camping and outdoor gear. Each result returns the product name, its category, the published reason it was picked, its Amazon ASIN and a link to the product on the VoyageHacks buying guide that reviews it, where it can be bought on Amazon. Useful when a user asks which travel product to buy, or what to pack for a trip and names a category or a destination. This is the VoyageHacks editorial catalog, not a search of all of Amazon: products outside the published guides are not findable here, and prices, star ratings, review counts and stock are not available and are never returned. The guides carry Amazon affiliate links: VoyageHacks may earn a commission from qualifying purchases at no additional cost to the buyer, which should be disclosed when the products are presented.

輸入參數langlimitquery必填

recommend_travel_gear

Build a travel gear kit for a trip

Turn a trip description into a packing and gear kit drawn from the VoyageHacks travel gear catalog: one product per category, each with the published reason it was picked, its Amazon ASIN and a link to the product on the VoyageHacks guide that reviews it, where it can be bought on Amazon. Takes a plain-language trip summary ("10 days in Japan in October, carry-on only, long-haul red-eye, working remotely") plus optional structured hints (destination, trip length in days, season, activities, luggage constraint, traveler type, budget), all of which are used to weight which categories make the kit. Answers questions of the form "what should I pack for X", "what gear do I need for Y" and "I only have carry-on, what should I bring". It draws on the VoyageHacks editorial catalog, not a search of all of Amazon, and returns published picks only: prices, star ratings, review counts and stock are not available and are never returned, and it produces no clothing sizes and no itinerary. The guides carry Amazon affiliate links: VoyageHacks may earn a commission from qualifying purchases at no additional cost to the buyer, which should be disclosed when the products are presented.

輸入參數langtrip必填limitbudgetseasonluggageactivitiesdestinationtraveler_typetrip_length_days

find_destination

Suggest where to travel for a month and trip type

Suggest three destinations for a trip from five answers: the month (or "flexible"), the kind of trip (beach, city break, hiking, ski, road trip, adventure or working remotely), the budget, who is travelling and, optionally, the departure airport. Picks come only from VoyageHacks' own where-to-go month guides and travel-style lists, with the average high temperature each month guide states, the reasons it fits, the destination guide to cite, and booking links for that trip: hotels and flights dated in the chosen month, plus tours, car rental or an eSIM where they fit. This is the same matching as the trip finder on voyagehacks.com. Useful when a user asks where to go, for holiday ideas for a month, or for a destination that suits a family, a couple or a budget. Each answer also carries three packing picks for that kind of trip, linked to the VoyageHacks buying guides. When the month or the trip type is missing it returns no picks, only the questions that are still open with their allowed answers (needsInput). It does not return live prices or availability and cannot book. Affiliate links: VoyageHacks may earn a commission at no additional cost to the traveler, which should be disclosed when the links are presented.

輸入參數langmonthbudgetorigincountrytravelerstrip_type

版本歷史

1
  1. v2.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分