# Build with AI

These docs are written to be read by coding agents as well as people. Point your agent at them, and it can look up endpoints, fields and examples while it builds your integration.

## Start with one prompt

Paste this into Claude Code, Codex, Cursor or any other coding agent:

```
Read https://docs.ygo.ai/llms.txt and use the YGO API docs it lists
(add .md to any page URL for its Markdown) to help me with this task:
<describe what you want to build>
```

## What agents can read

| | |
|---|---|
| [`/llms.txt`](https://docs.ygo.ai/llms.txt) | An index of every guide and endpoint, with a one-line description of each |
| `.md` after any page URL | That page as Markdown, for example [/guides/authentication.md](https://docs.ygo.ai/guides/authentication.md) |
| `/reference/<endpoint>.json` | One endpoint's OpenAPI spec, for example [/reference/getEnrichedHotel.json](https://docs.ygo.ai/reference/getEnrichedHotel.json) |
| [`/openapi.json`](https://docs.ygo.ai/openapi.json) | The whole API in one OpenAPI file, for example to generate a client |

Every guide and endpoint page also has **Copy page** (its Markdown) and **Open in Claude** at the top.

## Add the docs to your project

So your agent finds the docs every time, add this line to its instructions file:

```
YGO API docs: https://docs.ygo.ai/llms.txt (add .md to any page URL for its Markdown)
```

| Agent | Instructions file |
|---|---|
| [Claude Code](https://code.claude.com/docs/en/memory) | `CLAUDE.md` |
| [Codex](https://developers.openai.com/codex/guides/agents-md) | `AGENTS.md` |
| [Cursor](https://cursor.com/docs/rules) | `AGENTS.md`, or a rule in `.cursor/rules/` |
| [GitHub Copilot](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions) | `.github/copilot-instructions.md` |

## Not the same as our MCP server

The [MCP server](https://docs.ygo.ai/guides/mcp.md) lets an AI assistant read your YGO projects and hotels and send hotel feedback. This page is about reading the docs while you build.
