# AI and MCP

Connect an agent to current documentation and the same talent rules used by the calculator.

Source: https://warcraftforever.com/developers/ai/

## Connect

Add this remote MCP server URL to your client's MCP settings:

```text
https://warcraftforever.com/mcp
```

The endpoint uses Streamable HTTP. It is public and read-only, with no account or API key. Your client determines how to add remote servers; copy the URL into its server configuration.

## Available tools

| Tool                    | Use                                                                                        |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| `search_docs`           | Find guides and reference pages by query.                                                  |
| `get_doc`               | Read a document by the ID returned from search.                                            |
| `list_catalogs`         | Discover reference resources, channels, builds, and source provenance.                     |
| `get_catalog`           | Read classes, playable races and eligibility, factions, or hunter pet families.            |
| `discover_data`         | Discover resource datasets, coverage gaps and limits.                                      |
| `get_records`           | Read up to 50 item, recipe, profession or supported spell IDs.                             |
| `search_records`        | Search those resources with bounded cursor pagination.                                     |
| `get_references`        | Read supported reference values.                                                           |
| `get_talent_definition` | Retrieve a class's current or specified archived talent layout.                            |
| `validate_talent_build` | Validate a compact or Blizzard in-game build using its class, revision, and maximum level. |

For example, ask an agent: “Read Warcraft Forever's guide to saving a talent build, then verify this Paladin build is complete for level 30.”

`validate_talent_build` distinguishes legality from completion. A legal 20-point allocation at level 30 has `valid: true` and `complete: false`. Preserve the explicit revision when validating saved builds; unsupported revisions fail instead of falling back to the current layout.

The tools use published documentation, catalog snapshots, and talent assets. `get_catalog` accepts `resource`, optional `channel`, and a client `locale` (default `enUS`). Responses include the same provenance and name-locale markers as HTTP. Pet families do not establish NPC tameability. Authorization and persistence remain with your application.

## Resources

Resources expose each published Markdown guide, both catalog/data manifests, and JSON schemas for data-tool inputs. The schemas are derived from tool validation. See [Game data](https://warcraftforever.com/developers/data/#http-and-mcp) for resource URIs and coverage.

## Read without MCP

- [Documentation index](https://warcraftforever.com/llms.txt)
- [Complete documentation](https://warcraftforever.com/llms-full.txt)
- Use **View Markdown** or **Copy for AI** on any page for a focused document.

These representations are generated from the same source as this portal. Search results and tool responses include canonical source URLs.