> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valarhq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use the docs MCP server

> Connect an AI agent to Valar documentation and public pricing tables

The Valar docs MCP server lets an AI agent search the published documentation and read complete pages, including a compact public pricing table.

```text theme={"system"}
https://docs.valarhq.ai/mcp
```

The docs MCP is public. You do not need a Valar API key to read documentation or pricing through it.

## Connect your client

### Claude Code

Run this command once:

```bash theme={"system"}
claude mcp add --transport http valar-docs https://docs.valarhq.ai/mcp
```

Restart Claude Code if the server does not appear in the current session.

### Cursor

Add the server to `.cursor/mcp.json` in your project, or to your global Cursor MCP settings:

```json theme={"system"}
{
  "mcpServers": {
    "valar-docs": {
      "url": "https://docs.valarhq.ai/mcp"
    }
  }
}
```

Reload Cursor after saving the file.

### Other MCP clients

Add a remote MCP server with these settings:

| Setting | Value |
| - | - |
| Name | `valar-docs` |
| Transport | HTTP |
| URL | `https://docs.valarhq.ai/mcp` |

Use the HTTP transport supported by your client. You do not need to run a local MCP process.

## What the server provides

Your agent can discover the server's tools, search for a page, and use the documentation filesystem tool to read its full content. Search snippets help find a page; read the complete page before comparing all prices.

The docs MCP reads published content. It does not run inference or call the authenticated model-listing API.

## Read pricing through MCP

[Pricing for agents](/pricing-for-agents) is a compact Markdown table generated from the same public catalog as the visual [Pricing](/pricing) page. It lists model IDs and input, cached input, and output rates for Now, Priority, Standard, and Flex in USD per 1M tokens.

Ask your agent:

```text theme={"system"}
Use the Valar docs MCP server to find Pricing for agents.
Read the full page, then show the input, cached input, and output price
for each listed window on moonshotai/Kimi-K3-fast. Include the units.
```

If you already know the page path, ask the agent to use the documentation filesystem tool to read `/pricing-for-agents.mdx`. Tool names are supplied by the server when the client connects.

These are public list prices, not live quotes. They update when the docs are published and exclude hidden and restricted models. For your organization's available models and negotiated rates, use the separate authenticated [`GET /v1/models` API](/api-reference/models-api/list-supported-models).

## Example prompts

```text theme={"system"}
Search the Valar docs for the difference between Now, Priority, Standard, and Flex.
```

```text theme={"system"}
Find the Valar model-listing API and explain its pricing fields.
```

```text theme={"system"}
Read the full Pricing for agents page from the Valar docs MCP server.
Convert the Standard rates for all listed models to JSON with model ID,
input, cached input, and output fields. Preserve the decimal precision
and label the prices as USD per 1M tokens.
```

```text theme={"system"}
Using only the Valar docs MCP server, show me how to migrate this project to Valar.
```

## Troubleshooting

### The server does not connect

Confirm that the URL ends in `/mcp` and that your client is configured for HTTP. Then reload the client or reconnect the server.

### The pricing page does not appear in search

Ask the documentation filesystem tool to read `/pricing-for-agents.mdx` directly. If the page was just published, allow time for indexing. You can also [read the Markdown export](https://docs.valarhq.ai/pricing-for-agents.md) without MCP.

### The client asks for an API key

Public documentation and pricing do not require a key. Check that you connected to `https://docs.valarhq.ai/mcp`, not an inference API endpoint. Do not paste a Valar API key into your prompt.

### The answer is incomplete or has different prices

Ask the agent to read the full [Pricing for agents](/pricing-for-agents) page again instead of using search snippets or remembered prices. The compact and visual tables share the same source. Rates returned by the authenticated API may differ because of negotiated pricing or changes not yet published in the docs.

## Machine-readable alternatives

If your client does not support MCP, [open the pricing Markdown export](https://docs.valarhq.ai/pricing-for-agents.md) directly. You can also use [`/llms.txt`](https://docs.valarhq.ai/llms.txt) for the documentation index or append `.md` to a documentation page URL.

The export is Markdown. An agent can convert it to JSON or CSV on request, but that conversion is not a separate Valar API response.