> For the complete documentation index, see [llms.txt](https://docs.sportmonks.com/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportmonks.com/v3/sportmonks-ai-docs/mcp-server-beta/quick-start.md).

# Quick Start

### 1. Get your API token

Sign in at [my.sportmonks.com](https://my.sportmonks.com/subscriptions) and copy your API token.

### 2. Install the server

No cloning or building required. The server is published on npm and runs directly via `npx`.

### 3. Register with your AI tool

**Claude Code**

```bash
claude mcp add sportmonks-football \
  --env SPORTMONKS_API_TOKEN="your_token" \
  -- npx sportmonks-football-mcp-server
```

**Claude Desktop** - add to your config file:

```json
{
  "mcpServers": {
    "sportmonks-football": {
      "command": "npx",
      "args": ["sportmonks-football-mcp-server"],
      "env": {
        "SPORTMONKS_API_TOKEN": "your_token"
      }
    }
  }
}
```

Config file locations:

* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`

<figure><img src="https://3469464275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9zsNGu3HAzSnl5DWBD3Y%2Fuploads%2FciOk29NFx13XfYRkPoED%2Fquick--start.png?alt=media&amp;token=5157a002-0b61-47ce-810c-d2dc4796cbd2" alt=""><figcaption></figcaption></figure>

### 4. Try it

```
Search for "Arsenal" and show me their upcoming fixtures
```

```
Give me the current Premier League standings
```

```
Who are the top 10 scorers in La Liga this season?
```

Full setup instructions for each platform: Claude Code · Claude Desktop · Cursor

> Not using Claude? The MCP server also works with Cursor and Windsurf. For ChatGPT and GitHub Copilot, see the AI Tools section for setup options that don't require MCP.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sportmonks.com/v3/sportmonks-ai-docs/mcp-server-beta/quick-start.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.