Skip to main content
Glama
README.md
# gta6-mcp

A small [MCP](https://modelcontextprotocol.io) server that answers questions about **Grand Theft Auto VI** from live wiki APIs. It does not ship a copy of the articles.

It looks up cheat codes first, then Easter eggs and hidden secrets, then the rest of the game: story, characters, the Leonida map and locations, vehicles, weapons, missions, release and platform facts, and patches.

Cheat pages fill up with junk right after a launch. A code is marked **confirmed** only when the GTA Wiki cites a reliable source, or two independent sources agree. Every other code is **unverified**. Do not present an unverified code as real.

## Install in Claude Code

```bash
claude mcp add gta6 -- npx -y github:Blaze-sports-Intel/gta6-mcp
```

Node 18 or newer. The package builds from source on install. No API key.

Claude Desktop, if you are not using Claude Code:

```json
{
  "mcpServers": {
    "gta6": {
      "command": "npx",
      "args": ["-y", "github:Blaze-sports-Intel/gta6-mcp"]
    }
  }
}
```

## Tools

| Tool | What it returns |
| --- | --- |
| `search_gta6(query)` | Ranked GTA Wiki hits with snippets and URLs. Release, sales, and platform questions also search Wikipedia. |
| `get_page(title, section?)` | A short plain-text lead, or one section. `found: false` when the page is not there. |
| `list_cheats(platform?)` | Rows of code, effect, unlock, platform, source URL, and `confidence`. `platform` is `ps5`, `xbox`, or `pc`. |
| `easter_eggs(topic?)` | Easter eggs and secrets. If the dedicated GTA VI page does not exist yet, it says so and returns the closest section, usually Trivia. |

Every answer has a short summary, the source page URL, and a CC BY-SA attribution.

## Sources

- GTA Wiki, Fandom MediaWiki API: `https://gta.fandom.com/api.php`
- English Wikipedia API, for release, sales, and platform facts: `https://en.wikipedia.org/w/api.php`

Requests use `User-Agent: gta6-mcp/0.1 (+https://github.com/Blaze-sports-Intel/gta6-mcp)`, stay at about one request a second per host, and cache responses in memory for about an hour. Nothing behind a login or a paywall. No leaked builds. No API key.

X posts are not a source. A link to X inside a wiki article does not count as confirmation.

## License

The **code** in this repository is [MIT](LICENSE).

**Wiki text is not.** Text from the GTA Wiki on Fandom is CC BY-SA ([Fandom licensing](https://www.fandom.com/licensing)). Text from Wikipedia is [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). Attribute the contributors and link the page the answer came from. This repo does not vendor articles. `test/fixtures/` holds short recorded API responses so tests can run offline, under the same licenses.

## Develop

```bash
npm test
npm run smoke
```

`npm test` replays fixtures. `npm run smoke` starts the stdio server and calls each tool against the live wikis.

TDQS

A3.5/5.0

Scored across 4 tools

Disambiguation4/5

search_gta6 and get_page are related (search then fetch) but clearly differentiated by output type (ranked hits vs. one page summary). list_cheats and easter_eggs target distinct content categories, so an agent can pick correctly, though the search/fetch pairing is the one place a brief confusion could occur.

Naming Consistency3/5

Three tools follow a verb_noun pattern (search_gta6, get_page, list_cheats), but easter_eggs is a bare noun phrase with no verb, breaking the convention. Names are readable but the pattern is not uniform.

Tool Count4/5

Four tools is on the lean side but appropriate for a narrow GTA6 wiki lookup server; each tool earns its place by covering search, page retrieval, cheats, and secrets. Slightly thin but not problematic.

Completeness4/5

search_gta6 plus get_page give generic access to any GTA Wiki page or section, while list_cheats and easter_eggs handle two structured content types. That covers most lookup needs, though additional structured extractors (e.g. vehicles, missions, characters) are absent and left to generic page fetches.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues