Skip to content

Docs for agents

Give any AI agent Empryo's docs: copy a page as Markdown or plain text, connect the read-only docs MCP server, or use the empryo skill that ships with the app.

Get started3 minutes to read
Copy & share
On this page5 sections

These docs are built to be read by AI agents as well as people. You can paste a page into a chat, connect an agent to a documentation server, or let Empryo's own agent look things up.

Copy, download or share a pageLink to this section

Open Copy & share on any documentation page. Choose Full page or a single heading, then Markdown or Plain text. Then pick Copy content, Download or Open raw.

Copy a link gives you the normal page, the Markdown version or the plain-text version. Prompt for an agent copies a short instruction that includes the selected text and a link to cite. Nothing is sent anywhere automatically.

A section export ends at the next heading, so select subsections separately if you need them. Note that adding #anchor to a full-page Markdown URL does not shorten what the server returns. Use the section export instead.

Connect the documentation MCP serverLink to this section

MCP (Model Context Protocol) lets an agent call tools on a remote server. Add this server in your agent's settings:

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

The server only reads the public documentation. It can't see or change your local config, run commands or access credentials. Don't put secrets or private code in search queries.

ToolInputReturns
search_docsquery, optional limitMatching sections, ranked, with their page and anchor
list_docsoptional pageAll pages, or the sections of one page
read_docspage, optional anchor and formatA full page or one section, as markdown or text
current_releasenoneThe latest published version and its downloads

Pass the exact page and anchor from search or list results. An empty anchor returns the page introduction. Leaving the anchor out returns the full page.

The Empryo skillLink to this section

A skill is a set of instructions an agent can load when it needs them. Empryo installs an empryo skill that teaches its agent how to use these docs, so it can look up settings instead of guessing.

The skill is listed in the skill catalog, but its instructions are only loaded when needed: when you mention $empryo in a prompt, pass --skill empryo in headless mode, or the agent decides the task needs it.

It lives at ~/.empryo/skills/empryo/SKILL.md. If you edit or delete it, your change is kept. Updates only refresh a copy you haven't touched.

To use it with a different agent, download SKILL.md and save it as empryo/SKILL.md in that agent's skills folder, or use its skill installer. Read it before you enable it.

Fetch the docs without MCPLink to this section

Every docs page has a .md and a .txt version, plus an .exports.json file listing direct links to each section. For example: /docs/quickstart.md, /docs/quickstart.txt and /docs/quickstart.exports.json.

You can also request an ordinary docs URL with the header Accept: text/markdown to get Markdown back. The .md and .txt URLs work without it.

Discovery and authenticationLink to this section

An MCP server card at /.well-known/mcp/server-card.json describes the server. That discovery format is still a draft. The agent skill index and the agent manifest link to the same resources.

The docs service has no protected endpoints, so there is no OAuth, token endpoint or agent registration to set up. You don't need DNS-AID or WebMCP to use any of this.