# travel-deals-mcp

travel-deals-mcp enables AI agents to find resort packages and vacation bundles in real time. Provides direct booking links without web searching.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 589 installs
- Author: shokjak
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shokjak/travel-deals-mcp
- Updated: 2026-04-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/travel-deals-mcp

## What it does

This remote MCP server links coding assistants and agents to a curated catalog of vacation packages. Instead of scraping browser pages, the assistant pulls structured vacation options directly through API tools.

Under the hood, the backend uses Python and a MySQL database storing listings, destinations, and affiliate tracking data. It exposes six specific tools: `search_deals`, `get_deal`, `list_deal_types`, `list_tags`, `list_countries`, and `get_stats`.

Because the integration connects over HTTP, your assistant relies entirely on network reachability to the hosted endpoint.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://travel-deals-mcp--shokjak.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http travel-deals-mcp https://travel-deals-mcp--shokjak.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add travel-deals-mcp --url https://travel-deals-mcp--shokjak.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "travel-deals-mcp": {
            "url": "https://travel-deals-mcp--shokjak.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "travel-deals-mcp": {
            "type": "http",
            "url": "https://travel-deals-mcp--shokjak.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http travel-deals-mcp https://travel-deals-mcp--shokjak.run.tools
```

## When to use it
- find resort vacation packages through agent prompts
- retrieve direct booking links for specific travel offers
- inspect supported destinations and categories before searching
- pull deal counts and catalog metrics using get_stats

## Example prompts
- Find resort vacation packages in Spain using search_deals
- Check what countries and tags are available with list_countries and list_tags
- Fetch the full details and booking link for this package ID with get_deal

## Similar
- [MAQAMI Travel](https://affpapa.org/en/nevibecode/mcp/maqami-travel.md) — MCP server · 3255 installs
- [FlyBest Travel — Hotel Booking with Advisor Benefits](https://affpapa.org/en/nevibecode/mcp/flybest-travel-hotel-booking-with-advisor-benefits.md) — MCP server · ★ 3 repo stars
- [aura.travel stays](https://affpapa.org/en/nevibecode/mcp/auratravel-stays.md) — MCP server
- [Departi – Travel Compliance & Curated Booking](https://affpapa.org/en/nevibecode/mcp/departi-travel-compliance-curated-booking.md) — MCP server
- [travel-search-and-booking-api-and-skills](https://affpapa.org/en/nevibecode/plugins/travel-search-and-booking-api-and-skills.md) — plugin · ★ 1295 repo stars
- [maqami-travel](https://affpapa.org/en/nevibecode/plugins/maqami-travel.md) — plugin · ★ 1596 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
