tripz-mcp

MCP server for tripz.to — plan trips, check visas, manage group expenses, and invite friends through AI assistants.

Works with any AI client that supports the Model Context Protocol: Claude Desktop, Cursor, Windsurf, VS Code (Copilot), Cline, Claude Code, and others.

Quick Start

npx tripz-mcp

No API key needed for visa checks and country exploration. Add your key for trip management and social features.

Setup

Claude Desktop

Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tripz": {
      "command": "npx",
      "args": ["tripz-mcp"],
      "env": {
        "TRIPZ_API_KEY": "trpz_your_api_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "tripz": {
      "command": "npx",
      "args": ["tripz-mcp"],
      "env": {
        "TRIPZ_API_KEY": "trpz_your_api_key_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "tripz": {
      "command": "npx",
      "args": ["tripz-mcp"],
      "env": {
        "TRIPZ_API_KEY": "trpz_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add tripz -- npx tripz-mcp

Then set TRIPZ_API_KEY in your environment or in .claude/settings.json.

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "tripz": {
      "command": "npx",
      "args": ["tripz-mcp"],
      "env": {
        "TRIPZ_API_KEY": "trpz_your_api_key_here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | TRIPZ_API_KEY | For social features | — | Your API key from tripz.to/settings | | TRIPZ_API_URL | No | https://api.tripz.to | API base URL |

What Can You Do?

Ask your AI assistant things like:

• "Where can I travel visa-free with a US passport?"
• "Compare visa requirements for Thailand — I have UZ and RU passports"
• "Create a trip to Southeast Asia for July 2026 and invite my friends"
• "Add a $50 dinner expense to our Bangkok trip, split equally"
• "Who owes whom in our trip?"

Tools

Public (no API key needed)

| Tool | Description | |------|-------------| | check_visa | Check visa requirements for passport holders visiting any country | | visa_free_destinations | Find top visa-free and easy-access destinations for your passports | | compare_passports | Get the full outbound visa map for a specific passport | | explore_country | Detailed country info — visa, cost of living, weather, airports | | find_airports | Search airports by name, city, or IATA code | | list_countries | Full list of all countries with codes and regions |

Authenticated (API key required)

| Tool | Description | |------|-------------| | my_profile | Your tripz.to profile and passport countries | | create_trip | Create a new trip with itinerary | | list_trips | List your trips, filter by status | | get_trip | Full trip details with members and legs | | invite_friend | Invite a friend to a trip by user ID | | invite_by_email | Invite someone to a trip by email | | add_expense | Add a shared expense with flexible splitting | | expense_summary | See who owes whom in a trip | | list_friends | List your friends and their user IDs |

Resources

| URI | Description | |-----|-------------| | tripz://countries | All countries with ISO codes | | tripz://regions | World regions and subregions | | tripz://visa-types | Visa type explanations |

Prompts

| Prompt | Description | |--------|-------------| | plan-trip | Step-by-step travel planning: visa check, destination discovery, itinerary | | group-trip | Group trip: find visa-free overlap for all passports, create trip, invite friends |

Getting an API Key

1. Sign up at tripz.to
2. Go to Settings > API Keys
3. Create a new key (starts with trpz_)
4. Add it to your MCP server config

License

MIT