# rendezvous-mcp

Calculates equitable meeting locations for 2 to 10 people using actual travel times and reachability zones instead of naive geographic midpoints.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: forgesworn
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/forgesworn/rendezvous-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/rendezvous-mcp

## What it does

This server connects AI assistants to Valhalla routing and OpenStreetMap data. It exposes tools like `search-venues` to discover nearby spots, `get-isochrone` to map travel limits by minutes, `get-directions` for turn-by-turn guidance, and `score-venues` to rank candidate spots by how evenly travel durations are shared across the group.

Public routing operates out of the box via `routing.trotters.cc` without registration keys. When free tier requests are depleted, tools respond with a Lightning invoice requiring L402 tokens stored via `store-routing-credentials`. Running your own internal Valhalla node bypasses these fees when configured through the `VALHALLA_URL` setting.

The package operates over standard `stdio` or runs as a streaming HTTP server on port 3002 for remote connections.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VALHALLA_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env VALHALLA_URL=<VALHALLA_URL> --transport stdio rendezvous-mcp -- npx -y rendezvous-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add rendezvous-mcp --env VALHALLA_URL=<VALHALLA_URL> -- npx -y rendezvous-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rendezvous-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "rendezvous-mcp"
            ],
            "env": {
                "VALHALLA_URL": "<VALHALLA_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "rendezvous-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "rendezvous-mcp"
            ],
            "env": {
                "VALHALLA_URL": "<VALHALLA_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VALHALLA_URL=<VALHALLA_URL> rendezvous-mcp npx -y rendezvous-mcp
```
Replace <…> with your own values

## When to use it
- Find balanced group meeting spots based on actual travel durations
- Locate candidate venues via OpenStreetMap around target coordinates
- Generate reachability polygons for a set time window
- Provide turn-by-turn navigation instructions to selected locations

## Example prompts
- Suggest a fair lunch spot between Oxford and Reading so neither person travels noticeably longer
- Map out everywhere reachable from downtown within thirty minutes
- Rank these candidate venues by travel fairness for three people coming from different towns

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

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