# Tandem Docs

Tandem Docs is a remote MCP server for helping agents learn how to install, operate, and build with Tandem.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add tandem/docs-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list tandem/docs-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get tandem/docs-mcp search_docs

# Call a tool
npx -y @smithery/cli@latest tool call tandem/docs-mcp search_docs '{}'
```

## Direct MCP Connection

Endpoint: `https://docs-mcp--tandem.run.tools`

## Tools (13)

- `search_docs` — Search the published Tandem docs index for relevant pages.
- `get_doc` — Fetch and normalize a published Tandem docs page by path or URL.
- `get_start_path` — Recommend the best Tandem docs starting path for a desktop user, server admin, or developer.
- `recommend_next_docs` — Recommend the next Tandem docs to read after a current page, optionally biased toward a goal.
- `answer_how_to` — Answer how to install or use Tandem, build workflows, or use the SDKs by synthesizing relevant published docs.
- `get_tandem_guide` — Return a structured Tandem learning guide for install-engine, python-sdk, typescript-sdk, build-workflows, or headless-…
- `warmup_docs_cache` — Refresh the docs index and preload the most important Tandem docs pages into cache.
- `get_docs_cache_status` — Inspect the current docs cache state for index sources and warmed pages.
- `refresh_docs_index` — Force-refresh docs indexes and report whether data came from the network, cache, or stale fallback.
- `refresh_doc_page` — Force-refresh a docs page and report whether content came from the network, cache, or stale fallback.
- `invalidate_docs_cache` — Invalidate docs cache entries for index data, all pages, or a specific page path.
- `compare_docs_index_refresh` — Force-refresh the docs indexes and return before/after hashes so content changes can be proven.
- `compare_doc_page_refresh` — Force-refresh a docs page and return before/after hashes so page content changes can be proven.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get tandem/docs-mcp <tool-name>
```

## Prompts (3)

- `install_tandem_engine` — Prompt template for teaching an agent how to install Tandem Engine safely from the docs.
- `use_python_sdk` — Prompt template for helping an agent learn the Tandem Python SDK and prerequisites.
- `build_workflows` — Prompt template for helping an agent learn workflow building and orchestration patterns in Tandem.