> For the complete documentation index, see [llms.txt](https://docs.ur.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ur.app/developer-resources/chat-and-build-with-ai.md).

# Build with AI coding agents

Use AI in your UR integration workflow. We provide tools that give AI agents direct access to our documentation, so you can ask questions, generate code, and build integrations without copy-pasting docs into prompts.

## Install the UR Docs MCP server

Our [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server gives any AI coding assistant direct access to UR documentation. Three tools are available to any connected client:

| Tool          | What it does                         |
| ------------- | ------------------------------------ |
| `search_docs` | Search docs by keyword               |
| `get_page`    | Get full page content in markdown    |
| `list_pages`  | Browse all pages and their hierarchy |

### Claude Code

Run in your terminal:

```bash
claude mcp add ur-docs --transport http https://ur-docs-mcp-production.up.railway.app/mcp
```

### Claude Desktop

Add to your config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):

```json
{
  "mcpServers": {
    "ur-docs": {
      "url": "https://ur-docs-mcp-production.up.railway.app/mcp"
    }
  }
}
```

### Cursor

Open **Settings > MCP Servers > Add new server**:

* Name: `ur-docs`
* Type: `HTTP`
* URL: `https://ur-docs-mcp-production.up.railway.app/mcp`

### VS Code (Copilot)

Add to `.vscode/mcp.json` in your project:

```json
{
  "servers": {
    "ur-docs": {
      "url": "https://ur-docs-mcp-production.up.railway.app/mcp"
    }
  }
}
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "ur-docs": {
      "serverUrl": "https://ur-docs-mcp-production.up.railway.app/mcp"
    }
  }
}
```

## Plain text docs

You can access our documentation as plain text at [docs.ur.app/llms-full.txt](https://docs.ur.app/llms-full.txt). This helps AI tools consume our content directly and allows you to paste full documentation context into an LLM.

Plain text is preferable to scraping HTML because:

* Fewer formatting tokens
* LLMs parse and understand markdown hierarchy
* Content hidden in tabs or collapsed sections is included

## Try it

After setting up the MCP server, restart your AI client and try:

* "What is UR and how does the account layer work?"
* "How do I integrate with UR in Managed Custody Mode?"
* "What's the user lifecycle from KYC to card spending?"
* "Search UR docs for tokenized deposits"

Your assistant will search and read our docs to give you an accurate, up-to-date answer.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.ur.app/developer-resources/chat-and-build-with-ai.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.