# tanomis docs serve

Reference for tanomis docs serve: serve the documentation to a coding agent as MCP tools over stdio.

Generated from the <code>tanomis</code> command tree on 2026-10-01. Flags and defaults match the binary; run <code>tanomis docs serve --help</code> for the version you have installed.

## Usage

```text title="Usage"
tanomis docs serve [flags]
```

## Description

Runs a Model Context Protocol server on standard input and output with three tools: search_docs, read_doc, and list_docs. The documentation is the public site as one file, fetched on first use and cached; it is revalidated when the copy is older than an hour and served from the cache when the site cannot be reached. No credential is used. Register it with `skills install`, or point your agent at this command directly.

## Flags

| Flag | Type | Description |
|---|---|---|
| `--cache-dir` | string | Directory for the cached copy (default: docs-cache beside the CLI config file). |
| `--docs-url` | string | Documentation site to serve. Default `https://docs.tanomis.com`. |
| `--refresh` | bool | Ask the site for a fresh copy on first use even if the cache is recent. |

<details>
<summary>Global flags</summary>

| Flag | Type | Description |
|---|---|---|
| `--config` | string | Config file path. |
| `--context` | string | Config context to use. |
| `-o`, `--output` | string | Output format: table\|json. |
| `--tenant` | string | Tenant id (X-Tenant-ID). |
| `--verbose` | bool | Verbose output. |

</details>