plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "racethere",
  "version": "1.0.0",
  "description": "Find upcoming US running races and compare dates, distances, fees and registration status.",
  "author": {
    "name": "RaceThere",
    "email": "team@highridge.dev",
    "url": "https://racethere.com"
  },
  "homepage": "https://racethere.com/connect",
  "keywords": [
    "running",
    "races",
    "5k",
    "10k",
    "half marathon",
    "marathon",
    "trail running"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "RaceThere",
        "shortDescription": "Find your next running race",
        "longDescription": "Find upcoming running races across the United States by city, state or ZIP code, distance, date and race type. Compare 5Ks, 10Ks, half marathons, marathons, ultras, trail races and races with virtual options. Open a race to see its events, local start times, current fees, registration status and organizer description. Predict finish times and paces at other distances from a recent result. RaceThere uses race listings supplied through RunSignUp. Coverage is limited to US events listed there; details and availability can change. Race cards appear in supported assistants. Registration and payment happen on the organizer's registration site. Finish-time predictions are estimates based on Riegel's formula and assume training for the target distance.",
        "developerName": "RaceThere",
        "category": "Healthcare",
        "capabilities": [
          "Find running races",
          "Read race details",
          "Predict race times"
        ],
        "websiteURL": "https://racethere.com",
        "supportURL": "https://racethere.com/support",
        "privacyPolicyURL": "https://racethere.com/privacy",
        "termsOfServiceURL": "https://racethere.com/terms",
        "defaultPrompt": [
          "Find half marathons within 50 miles of Austin, Texas, in March 2027.",
          "Find trail races within 50 miles of Boulder, Colorado, in the next four weeks.",
          "I ran a 25:30 5K. Predict my 10K and half marathon times."
        ],
        "brandColor": "#FF4F12",
        "brandColorDark": "#FF7A4A",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search by city, radius, distance and month",
              "prompt": "Find half marathons within 50 miles of Austin, Texas, in March 2027.",
              "tools_triggered": "search_races",
              "expected_behavior": "Search Austin, TX with radius_miles=50, distance=half and when=2027-03. Show matching upcoming races and their dates, locations, fees and RaceThere links. Treat fees marked 'from' as starting fees across the race's events, not necessarily the half marathon price. If no races match at review time, report no matches."
            },
            {
              "description": "Search trail races in a relative date window",
              "prompt": "Find trail races within 50 miles of Boulder, Colorado, in the next four weeks.",
              "tools_triggered": "search_races",
              "expected_behavior": "Search Boulder, CO with radius_miles=50, type=trail and when=4w. Show the returned races with local dates and links, or clearly report no matches. Do not invent results."
            },
            {
              "description": "Search by ZIP code and distance",
              "prompt": "Find 5Ks within 25 miles of ZIP code 60601 in the next four weeks.",
              "tools_triggered": "search_races",
              "expected_behavior": "Search zip=60601 with radius_miles=25, distance=5k and when=4w. Preserve registration_open and unknown fees when describing results. Follow next_page only when present."
            },
            {
              "description": "Read details for a race returned by search",
              "prompt": "Find upcoming races near Austin, Texas. Open one of the results and show its events, start times, entry fees and registration status.",
              "tools_triggered": "search_races, get_race",
              "expected_behavior": "Search Austin, TX, then pass an actual returned id to get_race. Show event-specific distances, local start times and fees. Preserve any schedule note, cancellation or registration closure. Link to the returned RaceThere and registration URLs; do not claim to register the runner."
            },
            {
              "description": "Calculate predictions from a recent race result",
              "prompt": "I ran a 25:30 5K. Predict my 10K and half marathon times.",
              "tools_triggered": "predict_race_time",
              "expected_behavior": "Call with distance=5k and time=25:30. With no target_distance, the current result includes 10K in 53:10 and half marathon in 1:57:18. Describe these as estimates using Riegel's formula that assume training for the target distance. Do not present them as guarantees or medical advice."
            }
          ],
          "negative": [
            {
              "description": "Unsupported registration and payment",
              "prompt": "Register me for the first race and pay the entry fee with my credit card.",
              "expected_behavior": "Explain that RaceThere cannot register or pay. Offer the organizer's registration link if a race has been selected. Do not collect card details, invent a registration tool or claim a purchase succeeded."
            },
            {
              "description": "Location outside US coverage",
              "prompt": "Find half marathons in Paris, France, next month.",
              "expected_behavior": "Do not invoke RaceThere to search outside US coverage, reinterpret Paris, France as a US city or claim that RaceThere supplied international results. Explain the US coverage limit, offer a US search, or use a separate, clearly sourced general-web fallback."
            },
            {
              "description": "Missing input for a prediction",
              "prompt": "Predict a new runner\u2019s marathon finish time. They have not supplied any recent race time or distance.",
              "expected_behavior": "Ask for a recent distance and finish time, or explain why a prediction cannot be calculated. Do not call predict_race_time with made-up inputs."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "RaceThere provides race discovery and calculations. It does not register runners, sell entries or process payments. Race details include an external registration link routed through RaceThere to RunSignUp or the organizer. Registration links may include RaceThere's referral code."
      },
      "publication": {
        "release_notes": "Initial release with US race search, event details, interactive race cards and race-time predictions."
      },
      "apps": "./.app.json"
    }
  }
}