Sign inGet API key Console

Docs

MCP server

Connect Claude, Codex, Grok, Cursor, ChatGPT and other MCP clients to the catalog at https://mcp.golfapi.dev with your API key.

    Step-by-step setup for each client is on the MCP page. This page is the reference.

    Server URL

    code
    https://mcp.golfapi.dev

    The server speaks Streamable HTTP and is read-only. Each tool sends one GET to the API with your key, so a tool call counts as one request against your plan and reads only what your key can read. A sk_test_ key reads the sandbox sample, the 2025 and 2026 drivers. A sk_live_ key reads the whole catalog.

    The older address https://mcp.golfapi.dev/mcp keeps working, and so does https://clubapi.golfapi.dev/mcp.

    Connect a client

    Clients that support OAuth, such as Claude, Grok and ChatGPT connectors, open a GolfAPI.dev page that asks for an API key. Paste the full sk_live_ or sk_test_ secret, not the key_ id. Revoking the key in the Console disconnects the client.

    Clients that can send headers can pass the key directly. In Claude Code:

    Shell
    claude mcp add --transport http golfapi https://mcp.golfapi.dev \
  --header "Authorization: Bearer $GOLFDEV_API_KEY"

    Run export GOLFDEV_API_KEY='sk_test_…' with your key in the same terminal first. Leave $GOLFDEV_API_KEY as written; the shell replaces it with your key. How to set your key

    Create a key in the Console. See Authentication for key types.

    Tools

    • describe_api: club types, routes, the response version, what this key can read and the catalog build it reads now. Call it first.
    • search_clubs: list clubs of one type, newest first, filtered by text, maker, family, release year, hand, loft, women's designation or adjustable hosel. Price filters need the Pro plan.
    • get_club: one club's document by clb_ id or slug, with an optional hand or loft filter on its variants.
    • get_coverage: clubs per maker and release year, and how many clubs carry each field.
    • get_changes: catalog releases published after a build you already read, with each club added, updated, corrected or removed.
    • api_get: a GET to any API path, for routes the other tools do not cover.

    Missing values

    A field missing from a document has no published value. A 0 or false is a real value. Do not fill a missing field from another club, hand or loft. See Views and access for what each plan returns.