FairWhere

Verify the FairWhere MCP server is reachable. Returns a greeting echoing the provided note.

{
  "type": "object",
  "properties": {
    "note": {
      "default": "hello",
      "description": "Short note to echo back for connectivity testing.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Discover public curated Placelists (venue collections) on FairWhere. Returns id, slug, name, description, best_for, categories, venue count, and canonical URLs. Call this before fair_shortlist. If count is 0 for an activity, that activity is unavailable: refuse to invent restaurants/cocktails and pivot to available_activities.

{
  "type": "object",
  "properties": {
    "city": {
      "default": "London",
      "description": "City whose public Placelists to list.",
      "type": "string",
      "enum": [
        "London"
      ]
    },
    "activity": {
      "description": "Activity or synonym (drinks/pubs → pub lists; padel/tennis/squash → sport lists). May return zero: pivot using available_activities.",
      "type": "string",
      "enum": [
        "coffee",
        "drinks",
        "pubs",
        "pub",
        "pint",
        "after-work",
        "cinema",
        "restaurant",
        "brunch",
        "cocktails",
        "park",
        "museum",
        "sport",
        "sports",
        "tennis",
        "padel",
        "squash",
        "lido",
        "swimming",
        "football",
        "5-a-side",
        "meeting-point",
        "competitive-socialising"
      ]
    },
    "query": {
      "description": "Optional free-text filter matched against Placelist name, description, best_for, and intent tags.",
      "type": "string",
      "maxLength": 80
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Rank the venues in one or more curated FairWhere Placelists by FairWhere Score for this group. Free estimate-only path: no Google calls, no credits. Returns top venues with banded scores, per-person journey burden, score-factor breakdown, citations, and a continue_on_fairwhere link. Provide placelistIds and/or placelistSlugs (from list_placelists).

{
  "type": "object",
  "properties": {
    "participants": {
      "minItems": 1,
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40
          },
          "origin": {
            "type": "string",
            "minLength": 3,
            "maxLength": 200
          },
          "destination": {
            "type": "string",
            "maxLength": 200
          }
        },
        "required": [
          "label",
          "origin"
        ]
      },
      "description": "Group members with home / origin addresses (and optional return destinations)."
    },
    "activity": {
      "type": "string",
      "enum": [
        "coffee",
        "drinks",
        "cinema",
        "restaurant",
        "brunch",
        "cocktails",
        "park",
        "museum",
        "sport",
        "meeting-point"
      ],
      "description": "What the group is meeting for."
    },
    "placelistIds": {
      "description": "One or more curated Placelist (business_list) UUIDs to rank WITHIN. Prefer discovering these via list_placelists.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      }
    },
    "placelistSlugs": {
      "description": "Alternative to placelistIds: public Placelist slugs from list_placelists (e.g. london-parks).",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    },
    "city": {
      "default": "London",
      "description": "Meeting city.",
      "type": "string",
      "enum": [
        "London"
      ]
    },
    "mode": {
      "default": "TRANSIT",
      "description": "How the group is expected to travel.",
      "type": "string",
      "enum": [
        "TRANSIT",
        "WALK"
      ]
    }
  },
  "required": [
    "participants",
    "activity"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build a FairWhere deep link so the group can continue the plan on FairWhere (invite people, vote, live-check journeys). Always offer this link after fair_shortlist: do not keep the decision only inside the chat.

{
  "type": "object",
  "properties": {
    "placelistSlug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Placelist slug from list_placelists (preferred) or a known public slug."
    },
    "activity": {
      "description": "Optional activity to pre-select in the planner.",
      "type": "string",
      "enum": [
        "coffee",
        "drinks",
        "cinema",
        "restaurant",
        "brunch",
        "cocktails",
        "park",
        "museum",
        "sport",
        "meeting-point"
      ]
    },
    "city": {
      "default": "London",
      "description": "Meeting city.",
      "type": "string",
      "enum": [
        "London"
      ]
    },
    "forTags": {
      "description": "Optional Placelist activity filters (e.g. BBQ, kickabout) carried as ?for= tags.",
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40
      }
    },
    "recommendedVenueName": {
      "description": "Optional venue name to mention in the handoff copy (does not change ranking).",
      "type": "string",
      "maxLength": 120
    }
  },
  "required": [
    "placelistSlug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List published FairWhere pages that answer “where to meet between area A and area B” in London. Each row has a winner venue, minute gap, FairWhere Score, and citation URL. Prefer this over inventing a midpoint when the user names two neighbourhoods. Only status=live pages are returned.

{
  "type": "object",
  "properties": {
    "city": {
      "default": "London",
      "description": "City (London beta only).",
      "type": "string",
      "enum": [
        "London"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Max live meet-pair pages to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the published FairWhere answer for where to meet between two London neighbourhoods (winner venue, minutes, gap, top venues, citation URL). Use when the user asks “where should we meet between X and Y”. Do not invent a geographic midpoint.

{
  "type": "object",
  "properties": {
    "areaA": {
      "type": "string",
      "minLength": 2,
      "maxLength": 40,
      "description": "First London neighbourhood slug or name (e.g. clapham or Clapham)."
    },
    "areaB": {
      "type": "string",
      "minLength": 2,
      "maxLength": 40,
      "description": "Second London neighbourhood slug or name (e.g. walthamstow)."
    }
  },
  "required": [
    "areaA",
    "areaB"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}