> 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/prompts.md).

# Prompts

Prompts are pre-built briefings that orchestrate multiple API calls server-side and return structured, presentation-ready content in a single command. They appear as native actions in supported clients like Claude Desktop.

### Available prompts

| Prompt            | Description                                                    |
| ----------------- | -------------------------------------------------------------- |
| `match_preview`   | Pre-match briefing with fixture details and last 5 H2H results |
| `team_overview`   | Team profile, upcoming fixtures, and current league standing   |
| `league_overview` | Full standings table and upcoming fixtures for a league        |

### match\_preview

Generates a concise pre-match briefing for an upcoming fixture. Fetches the fixture details and the last 5 head-to-head results between the two teams.

> Only works for fixtures that have **not yet started**.

**Arguments**

| Argument     | Required | Description                                 |
| ------------ | -------- | ------------------------------------------- |
| `fixture_id` | Yes      | Sportmonks fixture ID for an upcoming match |

**Output includes:** match details, kick-off time, and a head-to-head table showing scores and results from the last 5 meetings.

### team\_overview

Generates a team briefing pulling together entity details, upcoming fixtures for the next 14 days, and the team's current position in their league table.

**Arguments**

| Argument  | Required | Description        |
| --------- | -------- | ------------------ |
| `team_id` | Yes      | Sportmonks team ID |

**Output includes:** team name, country, venue, upcoming fixture list, and current league standing (position, played, won, drawn, lost, GD, points).

### league\_overview

Generates a full league briefing with the complete standings table and all upcoming fixtures for the next 14 days.

**Arguments**

| Argument    | Required | Description          |
| ----------- | -------- | -------------------- |
| `league_id` | Yes      | Sportmonks league ID |

**Output includes:** league name, country, full standings table, and upcoming fixture list.

### How to use prompts

Prompts are part of the MCP protocol. When invoked, the server fetches live data from Sportmonks, formats it into a structured briefing, and returns it as a user message for the AI to respond to.

#### Claude Code and Cursor

Reference the prompt by name in your message:

```
Run the match_preview prompt for fixture ID 19135697
```

```
Use the team_overview prompt for team ID 85
```

```
Generate a league_overview for league ID 8
```

#### Claude Desktop

Claude Desktop surfaces MCP prompts in the UI - the exact location depends on your version. If you don't see a dedicated prompt picker, you can invoke them the same way as Claude Code: just ask by name with the required argument.


---

# 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/prompts.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.