<!-- Markdown mirror. Canonical: https://empryo.com/docs/agents/docs-mcp -->

# Docs for agents

> Copy any docs page or section as Markdown or plain text, connect an agent to the read-only documentation MCP, and use the empryo skill that ships installed.

## Copy, download, or share

Open **Copy & share** on a documentation page. Select **Full page** or a heading, then choose **Markdown** or **Plain text**. Use **Copy content**, **Download**, or **Open raw**.

**Copy a link** provides the human-readable page, the Markdown export, or the plain-text export. **Prompt for an agent** copies a short instruction with the selected source and citation URL. Nothing is sent to another service automatically.

Section exports stop at the next heading. Select each subsection separately when needed. Export links retrieve the selected content directly; a fragment on a full-page Markdown URL does not limit its HTTP response.

## Connect the documentation MCP

Add a remote MCP server in your agent's settings:

- Name: Empryo docs
- URL: https://empryo.com/mcp
- Transport: Streamable HTTP
- Authentication: none

The server reads public documentation only. It cannot inspect or edit your local config, run commands, or access credentials. Do not include secrets or private code in search queries.

| Tool | Input | Result |
| --- | --- | --- |
| search_docs | query, optional limit | Ranked sections with page and anchor selectors |
| list_docs | optional page | Pages, or sections of one page |
| read_docs | page, optional anchor and format | Full page or exact section; format is markdown or text |
| current_release | none | Published version and available artifacts |

Use the exact page and anchor from search or list results. An empty anchor selects the introduction. An omitted anchor selects the full page.

## The Empryo skill

Empryo ships this skill installed. It is listed in the skill catalog but its instructions are not in context until something loads it — by name (`$empryo` in a prompt, `--skill empryo` headless), or by the agent deciding the task calls for it.

It lives at `~/.empryo/skills/empryo/SKILL.md`. Edit or delete it and your choice stands; an upgrade refreshes only a copy you have not touched. Existing installs get it on the first session after upgrading.

For another agent, [download SKILL.md](https://empryo.com/.well-known/agent-skills/empryo/SKILL.md) and save it as **empryo/SKILL.md** in that agent's skill directory, or use its skill installer. Review it before enabling it.

## Retrieve without MCP

- [Agent manifest](https://empryo.com/agent-manifest.json)
- [Documentation index](https://empryo.com/docs/llms.txt)
- [Search API](https://empryo.com/api/docs/search?q=configuration&scope=docs)
- [OpenAPI description](https://empryo.com/openapi.json)

Every docs page has a .md and a .txt export. Its .exports.json index lists direct section downloads. For example, /docs/quickstart.md, /docs/quickstart.txt, and /docs/quickstart.exports.json.

Send Accept: text/markdown to an HTML docs URL to request its Markdown version. Explicit file URLs need no content negotiation.

## Discovery and authentication

The MCP server card at /.well-known/mcp/server-card.json describes the read-only server. This discovery format is still a draft. The agent skill index and agent manifest link the available references.

The public docs service has no protected APIs, so it does not advertise OAuth issuers, token endpoints, or agent registration. DNS-AID and WebMCP are not required to use these endpoints.
