Agent discovery surfaces
Every machine-readable endpoint OpenClip exposes for LLMs, crawlers, and autonomous agents.
OpenClip publishes purpose-built machine-readable surfaces so agents can discover the product, read pages as Markdown, and find the MCP server and Integration API without scraping HTML. If you are building an agent integration, start here; to actually connect, see MCP.
All surfaces
| URL | What it serves |
|---|---|
| https://openclip.app/llms.txt | Index of the site's key pages for LLMs, with links to their Markdown versions |
| https://openclip.app/llms-full.txt | The full site content in one Markdown file |
https://openclip.app/{page}.md | Markdown twin of a public page. Append .md to the path (for example https://openclip.app/mcp.md or https://openclip.app/pricing.md), or request the HTML URL with an Accept: text/markdown header |
| https://openclip.app/auth.md | Markdown-only reference on how agents authenticate with OpenClip |
| https://openclip.app/docs/llms.txt | Index of every documentation page, linking to each page's raw Markdown |
| https://openclip.app/docs/llms-full.txt | The full documentation corpus in one Markdown file |
| https://openclip.app/docs/skill.md | Agent Skill file for these docs: when to use them and how to read them |
| https://openclip.app/docs.md | Markdown twin of the documentation homepage |
https://openclip.app/docs/{slug}.md | Markdown twin of one documentation page, for example https://openclip.app/docs/developers/mcp.md |
| https://openclip.app/.well-known/mcp.json | MCP Server Card: endpoint, auth, and capabilities of the MCP server |
| https://openclip.app/.well-known/mcp/server-card.json | The same Server Card at its SEP-1649 path (also at /mcp/server-card) |
| https://openclip.app/.well-known/mcp/catalog.json | MCP catalog listing OpenClip's MCP servers |
| https://openclip.app/.well-known/agent-skills/index.json | Agent Skills index; the skill files live at /.well-known/agent-skills/openclip/SKILL.md and /.well-known/agent-skills/openclip/reference.md |
| https://openclip.app/.well-known/api-catalog | RFC 9727 API catalog (linkset) pointing to both the Integration API and the MCP server |
| https://openclip.app/sitemap.xml | Main XML sitemap |
| https://openclip.app/sitemap-ai.xml | Sitemap of AI-relevant pages |
| https://openclip.app/docs/sitemap.xml | Sitemap of the documentation site |
Reading pages as Markdown
Public marketing pages negotiate content. Two equivalent ways to get Markdown instead of HTML:
# Append .md to the path
curl https://openclip.app/mcp.md
# Or negotiate on the HTML URL
curl -H "Accept: text/markdown" https://openclip.app/mcpDocs pages use the same friendly alias: request /docs.md for the documentation homepage, or append .md to a page path such as /docs/developers/mcp.md. The /docs/llms.txt index lists every documentation page with its Markdown URL.
Finding the MCP server programmatically
An agent landing on openclip.app cold can bootstrap itself:
- Fetch
/.well-known/api-catalog. Its linkset anchors both the Integration API (with its OpenAPI spec) and the MCP server (described by the Server Card). - Fetch
/.well-known/mcp.jsonfor the MCP endpoint and auth details, then connect as described in Connect over MCP. - Optionally fetch the skill files from
/.well-known/agent-skills/(or the zip at https://openclip.app/mcp/skill) for the canonical usage instructions.
Installing the Agent Skills
The endpoints above serve the umbrella openclip skill, which covers the whole tool surface. The full published set lives in a public repo:
npx skills add OpenClip-App/agent-skillsThat installs from OpenClip-App/agent-skills and works with Claude Code, Codex, Cursor, and 70+ other agents. Alongside openclip it carries focused skills for clipping, captions, transcription, media conversion, video editing, thumbnails, background removal, repurposing, and UGC ads. Install only the ones you need.
Claude Code can take the skills and the MCP server together, so there is no separate connection step:
/plugin marketplace add OpenClip-App/agent-skills
/plugin install openclip@openclipUse the /.well-known/agent-skills/ endpoints when an agent is bootstrapping itself with no shell, and the CLI or plugin when a human is setting the agent up.