VoyageHacks MCP Server

The official Model Context Protocol server for VoyageHacks.com, a multilingual (10 languages) travel site covering flights, hotels, destinations, eSIMs, travel VPNs, credit cards and travel gear.

Live endpoint: https://voyagehacks.com/mcp

Stateless Streamable HTTP transport (JSON-RPC 2.0 over POST), no authentication, no sessions. Any MCP client can connect and start calling tools immediately.

Connect

Claude Code

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

Claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → https://voyagehacks.com/mcp

ChatGPT: Settings → Connectors → Advanced → Developer mode, then add https://voyagehacks.com/mcp as an MCP connector (no auth).

MCP Inspector

npx @modelcontextprotocol/inspector https://voyagehacks.com/mcp

Tools

Tool	What it does
search_articles	Full-text search over all articles in a given language
get_article	Fetch one article as clean Markdown
search_travel_gear	Search the travel gear catalog (products from every gear guide)
recommend_travel_gear	Map a free-text trip description to a packing kit
get_flight_links	Flight search links for a route or destination
get_hotel_links	Hotel search links for a city
get_car_rental_links	Car rental links
get_airport_transfer_links	Airport taxi / transfer links
get_esim_links	Travel eSIM links for a destination
get_travel_vpn_links	Travel VPN links
get_credit_card_links	Travel credit card referral links
get_booking_links	Everything for one trip in a single call

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

Markdown for agents

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

• get_article returns any page as Markdown.
• Any page on voyagehacks.com returns Markdown directly when requested with an Accept: text/markdown header (edge middleware, browsers are unaffected).
• Discovery files: /.well-known/mcp/server-card.json, /llms.txt, /.well-known/agent-skills/.

Transparency

VoyageHacks is an affiliate-funded site. Booking and shopping links returned by these tools are tracked affiliate links (Travelpayouts, CJ Affiliate / Booking.com, Amazon Associates, American Express referrals). Every tool response ships a DISCLOSURE field stating this, and tool descriptions say it plainly. Article content itself is free to read, with no paywall and no auth.

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 (marker, CJ ids, Amazon tag) with your own program ids.

This repository mirrors the production function. Keep the affiliate constants in sync with your own site config if you fork it.

License

MIT