run.cityheart/heart-routes

Official7 tools

Heart-shaped GPS running routes in 200+ cities — charity, gift, memorial, anniversary.

Discover heart-shaped GPS running routes in 200+ cities for charity and memorials.

Captured live from the server via tools/list.

find_heart_route_in_city

Find an existing heart-shaped running route in a given city. Returns up to 5 AI-validated routes matching the city (and optionally a target distance). Use this when a user mentions a city and wants a heart route — e.g. "find me a heart-shaped route in Paris" or "I want to run a heart in Tokyo for my mum's birthday".

Parameters (3)

citystringrequired
City name, e.g. "Paris", "Tokyo", "New York". Case-insensitive.
max_distance_kmnumber
Optional max route length in kilometres. Filter to routes ≤ this distance. Common: 5, 10, 15, 21 (half-marathon).
prefer_goldboolean
If true, return only the highest AI-quality "gold" tier routes (ai_score >= 80). Default true.

get_route_details

Get full details for a specific heart route by its slug. Use after find_heart_route_in_city when the user picks one. Returns: city, distance, image URL, share URL, dedication (if any), and the GPX download deep-link.

Parameters (1)

slugstringrequired
Route slug, e.g. "paris-7-2-km-heart-for-marie".

list_supported_cities

List cities that have at least one heart route available. Use when the user asks "where can I run a heart?" or hasn't picked a city yet. Returns city names + route counts, sorted by inventory size.

Parameters (1)

limitnumber
Max number of cities to return. Default 25, max 100.

generate_heart_route

Start a new heart-shaped route for a given city. Returns existing AI-validated matches from inventory PLUS a deep-link to the live builder for an on-demand fresh generation with the user's exact dedication and cause. Use when the user explicitly wants a NEW heart, or when an existing match is "close enough but not personal yet". Optional dedication / cause_url pre-fill the builder fields, so the URL deep-link arrives configured.

Parameters (5)

citystringrequired
City name, e.g. "Paris", "Tokyo".
distance_kmnumber
Target route length in km (3–25). Default 7.
dedicationstring
Optional person/cause name to bake into the heart (appears in the GPX, on Garmin Connect, and as the Strava activity title prefix).
in_memoryboolean
If true, the dedication is framed as a memorial ("In memory of [name]"). Default false.
cause_urlstring
Optional JustGiving / GoFundMe / Leetchi URL to embed in the GPX metadata. CityHeart never touches the money — the link is for the runner's Strava description to surface to donors.

add_dedication

Compose a builder URL with a dedication pre-filled — the name shows on the runner's GPS watch and in the Strava activity title. Use after the user picks a route (find/generate) and decides who the heart is for. Pure URL builder, no server-side state.

Parameters (3)

namestringrequired
Dedication name (e.g. "Marie", "Dad", "Cancer Research UK").
in_memoryboolean
If true, framed as "In memory of [name]". Default false.
citystring
Optional city to also pre-fill in the builder (skips the "pick a city" step in the chat-to-product handoff).

add_cause

Compose a builder URL with a fundraising link pre-filled — the URL is embedded into the GPX metadata (description, filename) so it surfaces in the runner's Strava activity after they sync. CityHeart never collects the donation; the runner's donors click straight through to JustGiving / GoFundMe / Leetchi / etc.

Parameters (2)

fundraising_urlstringrequired
Fully-qualified donation URL (https://www.justgiving.com/... / https://gofundme.com/... / https://leetchi.com/... / https://www.helloasso.com/...).
citystring
Optional city to also pre-fill.

export_gpx

Return the GPX download / checkout URL for a specific public route. The download itself happens on cityheart.run after a one-time €4.99 payment (Stripe — CityHeart never charges through the chat). Use after the user has picked a final route (find / get_details) and confirms they want it.

Parameters (1)

slugstringrequired
Route slug, e.g. "paris-7-2-km-heart-for-marie".

Install

claude_desktop_config.json

{
  "mcpServers": {
    "heart-routes": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://zhenwiaphfwetckfysod.supabase.co/functions/v1/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.