> 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="/files/cyPXh4WWswp4hegAYf7v" 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.