English Français العربية

dev.forgesworn/rendezvous-mcp

Official registry Productivity

Fair meeting point discovery for AI agents with isochrone-based travel time fairness

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package rendezvous-mcp
Claude Code 
claude mcp add rendezvous-mcp -e 'VALHALLA_URL=<VALHALLA_URL>' -- npx -y rendezvous-mcp@1.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "rendezvous-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "rendezvous-mcp@1.1.3"
            ],
            "env": {
                "VALHALLA_URL": "<VALHALLA_URL>"
            }
        }
    }
}

Environment variables

  • VALHALLA_URL Valhalla routing engine URL

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. rendezvous-mcp
  2. Tools
  3. Quick start
  4. Remote (HTTP/SSE)
  5. Configuration
  6. Self-hosted routing
  7. How it works
  8. L402 payments
  9. Architecture
  10. Development
  11. Licence
  12. Support

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.

Tools

ToolDescription
score-venuesScore candidate venues by travel time fairness for 2–10 participants
search-venuesSearch for venues near a location using OpenStreetMap
get-isochroneGet a reachability polygon (everywhere reachable within N minutes)
get-directionsGet directions between two points with turn-by-turn steps
store-routing-credentialsStore 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

VariableDefaultDescription
TRANSPORTstdioTransport mode: stdio or http
PORT3002HTTP server port (HTTP mode only)
HOST0.0.0.0HTTP bind address (HTTP mode only)
VALHALLA_URLhttps://routing.trotters.ccRouting engine URL
OVERPASS_URLPublic endpointsVenue 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

  1. User asks "Where should we meet?"
  2. AI geocodes participant locations
  3. AI calls search-venues to find candidate venues near the area
  4. AI calls score-venues with participants + candidates — returns ranked results with travel times and fairness scores
  5. 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

Frequently asked questions

What is dev.forgesworn/rendezvous-mcp?

Fair meeting point discovery for AI agents with isochrone-based travel time fairness

How do I install dev.forgesworn/rendezvous-mcp?

It runs on your machine. In Claude Code: claude mcp add rendezvous-mcp -e 'VALHALLA_URL=<VALHALLA_URL>' -- npx -y rendezvous-mcp@1.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does dev.forgesworn/rendezvous-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is dev.forgesworn/rendezvous-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains dev.forgesworn/rendezvous-mcp?

It is published by forgesworn. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.