<!-- Markdown twin of https://pixelvault.dev/docs/agent-discovery/ -->

# Agent discovery

PixelVault provides standard discovery endpoints so any AI agent can find the API, its spec, and its tools without a human pasting docs:

Endpoint

What it is

[`/.well-known/api-catalog`](/.well-known/api-catalog)

RFC 9727 API catalog for agent discovery

[`/llms.txt`](/llms.txt)

LLM-readable service description (lists the MCP server)

[`/openapi.json`](https://api.pixelvault.dev/openapi.json)

OpenAPI 3.1 specification; `pixelvault.dev/openapi.json` redirects to the canonical copy on the API

[`/openapi-actions.json`](/openapi-actions.json)

Trimmed spec for [ChatGPT Custom GPT Actions](/docs/chatgpt/)

[MCP server](/docs/mcp/)

`https://mcp.pixelvault.dev/mcp` (API key) or `/mcp/oauth` (OAuth)

[`/.well-known/agent-skills/index.json`](/.well-known/agent-skills/index.json)

Agent skills catalog; `/.well-known/skills/index.json` serves the same skills in Hermes Agent format, for `hermes skills install well-known:…`

## Markdown twins

Every docs page has a Markdown twin: append `.md` to the path (for example [`/docs/idempotency.md`](/docs/idempotency.md)) or request the page with `Accept: text/markdown`. [`/docs.md`](/docs.md) is a complete single-file API reference for agents that want everything in one fetch.

## Next steps

-   [MCP server](/docs/mcp/) setup.
-   [Claude Code skill](/docs/claude-code/).
-   [API reference](/docs/api/) generated from the same OpenAPI spec.
