How do I connect MCP Server to Claude?

Run `claude mcp add opengolfapi-mcp-server -- npx -y @opengolfapi/mcp-server` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can MCP Server do?

MCP Server documents 40 tools to the agent, including about, complete_sign_in, create_competition. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

MCP Server

Unclaimed

by opengolfapi

Official MCP server for OpenGolfAPI — 49 tools: golf course data, scoring, competitions, identity. Free tier, no key needed.

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'opengolfapi-mcp-server' -- 'npx' '-y' '@opengolfapi/mcp-server'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

ai-agentsclaudegolfgolf-coursesmcpmcp-servermodel-context-protocol

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

40 of 40 tools

Documented tools (40)

From project documentation. A server handshake does not verify each tool’s description or behavior.

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).

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about MCP Server

How do I connect MCP Server to Claude?: Run `claude mcp add opengolfapi-mcp-server -- npx -y @opengolfapi/mcp-server` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can MCP Server do?: MCP Server documents 40 tools to the agent, including about, complete_sign_in, create_competition. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.