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

# Preview before you connect

> Try everything Dedica will serve to AI agents on your domain, hosted on Dedica's API, before your middleware is connected.

Dedica hosts a public preview of everything it will serve to AI agents on your domain. You can open it, share it, or give it to an agent before your middleware is connected and before you turn on serving.

The preview has its own address, which stands in for `https://<your domain>`:

```text theme={null}
https://api.getdedica.com/api/v1/preview/<site id>
```

The same path answers the same thing. For example, `<preview>/llms.txt` is what `https://<your domain>/llms.txt` will be, and `<preview>/pricing.md` is what `https://<your domain>/pricing.md` will be.

## Find your preview

Until your site is live, the **Overview** in Dedica shows a **Try it before you connect** card with your preview link. Copy it, open it, or copy a ready-made prompt that points an assistant at it.

Through the API, `GET /api/v1/onboarding/middleware/` returns `preview_url`, the preview's index page.

## The index page

Open `<preview>/` in a browser for a page that lists everything Dedica serves for your site, with a summary of each and its address on the preview and on your domain:

* **Files**: `llms.txt`, `llms.md`, `llms-full.txt`, one `llms.txt` per section, and the [discovery files](https://docs.getdedica.com/serving/discovery-files.md).
* **Agent pages**: each [agent page](https://docs.getdedica.com/serving/agent-pages.md), and for index pages every page it covers, each with its own `.md`.
* **APIs**: [`/ask` and the MCP server](https://docs.getdedica.com/serving/mcp-and-ask), with the MCP server's tools.

Agents and scripts get the same index as JSON:

```bash theme={null}
curl https://api.getdedica.com/api/v1/preview/<site id>/
```

## What it serves

| On the preview | Same as on your domain |
| - | - |
| `GET <preview>/<path>` | Agent pages, page `.md` files, `llms.txt` files and discovery files. A normal page URL, such as `<preview>/pricing`, returns its agent version. |
| `GET <preview>/ask?q=` | `/ask`: a short answer from your agent pages, with sources. |
| `POST <preview>/mcp` | The MCP server, with your approved tools. No sign-in. |

Connect an agent to the preview's MCP server the same way as to your domain's. For example, with Claude Code:

```bash theme={null}
claude mcp add --transport http example-com https://api.getdedica.com/api/v1/preview/<site id>/mcp
```

Links inside the files that point at something Dedica serves on your domain point at the preview instead, so an agent given the preview's `llms.txt` can follow them. Links to your normal pages still go to your site.

## What to know

* Only approved content is shown, exactly as it would be served on your domain. Drafts waiting in Review never are.
* The preview works in any [serving mode](https://docs.getdedica.com/guides/serving-modes.md). Turning on serving doesn't change it.
* `/ask` needs at least one approved agent page, and `/mcp` needs at least one approved tool. Until then they answer `404`.
* Tool calls from the preview's MCP server are the same anonymous calls to your own public API as on your domain.
* Search engines are asked not to index the preview, so it doesn't compete with your own site.
* Each visitor can make 120 requests a minute to the preview, and 10 a minute to `/ask`.
* The preview's `/ask` takes `GET` only. NLWeb `POST /ask` is only on your domain.

> [!NOTE]
>
> The preview's address uses your site id, not your domain. Anyone with the address can open it, so share it the way you would share a draft.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.