{"openapi":"3.1.0","info":{"title":"poetry docs machine surface","summary":"Read-only discovery endpoints: llms indexes, markdown mirrors, the component registry, and installable agent skills. Every HTML docs page additionally mirrors as markdown via a .md suffix or Accept: text/markdown.","version":"1.0.0"},"paths":{"/llms.txt":{"get":{"summary":"Site index for agents: every docs page with a one-line description","responses":{"200":{"description":"OK","content":{"text/markdown":{}}}}}},"/poetry/llms.txt":{"get":{"summary":"Component catalog for agents","responses":{"200":{"description":"OK","content":{"text/markdown":{}}}}}},"/poetry/llms-full.txt":{"get":{"summary":"Full component contracts + Stimulus wiring + agent tools","responses":{"200":{"description":"OK","content":{"text/markdown":{}}}}}},"/mcp":{"post":{"summary":"The poetry MCP server over HTTP: POST JSON-RPC 2.0 (initialize, tools/list, tools/call) - the same read-only tools as `bundle exec poetry-agent`, for in-page bridges","responses":{"200":{"description":"OK","content":{"application/json":{}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/r/registry.json":{"get":{"summary":"Registry index (shadcn registry schema)","responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/r/registries.json":{"get":{"summary":"Directory of registries","responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/r/{name}":{"get":{"summary":"One registry item as <name>.json (shadcn registry-item schema: https://ui.shadcn.com/schema/registry-item.json)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/.well-known/skills/index.json":{"get":{"summary":"Installable agent skills: names, descriptions, file rosters","responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/.well-known/skills/{skill}/{file}":{"get":{"summary":"One skill file as markdown","parameters":[{"name":"skill","in":"path","required":true,"schema":{"type":"string"}},{"name":"file","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/markdown":{}}}}}},"/.well-known/agent-skills/index.json":{"get":{"summary":"Agent-skills discovery index (schemas.agentskills.io/discovery/0.2.0): name, description, type, payload url, sha256 digest per skill - what `npx skills add` reads","responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/agent-skills/{archive}":{"get":{"summary":"One skill payload as a flat <name>.tar.gz, the digest target (human catalog page at /agent-skills)","parameters":[{"name":"archive","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/gzip":{}}}}}},"/.well-known/api-catalog":{"get":{"summary":"RFC 9727 API catalog (this document's address)","responses":{"200":{"description":"OK","content":{"application/linkset+json":{}}}}}},"/openapi.json":{"get":{"summary":"This OpenAPI description","responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/operator-register.json":{"get":{"summary":"The operator register: poetry's component contract in GUI-operator vocabulary (system + per-page instructions)","responses":{"200":{"description":"OK","content":{"application/json":{}}}}}},"/sitemap.xml":{"get":{"summary":"Sitemap of every docs page (DocsCatalog-generated)","responses":{"200":{"description":"OK","content":{"application/xml":{}}}}}},"/robots.txt":{"get":{"summary":"Crawler welcome + Content-Signal + sitemap pointer","responses":{"200":{"description":"OK","content":{"text/plain":{}}}}}},"/up":{"get":{"summary":"Health check","responses":{"200":{"description":"OK","content":{"text/html":{}}}}}}}}