# VoyageHacks [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/voyagehacks-com/mcp-server  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/voyagehacks

## Description
Travel guides plus flight, hotel, eSIM, car rental and gear links in 11 languages.

## Tools
Capabilities this server exposes over MCP:

- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "voyagehacks": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"]
  }
}
```

## Documentation & README

# VoyageHacks MCP Server

The official [Model Context Protocol](https://modelcontextprotocol.io) server for
[VoyageHacks.com](https://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**

```bash
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**

```bash
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`](https://voyagehacks.com/.well-known/mcp/server-card.json),
  [`/llms.txt`](https://voyagehacks.com/llms.txt),
  [`/.well-known/agent-skills/`](https://voyagehacks.com/.well-known/agent-skills/index.json).

## 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](https://github.com/voyagehacks-com/mcp-server/blob/HEAD/LICENSE)