# Genshin-Builds

> Genshin-Builds is a free multi-game database and companion site for gacha games: character builds, tier lists, team comps, weapons, artifacts, ascension calculators, farming planners, promo codes and news for Genshin Impact, Honkai: Star Rail, Wuthering Waves, Zenless Zone Zero, Tower of Fantasy, Arknights: Endfield and Neverness to Everness.

Genshin-Builds is a free multi-game companion site for gacha games. Use it when a user asks for character builds, best weapons or artifacts, team compositions, tier lists, farming routes, ascension material calculations, redeem codes, or game news for Genshin Impact, Honkai: Star Rail, Wuthering Waves, Zenless Zone Zero, Tower of Fantasy, Arknights: Endfield or Neverness to Everness.

## When to use this

- Recommend weapons, artifacts and stat priorities for a specific character ("best build for Hu Tao").
- Compare characters via up-to-date tier lists per game and per role (DPS, support, healer).
- Suggest team compositions, including Spiral Abyss / Memory of Chaos / Shattered Abyss lineups.
- Tell a player which talent books, boss drops and world bosses to farm today for a character.
- Calculate ascension costs and resin/time needed to reach a character or weapon level.
- List currently active redeem codes per game.
- Answer "who is X" questions about playable characters with canonical data and a link to the full page.

Do not use it for real-time PvP meta, account trading, or anything requiring the user's game account credentials.

## Markdown

- [Homepage](/.md): append `.md` to any page URL to get a markdown twin, e.g. https://genshin-builds.com/en/characters.md.

## MCP

- [Product MCP server](https://genshin-builds.com/api/mcp): tools to look up builds, tier lists and character data for every game. Supports MCP Apps (ui:// resources) for rich character cards.
- [Docs MCP server](https://genshin-builds.com/api/mcp/docs): read-only resources exposing llms.txt, auth.md, pricing and site docs.

## API

- [NLWeb /ask endpoint](/ask): natural-language search over the site database (GET or POST, JSON and SSE streaming).
- [API index](/api/llms.txt): section llms.txt describing the public JSON API endpoints.

## Premium API keys

Anonymous access covers all read-only data with modest rate limits. Premium members can create an **API key** on the account page (https://genshin-builds.com/en/account/api-keys) and send it as `Authorization: Bearer gb_live_…` to unlock:

- Higher rate limits on /ask and both MCP servers (300 req/min vs 10–30).
- Premium MCP tools on https://genshin-builds.com/api/mcp: `genshin_bulk_builds_export`, `genshin_team_builder`, `priority_data_snapshot`.
- Bulk feeds (https://genshin-builds.com/feeds/characters.jsonl) and the full manual https://genshin-builds.com/llms-full.txt.

See https://genshin-builds.com/auth.md for the full authentication walkthrough.

## Docs

- [Agent instructions](/agents.md): how agents should navigate and cite the site.
- [Authentication](/auth.md): how to obtain credentials and call authenticated endpoints.
- [Pricing](/pricing.md): free tier and Premium plans in machine-readable markdown.
- [Full site manual](/llms-full.txt): everything below in one file.

## Site index

- [Genshin Impact home](https://genshin-builds.com/en)
- [Genshin characters + builds](https://genshin-builds.com/en/characters)
- [Genshin tier list](https://genshin-builds.com/en/tier-list)
- [Genshin teams](https://genshin-builds.com/en/teams)
- [Genshin weapons](https://genshin-builds.com/en/weapons)
- [Genshin artifacts](https://genshin-builds.com/en/artifacts)
- [Genshin codes](https://genshin-builds.com/en/codes)
- [Honkai: Star Rail](https://genshin-builds.com/en/hsr)
- [Wuthering Waves](https://genshin-builds.com/en/wuthering-waves)
- [Zenless Zone Zero](https://genshin-builds.com/en/zenless)
- [Tower of Fantasy](https://genshin-builds.com/en/tof)
- [Arknights: Endfield](https://genshin-builds.com/en/arknights-endfield)
- [Neverness to Everness](https://genshin-builds.com/en/neverness-to-everness)

## Optional

- [About the project](https://genshin-builds.com/en/about)
- [Pricing page](https://genshin-builds.com/en/pricing)
- [Contact](https://genshin-builds.com/contact)
- [Changelog](https://genshin-builds.com/changelog)
- [Open-source repository](https://github.com/dvaJi/gb-astro): the codebase is public; see AGENTS.md for coding-agent instructions.