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

# Try the demo

> Read real DevTune data over MCP or the REST API without an account, using the public demo token on DevTune’s category projects.

Use the demo token to see what DevTune returns before you create an account. It reads DevTune's public vertical projects: one project per product category, such as observability or databases, with the same data as the [public category reports](https://devtune.ai/verticals).

## Connect

Send the token as a bearer token. No sign-up, key or person is needed.

```text theme={null}
Authorization: Bearer dtk_demo_public
```

Over MCP, point your client at `https://devtune.ai/api/mcp` with that header:

```json theme={null}
{
  "mcpServers": {
    "devtune-demo": {
      "type": "streamable-http",
      "url": "https://devtune.ai/api/mcp?project=vertical-observability-monitoring",
      "headers": { "Authorization": "Bearer dtk_demo_public" }
    }
  }
}
```

Over REST:

```bash theme={null}
curl https://devtune.ai/api/v2/connection \
  -H "Authorization: Bearer dtk_demo_public"
```

## Choose a category

`GET /api/v2/connection` and the `devtune_get_connection_context` tool list the categories in `demo.verticals`, each with `projectId`, `slug`, `name` and `category`.

* **MCP:** add `?project=<slug or projectId>` to the server URL.
* **REST:** put the `projectId` or `slug` in the path, as in `GET /api/v2/projects/{projectId}/visibility/summary`.

Without a choice, the first category in the list is used.

## What you can read

The demo is read-only and category-level:

* Visibility: summary, diff, sentiment, AI responses and their history, prompts, topics, timeline and probe health
* Competitive position
* Citations: analysis, stats, top pages and domains, and lookalike sites
* The forecast, and content gaps with their evidence

`tools/list` returns exactly the tools the token can call. Claude and Grok results follow DevTune's own plan, so a `platform` filter of `claude` or `xai-search` can be refused with `400`. Leave `platform` off to read every platform the categories track.

## What needs an account

A category project tracks a market, not your site, so the demo has no Actions, Results, AI Traffic, Audit or page data. It can't write, spend credits or use code mode. To run the loop on your own product, [create an API key](https://docs.devtune.ai/api-reference/authentication.md) or let your agent [register](https://docs.devtune.ai/api-reference/agent-registration.md).

## Limits and errors

| Response | When |
| - | - |
| `403` | A write, a tool or route outside the demo, code mode, or a project that isn't a demo category |
| `400` | An MCP request with more than one JSON-RPC message; send one per request |
| `429` | Over 30 requests a minute from your IP address, or the demo's overall limit. Wait for `Retry-After` seconds and retry |
| `503` | The demo is temporarily unavailable. Wait for `Retry-After` seconds and retry |


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