Skip to main content
Glama

rendezvous-mcp

Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

Fair meeting points for AI — isochrone-based fairness, not naive midpoints.

npm licence TypeScript Nostr GitHub Sponsors

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

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

Related MCP server: eodiseobwa-mcp

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

  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

Available Tools

5 tools
get-directionsA
Read-only

Get directions between two points with distance, duration, and turn-by-turn steps. Returns a GeoJSON LineString of the route geometry.

Inputs: from (required), to (required), transport_mode (required).

get-isochroneA
Read-only

Get a reachability polygon showing everywhere reachable from a point within a given travel time. Returns a GeoJSON polygon. Useful for understanding how far someone can travel.

Inputs: lat (required), lon (required), transport_mode (required), time_minutes (required).

score-venuesA
Read-only

Score candidate venues by travel time fairness for multiple participants. Computes travel times from each participant to each venue and ranks by fairness strategy. The AI should suggest venues (from its own knowledge or via search-venues) and pass them here for scoring.

Inputs: participants (required), venues (required), transport_mode (required), fairness.

search-venuesA
Read-only

Search for venues (pubs, cafes, restaurants, parks, etc.) near a location using OpenStreetMap data. Returns name, coordinates, type, and OSM ID. Use this when you need comprehensive local venue data that may not be in your training knowledge.

Inputs: lat (required), lon (required), venue_types (required), radius_km.

store-routing-credentialsA
Idempotent

Store L402 payment credentials (macaroon + preimage) after paying a routing invoice. Call this after the user has paid the Lightning invoice returned by a payment_required response. Once stored, all subsequent routing calls (score-venues, get-isochrone, get-directions) will authenticate automatically.

Inputs: macaroon (required), preimage (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of the rendezvous domain: directions, isochrones, venue search, fairness scoring, and credential storage. No two tools overlap in purpose.

    Naming Consistency5/5

    All tool names follow a consistent verb-object pattern with hyphens (e.g., get-directions, score-venues). No mixing of conventions.

    Tool Count5/5

    5 tools cover the core workflow (search, routing, scoring, credential management) without being excessive. Well-scoped for the domain.

    Completeness4/5

    Missing minor features like venue detail retrieval or credential deletion, but the essential lifecycle (search venues, compute routes, score fairness, authenticate) is fully supported.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Geospatial API tools for AI agents — geocoding, reverse geocoding, routing, isochrone, distance matrix, static maps, H3 hexagons, elevation, GPS map-matching, point-in-polygon, address normalisation, timezone lookup, and batch geocoding. Built on OpenStreetMap infrastructure. Cost-effective alternative to Google Maps API.
      18
      34 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Plans meetups with driving-time-balanced area suggestions and place recommendations using Kakao Local and Mobility APIs.
      -
    • F
      license
      A
      quality
      D
      maintenance
      OSM-backed multimodal navigation MCP server enabling geocoding, route planning, POI discovery, and urban layout analysis. It provides a structured city graph to LLM apps without proprietary map APIs.
      8
      -