FairWhere

Working · 2.8 s

com.fairwhere/fairwherev0.5.0 Domain verified

Free London beta meetup planner. Ranks curated Placelists by journey fairness for the whole group.

Maps & Travel

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://www.fairwhere.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

fair_shortlist Read-only

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).

activitystring, required

What the group is meeting for.

participantsarray, required

Group members with home / origin addresses (and optional return destinations).

citystring

Meeting city.

modestring

How the group is expected to travel.

placelistIdsarray

One or more curated Placelist (business_list) UUIDs to rank WITHIN. Prefer discovering these via list_placelists.

placelistSlugsarray

Alternative to placelistIds: public Placelist slugs from list_placelists (e.g. london-parks).

Tools (6)

fair_shortlist

read-only

Argument	Type	Description
city	string	Meeting city.
mode	string	How the group is expected to travel.
activity*	string	What the group is meeting for.
participants*	array	Group members with home / origin addresses (and optional return destinations).
placelistIds	array	One or more curated Placelist (business_list) UUIDs to rank WITHIN. Prefer discovering these via list_placelists.
placelistSlugs	array	Alternative to placelistIds: public Placelist slugs from list_placelists (e.g. london-parks).

Input schema (JSON)

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

get_meet_pair

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.

read-only

Argument	Type	Description
areaA*	string	First London neighbourhood slug or name (e.g. clapham or Clapham).
areaB*	string	Second London neighbourhood slug or name (e.g. walthamstow).

Input schema (JSON)

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

list_meet_pairs

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.

read-only

Argument	Type	Description
city	string	City (London beta only).
limit	integer	Max live meet-pair pages to return.

Input schema (JSON)

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

list_placelists

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.

read-only

Argument	Type	Description
city	string	City whose public Placelists to list.
query	string	Optional free-text filter matched against Placelist name, description, best_for, and intent tags.
activity	string	Activity or synonym (drinks/pubs → pub lists; padel/tennis/squash → sport lists). May return zero: pivot using available_activities.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "city": {
      "enum": [
        "London"
      ],
      "type": "string",
      "default": "London",
      "description": "City whose public Placelists to list."
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional free-text filter matched against Placelist name, description, best_for, and intent tags."
    },
    "activity": {
      "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"
      ],
      "type": "string",
      "description": "Activity or synonym (drinks/pubs → pub lists; padel/tennis/squash → sport lists). May return zero: pivot using available_activities."
    }
  }
}

open_plan_link

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.

read-only

Argument	Type	Description
city	string	Meeting city.
forTags	array	Optional Placelist activity filters (e.g. BBQ, kickabout) carried as ?for= tags.
activity	string	Optional activity to pre-select in the planner.
placelistSlug*	string	Placelist slug from list_placelists (preferred) or a known public slug.
recommendedVenueName	string	Optional venue name to mention in the handoff copy (does not change ranking).

Input schema (JSON)

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

ping

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

read-only

Argument	Type	Description
note	string	Short note to echo back for connectivity testing.

Input schema (JSON)

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