MCP Server
未认领Official MCP server for OpenGolfAPI — 49 tools: golf course data, scoring, competitions, identity. Free tier, no key needed.
01 / 选择客户端
03 / 添加配置
claude mcp add --transport stdio 'opengolfapi-mcp-server' -- 'npx' '-y' '@opengolfapi/mcp-server'04 / 在客户端中确认
打开客户端的 MCP 设置，确认服务器已连接并列出工具。复制配置不代表连接成功。
更多AI & ML服务器
浏览完整目录安全概况
已认领和已认证的服务器每周接受一次静态扫描，显示代码能触及的范围（外部服务、环境变量、shell 命令、代理配置目录）以及带有已知公告的依赖。认领此列表即可获得。 安全概况的工作原理
40 个工具中显示 40 个
文档中列出的工具 (40)
内容来自项目文档。服务器握手不会验证每个工具的说明或行为。
about
What OpenGolfAPI is and how to use this MCP server.
complete_sign_in
Finish sign-in: exchange the 6-digit code for their OpenGolf ID + access token (use as X-OpenGolf-Token to act as them). Pass ref=<inviter playerid> when another player's invite brought them — it credits the referral.
create_competition
Create a Competition (any OpenMatch format). Requires key.
create_dev_key
Mint a developer API key bound to an OpenGolf ID (sign in first via requestsignincode → completesignin). Returns the key ONCE. First-party rail: no OpenGolf ID, no key.
create_tournament_invite
Create a shareable invite (QR/link); everyone who redeems it joins the SAME event/session. maxuses caps size (foursome=4). Requires key.
find_beacons
Discover ACTIVE public beacons (find-my-group / matchmaking). Requires key.
get_awards
A player's OpenAwards — derived trophies + course passport. Requires key.
get_climate
Monthly climate normals + best months to play for a course. Free.
get_competition
A Competition + live gross standings (free).
get_conditions
LIVE weather at a course (temp/wind/precip, forecast-model, 15-min cache). FREE. Feeds playslike.
get_correction
Check the status/verdict of a correction you proposed (approved rejected needsinfo applied). Requires a key.
get_course
Full detail for one course by id: scorecard (par + handicap per hole), tees, location, contact, nearby. Free.
get_my_moments
Read back your own contributed moments (breadcrumbs, swings, putts, conditions…) by player, session, or type. Requires a key.
get_my_shots
Read back your own contributed shots by player or session. Requires a key.
get_nearby
Nearby hotels, restaurants, and other courses for a course. Free.
get_passport
FREE (public, no key). Any golfer's shareable record — display name, OpenGolf Member #, courses played, rounds, trophies, referrals. Show a player's golf resume in your app.
get_profile
A player's public OpenGolf ID card — name, avatar, links, prefs. Free.
get_referrals
How many golfers a user has referred (+ the list) — the viral-loop metric for your app. Needs a key.
get_tees
All tee sets for a course with ratings, slopes, and yardages. Free.
get_weather
Live weather forecast for a course location (Weather.gov). Free.
how_to_build
The safe playbook for building on OpenGolfAPI and contributing data the right way. Call this once before contributing.
join_tournament
Redeem an invite token — the player joins the group/event. Requires key.
link_dev_key
Confirm your OpenGolf ID on an EXISTING key. Sign in first; pass that accesstoken + the key.
list_competitions
List Competitions (free). Filter org/course/status.
list_dev_keys
List the keys owned by your OpenGolf ID (prefixes only). Needs accesstoken from completesignin.
list_game_formats
Every OpenMatch scoring format. GROSS scoring is free & keyless.
log_shot
Contribute a golf shot to the open OpenShot standard (any launch monitor). Requires a key. Units: speed mph, angles deg, spin rpm, distance yds.
plays_like
Effective distance — THE canonical "plays like" number (wind/elevation/temp/altitude), factors itemized. FREE, no key. Pair with getconditions for live wind.
propose_correction
Propose a fix to a course FACT field (phone, website, address, architect, yearbuilt, coursename, city, postalcode, coursetype). Our AI reviews it (approve/reject/needsinfo). Requires a key. Geometry is not correctable here.
record_consent
Record a player's consent grant (auditable, revocable). Requires key.
record_referral
Record that one user referred another (a REFERREDBY edge) — build YOUR app's invite loop on the shared graph, namespaced to your app. Needs a key.
register_webhook
Register an https URL for your domain events (HMAC-signed deliveries, owner-scoped). Requires your key (Authorization: Bearer ogapi…).
request_sign_in_code
Start "Sign in with OpenGolf" for a person: emails them a 6-digit code. No API key needed. They read you the code, then call completesignin.
respond_to_review
Respond to a correction that came back as needsinfo — add a source or explanation and re-open it for review. Requires a key.
score_round
Score a round in any format — GROSS, FREE, no key. players:[{playerid,holes:{"1":4}}] or entries:[{playerid,hole,value}]; holes:[{hole,par,strokeindex?}].
search_courses
Search US golf courses by name, US state, or location (lat/lng + radius). Returns matching courses with location, type, par. Free, ODbL data.
set_beacon
Broadcast a consented, EXPIRING presence/availability beacon (presentavailableopen). Requires key.
sign_in_with_opengolf
Derive a user's OpenGolf ID deterministically from their email (sub = ogid + sha256(lower(trim(email)))[:16]) — one line, no redirect. For a VERIFIED session token use requestsignincode → completesignin.
submit_moment
Contribute an Open Connect event from any sensor/wearable/phone. The whole sensor spectrum rides through here — type-specific data goes in payload. Requires a key.
update_profile
Edit a player's self-asserted profile fields (derived facts can't be set). Requires key (claimed players need their grant).