Stymie Golf
Read-only US golf course, scorecard, equipment, deal, and golf-trip data for AI agents.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"stymie-golf": {
"url": "https://mcp-production-680d.up.railway.app/mcp"
}
}
}Puntos de conexión remotos
https://mcp-production-680d.up.railway.app/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (12)
🟢search_courses(query, state, city, zip, location, ...)
Search for a named course or filter the directory by city/state, access, and holes. For a trip near a place, station, address, or ZIP, call find_nearby_courses FIRST; do not put the place name in query (query searches course names). You may also pass location here for a proximity search. Returns canonical Stymie URLs, reusable slugs, access, holes, scorecard availability, and straight-line miles when a location is supplied. Copy returned URLs; never construct county slugs. Next: get_course with a returned URL, or build_golf_trip with the resolved center and preferences.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "Course name search (partial match)",
"type": "string"
},
"state": {
"description": "State/province code, e.g. IL, ON, NSW",
"type": "string",
"minLength": 2,
"maxLength": 3
},
"city": {
"description": "City name",
"type": "string"
},
"zip": {
"description": "US ZIP; use location for other places",
"type": "string",
"pattern": "^\\d{5}$"
},
"location": {
"description": "Plain-language place, station, address, or US ZIP; find_nearby_courses is the recommended first step for trips",
"type": "string",
"maxLength": 200
},
"country": {
"type": "string",
"enum": [
"US",
"CA",
"GB",
"IE",
"AU",
"NZ"
]
},
"distance_miles": {
"default": 50,
"type": "number",
"minimum": 1,
"maximum": 50
},
"type": {
"description": "Course type filter",
"type": "string",
"enum": [
"public",
"private",
"semi_private",
"municipal",
"resort"
]
},
"holes": {
"description": "Number of holes",
"anyOf": [
{
"type": "string",
"enum": [
"9",
"18",
"27",
"36"
]
},
{
"type": "number",
"const": 9
},
{
"type": "number",
"const": 18
},
{
"type": "number",
"const": 27
},
{
"type": "number",
"const": 36
}
]
},
"page": {
"default": 1,
"description": "Page number",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"default": 20,
"description": "Results per page (max 50)",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_course(slug)
Get full details for a specific golf course by a returned Stymie URL or slug. Returns name, location, type, holes, architect, year built, amenities, contact info, slope stats, and nearby courses. Covers the US, Canada, UK, Ireland, Australia and New Zealand.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Paste the canonical Stymie course URL or reusable slug returned by search_courses, find_nearby_courses, or build_golf_trip"
}
},
"required": [
"slug"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_scorecard(slug)
Get the full scorecard for a golf course: all tee sets with hole-by-hole par, yardage, stroke index, and front/back nine ratings. Available for thousands of courses with scorecard data.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Paste the canonical Stymie course URL or reusable slug returned by search_courses, find_nearby_courses, or build_golf_trip"
}
},
"required": [
"slug"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_architect(name, slug)
Get details about a golf course architect: bio, Wikipedia image, birth/death years, nationality, and all courses they designed grouped by state. Provide either the architect name or URL slug.
Esquema de entrada
{
"type": "object",
"properties": {
"name": {
"description": "Architect name, e.g. \"Robert Trent Jones Sr.\"",
"type": "string"
},
"slug": {
"description": "Architect slug, e.g. \"robert-trent-jones-sr\"",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_leaderboard(state, category, limit)
Get the top golf courses in a state by category: hardest (highest slope), easiest (lowest slope, public only), or longest (most yardage). Great for answering "hardest course in NJ" type questions.
Esquema de entrada
{
"type": "object",
"properties": {
"state": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "2-letter state code, e.g. \"NJ\""
},
"category": {
"default": "hardest",
"description": "Ranking category",
"type": "string",
"enum": [
"hardest",
"easiest",
"longest"
]
},
"limit": {
"default": 10,
"description": "Number of results",
"type": "integer",
"minimum": 1,
"maximum": 25
}
},
"required": [
"state"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search_tee_times(slug, date, players)
Search for available tee times at a golf course. Note: live tee-time inventory is not available on Stymie. Returns the Stymie course page (official website and phone for booking) and the tee-time alert early-access list.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Course full_slug"
},
"date": {
"description": "Desired date (YYYY-MM-DD)",
"type": "string"
},
"players": {
"description": "Number of players",
"type": "integer",
"minimum": 1,
"maximum": 4
}
},
"required": [
"slug"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search_stymie(query, state, limit)
Search Stymie across golf courses, current equipment, architects, and major site tools. Use this first when the user does not specify which Stymie collection they need.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "A course, equipment model, brand, architect, destination, or golf topic"
},
"state": {
"description": "Optional 2-letter state filter for course results",
"type": "string",
"minLength": 2,
"maxLength": 3
},
"limit": {
"default": 8,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search_equipment(query, category, limit)
Search current golf balls, drivers, putters, rangefinders, and launch monitors. Returns official Stymie detail URLs, images, MSRP, and stated best-for guidance when published.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Brand and/or model name"
},
"category": {
"type": "string",
"enum": [
"ball",
"driver",
"putter",
"rangefinder",
"launch_monitor"
]
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 30
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢find_nearby_courses(location, state, country, latitude, longitude, ...)
START HERE to plan golf near a place, transit station, address, or US ZIP: pass the place text as location, plus access (public/private/all) and holes (9/18) if known. Coordinates are optional; no slug knowledge is needed. Resolves the location and returns its labeled center and a nearest-first ranked shortlist with canonical Stymie URLs, reusable slugs, straight-line miles, access, holes, and scorecard availability. If the place is ambiguous, ask the golfer to choose a candidate. NEXT call build_golf_trip with the returned latitude/longitude and the same preferences for 1-4 course picks. Use search_courses only for a specific course name. Copy returned URLs verbatim; distances are not drive/transit times.
Esquema de entrada
{
"type": "object",
"properties": {
"location": {
"description": "Place name, transit station, address, or US ZIP; extract the place from the golfer’s sentence",
"type": "string",
"maxLength": 200
},
"state": {
"description": "State/province code, e.g. IL, ON, or NSW, to disambiguate a place",
"type": "string",
"minLength": 2,
"maxLength": 3
},
"country": {
"description": "Country code to disambiguate a place; GB means UK",
"type": "string",
"enum": [
"US",
"CA",
"GB",
"IE",
"AU",
"NZ"
]
},
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"distance_miles": {
"default": "25",
"description": "Search radius in miles: one of 5, 10, 20, 25, 50",
"anyOf": [
{
"type": "string",
"enum": [
"5",
"10",
"20",
"25",
"50"
]
},
{
"type": "number",
"const": 5
},
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 20
},
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
}
]
},
"access": {
"default": "all",
"type": "string",
"enum": [
"all",
"public",
"private",
"semi_private",
"municipal",
"resort"
]
},
"holes": {
"description": "Total course holes; omit if flexible",
"anyOf": [
{
"type": "string",
"enum": [
"9",
"18",
"27",
"36"
]
},
{
"type": "number",
"const": 9
},
{
"type": "number",
"const": 18
},
{
"type": "number",
"const": 27
},
{
"type": "number",
"const": 36
}
]
},
"limit": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢build_golf_trip(location, state, country, latitude, longitude, ...)
AFTER find_nearby_courses, pass its center latitude/longitude, access and holes preferences, and number_of_courses to make a 1-4 course shortlist. You can also start directly with a plain-language location (place, station, address, or US ZIP). Optional tee yardage and slope ranges rank matching tees by fit plus straight-line distance; without tee preferences, courses are nearest-first and missing scorecards are retained. Returns ranked course picks with canonical Stymie URLs, reusable slugs, selection reasons, distance, access, holes, and published tee data when available. Public access excludes unknown/private courses; private picks require the golfer to confirm access. No booking, tee-time availability, transit routing, or drive times are provided. Use returned URLs as citations without inventing slugs.
Esquema de entrada
{
"type": "object",
"properties": {
"location": {
"description": "Place name, station, address, or US ZIP; omit when reusing the nearby result coordinates",
"type": "string",
"maxLength": 200
},
"state": {
"type": "string",
"minLength": 2,
"maxLength": 3
},
"country": {
"description": "Country code to disambiguate a place; GB means UK",
"type": "string",
"enum": [
"US",
"CA",
"GB",
"IE",
"AU",
"NZ"
]
},
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"access": {
"default": "public",
"type": "string",
"enum": [
"all",
"public",
"private",
"semi_private",
"municipal",
"resort"
]
},
"holes": {
"anyOf": [
{
"type": "string",
"enum": [
"9",
"18",
"27",
"36"
]
},
{
"type": "number",
"const": 9
},
{
"type": "number",
"const": 18
},
{
"type": "number",
"const": 27
},
{
"type": "number",
"const": 36
}
]
},
"number_of_courses": {
"default": 2,
"type": "integer",
"minimum": 1,
"maximum": 4
},
"distance_miles": {
"default": "25",
"description": "Search radius in miles: one of 5, 10, 20, 25, 50",
"anyOf": [
{
"type": "string",
"enum": [
"5",
"10",
"20",
"25",
"50"
]
},
{
"type": "number",
"const": 5
},
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 20
},
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
}
]
},
"tee_yards_min": {
"type": "integer",
"minimum": 500,
"maximum": 8500
},
"tee_yards_max": {
"type": "integer",
"minimum": 500,
"maximum": 8500
},
"slope_min": {
"type": "integer",
"minimum": 55,
"maximum": 155
},
"slope_max": {
"type": "integer",
"minimum": 55,
"maximum": 155
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_deals(category, limit)
Get currently verified sale offers for golf equipment. Only in-stock offers checked within the last 48 hours with a current price below list price are returned. Links may be affiliate links, at no extra cost to the buyer.
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"type": "string",
"enum": [
"ball",
"driver",
"putter",
"rangefinder",
"launch_monitor"
]
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_data_coverage
Return a live count of Stymie course, scorecard, logo, architect, equipment, and current-deal coverage. Use this instead of quoting hardcoded catalog sizes.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia