rendezvous-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 forgesworn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# rendezvous-mcp
+
+**Fair meeting points for AI — isochrone-based fairness, not naive midpoints.**
+
+[![npm](https://img.shields.io/npm/v/rendezvous-mcp)](https://www.npmjs.com/package/rendezvous-mcp)
+[![licence](https://img.shields.io/npm/l/rendezvous-mcp)](https://github.com/forgesworn/rendezvous-mcp/blob/main/LICENSE)
+![TypeScript](https://img.shields.io/badge/TypeScript-native-blue)
+[![Nostr](https://img.shields.io/badge/Nostr-Zap%20me-purple)](https://primal.net/p/npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2)
+
+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 |
+
+## Quick start
+
+Add to your MCP client config (Claude Code, Claude Desktop, Cursor, etc.):
+
+```json
+{
+  "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:
+
+```bash
+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:
+
+```json
+{
+  "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](https://github.com/forgesworn/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
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Licence
+
+[MIT](https://github.com/forgesworn/rendezvous-mcp/blob/main/LICENSE)
+
+## Support
+
+For issues and feature requests, see [GitHub Issues](https://github.com/forgesworn/rendezvous-mcp/issues).
+
+If you find rendezvous-mcp useful, consider sending a tip:
+
+- **Lightning:** `thedonkey@strike.me`
+- **Nostr zaps:** `npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2`

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RoutingClient, validateUrl } from './routing.js';
+import { registerScoreVenuesTool } from './tools/score-venues.js';
+import { registerSearchVenuesTool } from './tools/search-venues.js';
+import { registerIsochroneTool } from './tools/isochrone.js';
+import { registerDirectionsTool } from './tools/directions.js';
+import { registerStoreCredentialsTool } from './tools/store-credentials.js';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+const TRANSPORT = process.env.TRANSPORT ?? 'stdio';
+const PORT = Math.max(1, Math.min(65535, parseInt(process.env.PORT ?? '3002', 10) || 3002));
+const HOST = process.env.HOST ?? '0.0.0.0';
+const VALHALLA_URL = process.env.VALHALLA_URL;
+const OVERPASS_URL = process.env.OVERPASS_URL
+    ? validateUrl(process.env.OVERPASS_URL, 'OVERPASS_URL')
+    : undefined;
+const CORS_ORIGIN = process.env.CORS_ORIGIN ?? '*';
+const RATE_LIMIT_MAX = Math.max(1, parseInt(process.env.RATE_LIMIT_MAX ?? '60', 10) || 60);
+const RATE_LIMIT_WINDOW = 60_000;
+const server = new McpServer({
+    name: 'rendezvous-mcp',
+    version,
+});
+const routingClient = new RoutingClient({
+    valhallaUrl: VALHALLA_URL,
+});
+// Register all tools
+registerScoreVenuesTool(server, routingClient);
+registerSearchVenuesTool(server, OVERPASS_URL);
+registerIsochroneTool(server, routingClient);
+registerDirectionsTool(server, routingClient);
+registerStoreCredentialsTool(server, routingClient);
+if (TRANSPORT === 'http') {
+    const { default: express } = await import('express');
+    const { default: cors } = await import('cors');
+    const { StreamableHTTPServerTransport } = await import('@modelcontextprotocol/sdk/server/streamableHttp.js');
+    const app = express();
+    app.use(cors({ origin: CORS_ORIGIN }));
+    app.use(express.json({ limit: '100kb' }));
+    // Simple in-memory rate limiter
+    const rateLimitMap = new Map();
+    const cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [ip, entry] of rateLimitMap) {
+            if (now > entry.resetAt)
+                rateLimitMap.delete(ip);
+        }
+    }, RATE_LIMIT_WINDOW);
+    cleanupInterval.unref();
+    app.use((req, res, next) => {
+        const ip = req.ip ?? req.socket.remoteAddress ?? 'unknown';
+        const now = Date.now();
+        const entry = rateLimitMap.get(ip);
+        if (!entry || now > entry.resetAt) {
+            rateLimitMap.set(ip, { count: 1, resetAt: now + RATE_LIMIT_WINDOW });
+            return next();
+        }
+        entry.count++;
+        if (entry.count > RATE_LIMIT_MAX) {
+            res.status(429).json({ error: 'Too many requests' });
+            return;
+        }
+        next();
+    });
+    app.get('/health', (_req, res) => {
+        res.json({
+            status: 'ok',
+            server: 'rendezvous-mcp',
+            version,
+            valhalla_configured: !!VALHALLA_URL,
+            tools: ['score_venues', 'search_venues', 'get_isochrone', 'get_directions', 'store_routing_credentials'],
+        });
+    });
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+    });
+    await server.connect(transport);
+    app.post('/mcp', async (req, res) => {
+        await transport.handleRequest(req, res, req.body);
+    });
+    app.get('/mcp', async (req, res) => {
+        await transport.handleRequest(req, res);
+    });
+    app.delete('/mcp', async (req, res) => {
+        await transport.handleRequest(req, res);
+    });
+    const httpServer = app.listen(PORT, HOST, () => {
+        console.error(`rendezvous-mcp HTTP server listening on ${HOST}:${PORT}`);
+        console.error('MCP endpoint: /mcp');
+        console.error('Health check: /health');
+    });
+    // Graceful shutdown
+    const shutdown = () => {
+        console.error('Shutting down gracefully…');
+        httpServer.close(() => process.exit(0));
+        setTimeout(() => process.exit(1), 5000).unref();
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+}
+else {
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('rendezvous-mcp server running on stdio');
+}
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/l402.d.ts

@@ -0,0 +1,21 @@
+/** Payment-required response returned to MCP when Valhalla returns 402. */
+export interface L402PaymentRequired {
+    status: 'payment_required';
+    message: string;
+    invoice: string;
+    macaroon: string;
+    payment_hash: string;
+    payment_url: string;
+    amount_sats: number;
+}
+/** In-memory L402 credential storage for a single MCP session. */
+export declare class L402State {
+    private macaroon;
+    private preimage;
+    /** Store credentials after the user pays an invoice. */
+    store(macaroon: string, preimage: string): void;
+    /** Return the Authorization header value, or null if no credentials. */
+    getAuthHeader(): string | null;
+    /** Clear stored credentials. */
+    clear(): void;
+}

package/build/l402.js

@@ -0,0 +1,22 @@
+/** In-memory L402 credential storage for a single MCP session. */
+export class L402State {
+    macaroon = null;
+    preimage = null;
+    /** Store credentials after the user pays an invoice. */
+    store(macaroon, preimage) {
+        this.macaroon = macaroon;
+        this.preimage = preimage;
+    }
+    /** Return the Authorization header value, or null if no credentials. */
+    getAuthHeader() {
+        if (!this.macaroon || !this.preimage)
+            return null;
+        return `L402 ${this.macaroon}:${this.preimage}`;
+    }
+    /** Clear stored credentials. */
+    clear() {
+        this.macaroon = null;
+        this.preimage = null;
+    }
+}
+//# sourceMappingURL=l402.js.map

package/build/l402.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"l402.js","sourceRoot":"","sources":["../src/l402.ts"],"names":[],"mappings":"AAWA,kEAAkE;AAClE,MAAM,OAAO,SAAS;IACZ,QAAQ,GAAkB,IAAI,CAAA;IAC9B,QAAQ,GAAkB,IAAI,CAAA;IAEtC,wDAAwD;IACxD,KAAK,CAAC,QAAgB,EAAE,QAAgB;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAED,wEAAwE;IACxE,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QACjD,OAAO,QAAQ,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;IACjD,CAAC;IAED,gCAAgC;IAChC,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;IACtB,CAAC;CACF"}

package/build/routing.d.ts

@@ -0,0 +1,25 @@
+import { ValhallaEngine } from 'rendezvous-kit';
+import type { LatLon, TransportMode, Isochrone, RouteMatrix, RouteGeometry } from 'rendezvous-kit';
+import type { L402PaymentRequired } from './l402.js';
+/** Validate that a string is an HTTP(S) URL. */
+export declare function validateUrl(url: string, label: string): string;
+export declare class RoutingClient {
+    readonly valhallaUrl: string;
+    private readonly l402;
+    constructor(config?: {
+        valhallaUrl?: string;
+    });
+    /** Store L402 credentials after user pays an invoice. */
+    storeL402Credentials(macaroon: string, preimage: string): void;
+    /** Build a ValhallaEngine with current auth headers. */
+    getEngine(): ValhallaEngine;
+    /** Compute isochrone, returning L402PaymentRequired on 402. */
+    computeIsochrone(origin: LatLon, mode: TransportMode, timeMinutes: number): Promise<Isochrone | L402PaymentRequired>;
+    /** Compute route matrix, returning L402PaymentRequired on 402. */
+    computeRouteMatrix(origins: LatLon[], destinations: LatLon[], mode: TransportMode): Promise<RouteMatrix | L402PaymentRequired>;
+    /** Compute route, returning L402PaymentRequired on 402. */
+    computeRoute(origin: LatLon, destination: LatLon, mode: TransportMode): Promise<RouteGeometry | L402PaymentRequired>;
+    private handleError;
+}
+/** Type guard for L402 payment required responses. */
+export declare function isPaymentRequired(result: unknown): result is L402PaymentRequired;

package/build/routing.js

@@ -0,0 +1,99 @@
+import { ValhallaEngine, ValhallaError } from 'rendezvous-kit';
+import { L402State } from './l402.js';
+const DEFAULT_VALHALLA_URL = 'https://routing.trotters.cc';
+/** Validate that a string is an HTTP(S) URL. */
+export function validateUrl(url, label) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new TypeError(`${label}: invalid URL "${url}"`);
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new TypeError(`${label}: must use http or https, got "${parsed.protocol}"`);
+    }
+    return url.replace(/\/$/, '');
+}
+export class RoutingClient {
+    valhallaUrl;
+    l402;
+    constructor(config) {
+        this.valhallaUrl = config?.valhallaUrl
+            ? validateUrl(config.valhallaUrl, 'RoutingClient valhallaUrl')
+            : DEFAULT_VALHALLA_URL;
+        this.l402 = new L402State();
+    }
+    /** Store L402 credentials after user pays an invoice. */
+    storeL402Credentials(macaroon, preimage) {
+        this.l402.store(macaroon, preimage);
+    }
+    /** Build a ValhallaEngine with current auth headers. */
+    getEngine() {
+        const headers = {};
+        const auth = this.l402.getAuthHeader();
+        if (auth)
+            headers['Authorization'] = auth;
+        return new ValhallaEngine({ baseUrl: this.valhallaUrl, headers });
+    }
+    /** Compute isochrone, returning L402PaymentRequired on 402. */
+    async computeIsochrone(origin, mode, timeMinutes) {
+        try {
+            return await this.getEngine().computeIsochrone(origin, mode, timeMinutes);
+        }
+        catch (err) {
+            return this.handleError(err);
+        }
+    }
+    /** Compute route matrix, returning L402PaymentRequired on 402. */
+    async computeRouteMatrix(origins, destinations, mode) {
+        try {
+            return await this.getEngine().computeRouteMatrix(origins, destinations, mode);
+        }
+        catch (err) {
+            return this.handleError(err);
+        }
+    }
+    /** Compute route, returning L402PaymentRequired on 402. */
+    async computeRoute(origin, destination, mode) {
+        try {
+            return await this.getEngine().computeRoute(origin, destination, mode);
+        }
+        catch (err) {
+            return this.handleError(err);
+        }
+    }
+    handleError(err) {
+        if (err instanceof ValhallaError && err.status === 402) {
+            try {
+                const body = JSON.parse(err.body);
+                return {
+                    status: 'payment_required',
+                    message: 'Free tier exhausted. Pay to continue using the routing service.',
+                    invoice: body.invoice ?? '',
+                    macaroon: body.macaroon ?? '',
+                    payment_hash: body.payment_hash ?? '',
+                    payment_url: `${this.valhallaUrl}/invoice-status/${body.payment_hash ?? ''}`,
+                    amount_sats: body.amount_sats ?? 1000,
+                };
+            }
+            catch {
+                return {
+                    status: 'payment_required',
+                    message: 'Payment required — could not parse invoice details.',
+                    invoice: '',
+                    macaroon: '',
+                    payment_hash: '',
+                    payment_url: this.valhallaUrl,
+                    amount_sats: 1000,
+                };
+            }
+        }
+        throw err;
+    }
+}
+/** Type guard for L402 payment required responses. */
+export function isPaymentRequired(result) {
+    return typeof result === 'object' && result !== null && result.status === 'payment_required';
+}
+//# sourceMappingURL=routing.js.map

package/build/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"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"}

package/build/tools/directions.d.ts

@@ -0,0 +1,27 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TransportMode } from 'rendezvous-kit';
+import type { RoutingClient } from '../routing.js';
+export declare function handleGetDirections(args: {
+    from: {
+        lat: number;
+        lon: number;
+    };
+    to: {
+        lat: number;
+        lon: number;
+    };
+    transport_mode: TransportMode;
+}, routingClient: RoutingClient): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare function registerDirectionsTool(server: McpServer, routingClient: RoutingClient): void;

package/build/tools/directions.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { isPaymentRequired } from '../routing.js';
+export async function handleGetDirections(args, routingClient) {
+    console.error(`Computing route: ${args.transport_mode} from [${args.from.lat},${args.from.lon}] to [${args.to.lat},${args.to.lon}]`);
+    try {
+        const result = await routingClient.computeRoute({ lat: args.from.lat, lon: args.from.lon }, { lat: args.to.lat, lon: args.to.lon }, args.transport_mode);
+        if (isPaymentRequired(result)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            status: result.status,
+                            message: result.message,
+                            invoice: result.invoice,
+                            macaroon: result.macaroon,
+                            payment_hash: result.payment_hash,
+                            payment_url: result.payment_url,
+                            amount_sats: result.amount_sats,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        distance_km: Math.round(result.distanceKm * 100) / 100,
+                        duration_minutes: Math.round(result.durationMinutes * 10) / 10,
+                        steps: (result.legs ?? []).map(leg => ({
+                            instruction: leg.instruction,
+                            distance_km: Math.round(leg.distanceKm * 100) / 100,
+                            duration_minutes: Math.round(leg.durationMinutes * 10) / 10,
+                        })),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: false, error: message }),
+                }],
+            isError: true,
+        };
+    }
+}
+export function registerDirectionsTool(server, routingClient) {
+    server.registerTool('get_directions', {
+        description: 'Get directions between two points with distance, duration, and turn-by-turn steps. ' +
+            'Returns a GeoJSON LineString of the route geometry.',
+        inputSchema: {
+            from: z.object({
+                lat: z.number().min(-90).max(90).describe('Latitude'),
+                lon: z.number().min(-180).max(180).describe('Longitude'),
+            }).describe('Starting point'),
+            to: z.object({
+                lat: z.number().min(-90).max(90).describe('Latitude'),
+                lon: z.number().min(-180).max(180).describe('Longitude'),
+            }).describe('Destination point'),
+            transport_mode: z.enum(['drive', 'cycle', 'walk']).describe('Travel mode'),
+        },
+    }, async (args) => handleGetDirections(args, routingClient));
+}
+//# sourceMappingURL=directions.js.map

package/build/tools/directions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directions.js","sourceRoot":"","sources":["../../src/tools/directions.ts"],"names":[],"mappings":"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"}

package/build/tools/isochrone.d.ts

@@ -0,0 +1,22 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TransportMode } from 'rendezvous-kit';
+import type { RoutingClient } from '../routing.js';
+export declare function handleGetIsochrone(args: {
+    lat: number;
+    lon: number;
+    transport_mode: TransportMode;
+    time_minutes: number;
+}, routingClient: RoutingClient): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare function registerIsochroneTool(server: McpServer, routingClient: RoutingClient): void;

package/build/tools/isochrone.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { isPaymentRequired } from '../routing.js';
+export async function handleGetIsochrone(args, routingClient) {
+    console.error(`Computing isochrone: ${args.time_minutes}min ${args.transport_mode} from [${args.lat},${args.lon}]`);
+    try {
+        const result = await routingClient.computeIsochrone({ lat: args.lat, lon: args.lon }, args.transport_mode, args.time_minutes);
+        if (isPaymentRequired(result)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            status: result.status,
+                            message: result.message,
+                            invoice: result.invoice,
+                            macaroon: result.macaroon,
+                            payment_hash: result.payment_hash,
+                            payment_url: result.payment_url,
+                            amount_sats: result.amount_sats,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        time_minutes: result.timeMinutes,
+                        transport_mode: result.mode,
+                        polygon: result.polygon,
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: false, error: message }),
+                }],
+            isError: true,
+        };
+    }
+}
+export function registerIsochroneTool(server, routingClient) {
+    server.registerTool('get_isochrone', {
+        description: '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.',
+        inputSchema: {
+            lat: z.number().min(-90).max(90).describe('Latitude of starting point'),
+            lon: z.number().min(-180).max(180).describe('Longitude of starting point'),
+            transport_mode: z.enum(['drive', 'cycle', 'walk']).describe('Travel mode'),
+            time_minutes: z.number().min(1).max(120).describe('Maximum travel time in minutes'),
+        },
+    }, async (args) => handleGetIsochrone(args, routingClient));
+}
+//# sourceMappingURL=isochrone.js.map

package/build/tools/isochrone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isochrone.js","sourceRoot":"","sources":["../../src/tools/isochrone.ts"],"names":[],"mappings":"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"}

package/build/tools/score-venues.d.ts

@@ -0,0 +1,31 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TransportMode, FairnessStrategy } from 'rendezvous-kit';
+import type { RoutingClient } from '../routing.js';
+export declare function handleScoreVenues(args: {
+    participants: Array<{
+        lat: number;
+        lon: number;
+        label?: string;
+    }>;
+    venues: Array<{
+        lat: number;
+        lon: number;
+        name: string;
+        type?: string;
+    }>;
+    transport_mode: TransportMode;
+    fairness?: FairnessStrategy;
+}, routingClient: RoutingClient): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare function registerScoreVenuesTool(server: McpServer, routingClient: RoutingClient): void;

package/build/tools/score-venues.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { isPaymentRequired } from '../routing.js';
+// ---------------------------------------------------------------------------
+// Extracted handler (testable without MCP server)
+// ---------------------------------------------------------------------------
+export async function handleScoreVenues(args, routingClient) {
+    const fairness = args.fairness ?? 'min_max';
+    const participants = args.participants.map((p, i) => ({
+        lat: p.lat,
+        lon: p.lon,
+        label: p.label ?? `Participant ${i + 1}`,
+    }));
+    const venuePoints = args.venues.map(v => ({ lat: v.lat, lon: v.lon }));
+    console.error(`Scoring ${args.venues.length} venues for ${participants.length} participants (${args.transport_mode}, ${fairness})`);
+    try {
+        const matrix = await routingClient.computeRouteMatrix(participants, venuePoints, args.transport_mode);
+        if (isPaymentRequired(matrix)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            status: matrix.status,
+                            message: matrix.message,
+                            invoice: matrix.invoice,
+                            macaroon: matrix.macaroon,
+                            payment_hash: matrix.payment_hash,
+                            payment_url: matrix.payment_url,
+                            amount_sats: matrix.amount_sats,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        // Score each venue
+        const ranked = [];
+        for (let vi = 0; vi < args.venues.length; vi++) {
+            const venue = args.venues[vi];
+            const travelTimes = {};
+            const times = [];
+            let reachable = true;
+            for (let pi = 0; pi < participants.length; pi++) {
+                const entry = matrix.entries.find(e => e.originIndex === pi && e.destinationIndex === vi);
+                const duration = entry?.durationMinutes ?? -1;
+                if (duration < 0) {
+                    reachable = false;
+                    break;
+                }
+                const label = participants[pi].label;
+                travelTimes[label] = Math.round(duration * 10) / 10;
+                times.push(duration);
+            }
+            if (!reachable)
+                continue;
+            const fairnessScore = computeFairnessScore(times, fairness);
+            ranked.push({
+                name: venue.name,
+                lat: venue.lat,
+                lon: venue.lon,
+                type: venue.type,
+                travel_times: travelTimes,
+                fairness_score: Math.round(fairnessScore * 10) / 10,
+            });
+        }
+        ranked.sort((a, b) => a.fairness_score - b.fairness_score);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, ranked_venues: ranked }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: false, error: message }),
+                }],
+            isError: true,
+        };
+    }
+}
+function computeFairnessScore(times, strategy) {
+    switch (strategy) {
+        case 'min_max':
+            return Math.max(...times);
+        case 'min_total':
+            return times.reduce((sum, t) => sum + t, 0);
+        case 'min_variance': {
+            const mean = times.reduce((sum, t) => sum + t, 0) / times.length;
+            return Math.sqrt(times.reduce((sum, t) => sum + (t - mean) ** 2, 0) / times.length);
+        }
+        default:
+            return Math.max(...times);
+    }
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+export function registerScoreVenuesTool(server, routingClient) {
+    server.registerTool('score_venues', {
+        description: '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.',
+        inputSchema: {
+            participants: z.array(z.object({
+                lat: z.number().min(-90).max(90).describe('Latitude'),
+                lon: z.number().min(-180).max(180).describe('Longitude'),
+                label: z.string().optional().describe('Name or label (e.g. "Alice")'),
+            })).min(2).max(10).describe('Participant locations (2–10 people)'),
+            venues: z.array(z.object({
+                lat: z.number().min(-90).max(90).describe('Latitude'),
+                lon: z.number().min(-180).max(180).describe('Longitude'),
+                name: z.string().describe('Venue name'),
+                type: z.string().optional().describe('Venue type (pub, cafe, restaurant, park, etc.)'),
+            })).min(1).max(50).describe('Candidate venues to score (1–50)'),
+            transport_mode: z.enum(['drive', 'cycle', 'walk']).describe('How participants will travel'),
+            fairness: z.enum(['min_max', 'min_total', 'min_variance']).optional()
+                .describe('Scoring strategy: min_max (default, minimise longest journey), min_total (minimise total travel), min_variance (equalise travel times)'),
+        },
+    }, async (args) => handleScoreVenues(args, routingClient));
+}
+//# sourceMappingURL=score-venues.js.map

package/build/tools/score-venues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-venues.js","sourceRoot":"","sources":["../../src/tools/score-venues.ts"],"names":[],"mappings":"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"}

package/build/tools/search-venues.d.ts

@@ -0,0 +1,20 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function handleSearchVenues(args: {
+    lat: number;
+    lon: number;
+    radius_km?: number;
+    venue_types: string[];
+}, overpassUrl?: string): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+}>;
+export declare function registerSearchVenuesTool(server: McpServer, overpassUrl?: string): void;

package/build/tools/search-venues.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { searchVenues, circleToPolygon } from 'rendezvous-kit';
+const VENUE_TYPES = [
+    'pub', 'cafe', 'restaurant', 'park', 'library', 'playground',
+    'community_centre', 'bar', 'fast_food', 'garden', 'theatre',
+    'arts_centre', 'fitness_centre', 'sports_centre', 'escape_game',
+    'swimming_pool', 'service_station',
+];
+// ---------------------------------------------------------------------------
+// Extracted handler
+// ---------------------------------------------------------------------------
+export async function handleSearchVenues(args, overpassUrl) {
+    const radiusMetres = (args.radius_km ?? 5) * 1000;
+    console.error(`Searching venues within ${args.radius_km ?? 5}km of [${args.lat},${args.lon}] for types: ${args.venue_types.join(', ')}`);
+    try {
+        const polygon = circleToPolygon([args.lon, args.lat], radiusMetres);
+        const venues = await searchVenues(polygon, args.venue_types, overpassUrl);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        venue_count: venues.length,
+                        venues: venues.map(v => ({
+                            name: v.name,
+                            lat: v.lat,
+                            lon: v.lon,
+                            type: v.venueType,
+                            osm_id: v.osmId,
+                        })),
+                    }, null, 2),
+                }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: false, error: message }),
+                }],
+            isError: true,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+export function registerSearchVenuesTool(server, overpassUrl) {
+    server.registerTool('search_venues', {
+        description: '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.',
+        inputSchema: {
+            lat: z.number().min(-90).max(90).describe('Centre latitude'),
+            lon: z.number().min(-180).max(180).describe('Centre longitude'),
+            radius_km: z.number().min(0.5).max(25).optional().describe('Search radius in km (default 5)'),
+            venue_types: z.array(z.enum(VENUE_TYPES)).min(1)
+                .describe('Venue types to search: pub, cafe, restaurant, park, library, playground, community_centre, bar, fast_food, garden, theatre, arts_centre, fitness_centre, sports_centre, escape_game, swimming_pool, service_station'),
+        },
+    }, async (args) => handleSearchVenues(args, overpassUrl));
+}
+//# sourceMappingURL=search-venues.js.map

package/build/tools/search-venues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-venues.js","sourceRoot":"","sources":["../../src/tools/search-venues.ts"],"names":[],"mappings":"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"}

package/build/tools/store-credentials.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RoutingClient } from '../routing.js';
+export declare function handleStoreRoutingCredentials(args: {
+    macaroon: string;
+    preimage: string;
+}, routingClient: RoutingClient): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function registerStoreCredentialsTool(server: McpServer, routingClient: RoutingClient): void;

package/build/tools/store-credentials.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Extracted handler (testable without MCP server)
+// ---------------------------------------------------------------------------
+export async function handleStoreRoutingCredentials(args, routingClient) {
+    console.error('Storing L402 routing credentials');
+    routingClient.storeL402Credentials(args.macaroon, args.preimage);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    message: 'L402 credentials stored. Subsequent routing calls will authenticate automatically.',
+                }),
+            }],
+    };
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+export function registerStoreCredentialsTool(server, routingClient) {
+    server.registerTool('store_routing_credentials', {
+        description: '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 (find_rendezvous, score_venues, get_isochrone, get_directions) ' +
+            'will authenticate automatically.',
+        inputSchema: {
+            macaroon: z.string().min(1).regex(/^[A-Za-z0-9+/=]+$/, 'Must be valid base64')
+                .describe('The macaroon from the payment_required response'),
+            preimage: z.string().min(1).regex(/^[0-9a-fA-F]+$/, 'Must be valid hex')
+                .describe('The payment preimage obtained after paying the invoice'),
+        },
+    }, async (args) => handleStoreRoutingCredentials(args, routingClient));
+}
+//# sourceMappingURL=store-credentials.js.map

package/build/tools/store-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-credentials.js","sourceRoot":"","sources":["../../src/tools/store-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAGC,EACD,aAA4B;IAE5B,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAA;IAEjD,aAAa,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IAEhE,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,oFAAoF;iBAC9F,CAAC;aACH,CAAC;KACH,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,aAA4B;IAC1F,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,WAAW,EACT,uFAAuF;YACvF,mGAAmG;YACnG,2GAA2G;YAC3G,kCAAkC;QACpC,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;iBAC3E,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;iBACrE,QAAQ,CAAC,wDAAwD,CAAC;SACtE;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,6BAA6B,CAAC,IAAI,EAAE,aAAa,CAAC,CACnE,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "rendezvous-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for AI-driven fair meeting point discovery",
+  "type": "module",
+  "bin": {
+    "rendezvous-mcp": "./build/index.js"
+  },
+  "main": "./build/index.js",
+  "exports": {
+    ".": "./build/index.js",
+    "./routing": "./build/routing.js",
+    "./l402": "./build/l402.js",
+    "./tools/*": "./build/tools/*.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "start": "node build/index.js",
+    "start:http": "TRANSPORT=http node build/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "cors": "^2.8.5",
+    "express": "^4.21.0",
+    "rendezvous-kit": "^1.17.2",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/npm": "^13.1.4",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "semantic-release": "^25.0.3",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "mcp",
+    "meeting-point",
+    "rendezvous",
+    "routing",
+    "valhalla",
+    "l402",
+    "model-context-protocol",
+    "ai",
+    "fairness",
+    "isochrone",
+    "travel-time",
+    "openstreetmap",
+    "geospatial",
+    "venue-search"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "author": "forgesworn",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/forgesworn/rendezvous-mcp.git"
+  },
+  "homepage": "https://github.com/forgesworn/rendezvous-mcp",
+  "funding": {
+    "type": "lightning",
+    "url": "https://strike.me/thedonkey"
+  },
+  "files": [
+    "build",
+    "LICENSE"
+  ],
+  "license": "MIT"
+}