rendezvous-mcp
Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2
Fair meeting points for AI — isochrone-based fairness, not naive midpoints.
MCP server for AI-driven meeting point discovery. Give your AI the ability to answer "where should we meet?" using real travel times, venue availability, and fairness algorithms.
Works out of the box — free public routing, no API keys needed. Self-host Valhalla for unlimited queries, or use L402 Lightning credits for our hosted endpoint.
| Tool | Description |
|---|
score-venues | Score candidate venues by travel time fairness for 2–10 participants |
search-venues | Search for venues near a location using OpenStreetMap |
get-isochrone | Get a reachability polygon (everywhere reachable within N minutes) |
get-directions | Get directions between two points with turn-by-turn steps |
store-routing-credentials | Store L402 macaroon + preimage after Lightning payment |
Quick start
Add to your MCP client config (Claude Code, Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"rendezvous": {
"command": "npx",
"args": ["rendezvous-mcp"]
}
}
}
Then ask your AI: "Where's a fair place for Alice in London, Bob in Bristol, and Carol in Birmingham to meet for lunch?"
Remote (HTTP/SSE)
For ChatGPT, remote AI agents, or any client that connects over HTTP:
TRANSPORT=http npx rendezvous-mcp
Starts a Streamable HTTP server on port 3002 with the MCP endpoint at /mcp.
ChatGPT connector
In ChatGPT settings, add an MCP server with:
- URL:
http://your-host:3002/mcp
- Transport: Streamable HTTP
Configuration
| Variable | Default | Description |
|---|
TRANSPORT | stdio | Transport mode: stdio or http |
PORT | 3002 | HTTP server port (HTTP mode only) |
HOST | 0.0.0.0 | HTTP bind address (HTTP mode only) |
VALHALLA_URL | https://routing.trotters.cc | Routing engine URL |
OVERPASS_URL | Public endpoints | Venue search API |
Self-hosted routing
For unlimited queries with no rate limits, run your own Valhalla instance:
{
"mcpServers": {
"rendezvous": {
"command": "npx",
"args": ["rendezvous-mcp"],
"env": {
"VALHALLA_URL": "http://localhost:8002"
}
}
}
}
How it works
- User asks "Where should we meet?"
- AI geocodes participant locations
- AI calls
search-venues to find candidate venues near the area
- AI calls
score-venues with participants + candidates — returns ranked results with travel times and fairness scores
- AI presents the fairest option with travel times for each person
For deeper analysis, the AI can use get-isochrone to visualise reachability and get-directions for turn-by-turn navigation.
L402 payments
The default routing endpoint (routing.trotters.cc) offers free requests. When the free tier is exhausted, tools return a payment_required response with a Lightning invoice. After payment, call store-routing-credentials to store the macaroon for the session.
Self-hosted Valhalla has no payment requirement.
Architecture
Thin MCP wrapper over rendezvous-kit — the open-source TypeScript library for isochrone intersection, venue search, and fairness scoring. Each tool is an extracted handler function (testable without MCP) plus a registration one-liner.
Development
npm install
npm run build
npm test
Licence
MIT
Support
For issues and feature requests, see GitHub Issues.
If you find rendezvous-mcp useful, consider sending a tip:
- Lightning:
profusemeat89@walletofsatoshi.com
- Nostr zaps:
npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2