The golf app your agent can use.

Over MCP, an AI agent can find a course, read its card and open its map without a key or account; the REST API takes a free API key. Personal distance and caddie tools require the golfer to sign in and have Premium.

Connect in one line

Add the MCP server.

No key and no account for course search and scorecards. The full reference, with every parameter, is on the developers page.

{
  "mcpServers": {
    "golfcore": { "url": "https://mcp.golfcore.org/mcp" }
  }
}

The tools

Nine tools, read from the live server on October 12, 2026.

Course data

No account or key.

  • searchFind courses by name, slug, place or position, with scorecards, mapping coverage and the app_url that opens each map.Read-only

For the golfer

The golfer signs in to GolfCore the first time. Both need Premium; without it they list the plans.

  • distance_to_flagYards to today's pin and the middle of the green, from the golfer's position or the GolfCore app on their phone.Read-only
  • ask_caddieA club and a line for the shot in front of them, from the distance, hazards, trees, modeled wind, elevation and their own club distances.Answers
  • subscribe_premiumA Stripe checkout link for the Day Pass, monthly or yearly plan. It does not charge the golfer.Checkout link

For a developer

The developer signs in to GolfCore. The agent confirms names, plans and caps with them first.

  • api_accountPlan, this month's usage, any monthly cap and key prefixes. Never a secret.Read-only
  • api_create_keyA new Course Data API key. The secret is shown once.Writes
  • api_revoke_keyRevokes a key within about a minute. It cannot be restored.Destructive
  • api_upgradeA Stripe checkout link for Starter or Pro. It does not charge.Checkout link
  • api_budgetSets or removes an optional monthly cap on a paid plan.Writes

What is in place

Each claim links to the place an agent can check it.

  • Discovery

    llms.txt, an RFC 9727 API catalog, an agent skills index and an MCP server card. Pages link to the API catalog, OpenAPI description and llms.txt.

    llms.txtapi-catalogskills

  • MCP server

    Streamable HTTP. Public course search and scorecards need no account. Distance to the flag and caddie advice need GolfCore OAuth and Premium. A signed-in golfer can request a Stripe checkout link for a chosen Premium plan.

    server cardOAuth metadata

  • REST API

    CORS-open JSON with an OpenAPI 3.1 description, called with an API key; the Free plan costs nothing, and keyless access ends December 4, 2026. Search by name, place, coordinates or mapping coverage; read a full scorecard by slug.

    OpenAPIAPI keysstatus

  • Hand-off to the person

    Every course the API or MCP server returns carries app_url, which opens that course's map, on a hole if asked. A signed-out person starts as a guest. On a phone with GolfCore installed, the same link opens the native iOS or Android app.

    skill

  • Browser agents in the app

    In a browser with WebMCP, golfcore.app registers tools to find courses, open one, read the hole on screen with the player's distance to the pin, and change holes. Without it, the controls are labelled buttons and the hole selector names the hole and par.

    app auth.md

  • Pages an agent can read

    Every course page on this site is static HTML: the card in tables, every figure in text, and GolfCourse structured data. Course pages on golfcore.app link to both by Link header and in noscript.

    course directory

  • Access

    Course search over MCP needs no key or sign-up. The REST API takes an API key from platform.golfcore.app, free up to 500 requests a month; keyed responses carry X-RateLimit headers, GET /v1/usage reports the month, and 429 means a limit was reached. Browser agents can start a guest session for the course map; personal caddie and distance tools require GolfCore sign-in and Premium.

    auth.mdrobots.txt

What an agent can do for a golfer

  • Which courses near me have green contour maps?

    MCP search with near and coverage "contours", or https://api.golfcore.org/v1/courses?near=lat,lng&coverage=contours

  • What's the par and yardage on every hole at Pebble Beach from the blue tees?

    MCP search with scope ["slug","scorecards"], or https://api.golfcore.org/v1/courses/pebble-beach

  • Show me the 7th green at Pebble Beach.

    Give the person the course's app_url with &hole=7, or call open_course in the app

  • How far am I from the pin?

    MCP distance_to_flag with GolfCore OAuth and Premium, or get_current_hole in the app once the player has shared their location

For personal agents that use a browser

Open a course result's app_url for the golfer and read scorecard facts from the public API. The web app can start a guest session for the map. A guest cannot use personalized distance or caddie tools. Those tools require the golfer to sign in to GolfCore and have Premium. When the golfer chooses a Premium plan, the subscribe_premium MCP tool creates a Stripe checkout link; show the current price and renewal terms and let the golfer complete payment on Stripe. A checkout link is not a completed purchase.

Where the line is

Agents can read public course data and move the map. The MCP server can also return a distance to the flag, AI caddie advice, and a Stripe checkout link after GolfCore sign-in. Distance and caddie advice require Premium. The checkout tool does not charge the golfer; they review and pay on Stripe. Agents cannot book tee times, write scores, send messages or access club rosters through these tools. The satellite map, yardage and scoring are free. Green contours, illustrated maps, modeled wind and offline downloads require Premium after any complimentary preview.

Read the MCP server card Developer reference