{"schema_version":"1.0","name":"stymie-golf","description":"Search 20,000+ US golf course listings, full scorecards, slope ratings, tee recommendations, 3,400+ architect bios, 2,400+ college golf programs, course rankings, logos gallery, and more. The most comprehensive structured golf course data available for AI agents.","url":"https://stymie.golf","repository":"https://github.com/ThatDudeFreak/stymie","transport":{"streamable_http":{"url":"https://mcp.stymie.golf/mcp","note":"Remote stateless endpoint — no setup required, just connect"},"stdio":{"command":"node","args":["mcp/index.js"],"env":{"DATABASE_URL":"required — Neon PostgreSQL connection string"},"install":"git clone https://github.com/ThatDudeFreak/stymie && cd stymie/mcp && npm install"}},"tools":[{"name":"search_courses","description":"Search the directory of 20,000+ US golf courses by name, state, city, ZIP code, type, or hole count. Returns course name, location, type, holes, architect, and ratings.","input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Course name search (partial match)"},"state":{"type":"string","description":"2-letter state code, e.g. \"NJ\""},"city":{"type":"string","description":"City name"},"zip":{"type":"string","description":"5-digit ZIP code for proximity search (50-mile radius)"},"type":{"type":"string","enum":["public","private","semi_private","municipal","resort"],"description":"Course type filter"},"holes":{"type":"string","enum":["9","18","27","36"],"description":"Number of holes"},"page":{"type":"integer","description":"Page number (default 1)"},"limit":{"type":"integer","description":"Results per page, max 50 (default 20)"}}},"example_queries":["Find public golf courses in New Jersey","Golf courses near 07701","Private 18-hole courses in California"]},{"name":"get_course","description":"Full course detail by URL slug: name, location, type, holes, architect, year built, amenities, contact info, USGA slope/course/bogey ratings, tee summary, nearby courses, and weather.","input_schema":{"type":"object","properties":{"slug":{"type":"string","description":"Course full_slug, e.g. \"new-jersey/monmouth-county/red-bank/navesink-country-club\""}},"required":["slug"]},"example_queries":["Tell me about Pine Valley Golf Club","What amenities does Pebble Beach have?"]},{"name":"get_scorecard","description":"Hole-by-hole scorecard: all tee sets with par, yardage, stroke index, front/back nine ratings, slope, and course rating per tee.","input_schema":{"type":"object","properties":{"slug":{"type":"string","description":"Course full_slug"}},"required":["slug"]},"example_queries":["Show me the scorecard for Bethpage Black","What is the yardage on hole 12 at Augusta?"]},{"name":"get_reviews","description":"User reviews for a golf course with star ratings (1-5), sub-ratings for condition, pace, and value, review text, tee played, and reviewer handicap.","input_schema":{"type":"object","properties":{"slug":{"type":"string","description":"Course full_slug"},"limit":{"type":"integer","description":"Max reviews to return (default 10, max 25)"}},"required":["slug"]},"example_queries":["What do golfers say about Torrey Pines?","Reviews for Pinehurst No. 2"]},{"name":"get_architect","description":"Golf course architect bio, Wikipedia image, birth/death years, nationality, and all courses they designed grouped by state. Search by name or URL slug.","input_schema":{"type":"object","properties":{"name":{"type":"string","description":"Architect name, e.g. \"Robert Trent Jones Sr.\""},"slug":{"type":"string","description":"Architect slug, e.g. \"robert-trent-jones-sr\""}}},"example_queries":["Who is Donald Ross?","What courses did Tom Fazio design?"]},{"name":"get_leaderboard","description":"Top courses in a state by category: hardest (highest slope), easiest (lowest slope, public only), or longest (most yardage from back tees).","input_schema":{"type":"object","properties":{"state":{"type":"string","description":"2-letter state code, e.g. \"NJ\""},"category":{"type":"string","enum":["hardest","easiest","longest"],"description":"Ranking category (default: hardest)"},"limit":{"type":"integer","description":"Number of results (default 10, max 25)"}},"required":["state"]},"example_queries":["What is the hardest golf course in New Jersey?","Easiest public courses in Florida","Longest courses in Texas"]},{"name":"search_tee_times","description":"Search for available tee times (coming soon). Currently returns a link to the course page and alert signup on Stymie.","input_schema":{"type":"object","properties":{"slug":{"type":"string","description":"Course full_slug"},"date":{"type":"string","description":"Desired date (YYYY-MM-DD)"},"players":{"type":"integer","description":"Number of players (1-4)"}},"required":["slug"]},"example_queries":["Find tee times at Pebble Beach next Saturday"]}],"data_coverage":{"total_courses":"20,000+","states":50,"scorecards":"540+","architects":"3,400+","college_programs":"2,400+","course_logos":"community submitted","practice_facilities":"driving ranges, simulators, pitch-and-putt, disc golf","data_sources":["OpenStreetMap","USGA","GolfCourseAPI","Wikipedia"]},"features":{"course_directory":"Full course pages with scorecards, slope ratings, tee recommendations, amenities, weather","architect_directory":"3,400+ architects with bios, photos, and portfolios","college_golf":"2,400+ programs across NCAA D1/D2/D3, NAIA, JUCO","course_logos":"Community-submitted golf course logo gallery","rankings":"Hardest, easiest, and longest courses ranked by state","state_county_directory":"Browse courses by state, county, and city","course_passport":"Track rounds played across all 50 states","group_finder":"Golfer matchmaking by handicap, pace, and play style","tee_time_alerts":"Coming soon — monitor availability and get notified","practice_facilities":"Driving ranges, academies, simulators","glossary":"Plain-English golf term definitions","blog":"Golf content and course guides","interactive_map":"Map view of all courses","og_social_cards":"Branded OG images for every course, state, architect, and section"},"related":{"llms_txt":"https://stymie.golf/llms.txt","ai_txt":"https://stymie.golf/ai.txt","sitemap":"https://stymie.golf/sitemap.xml","blog_rss":"https://stymie.golf/blog/rss.xml","api":"https://api.stymie.golf"}}