a json catalog for agents
A read-only JSON API for agents and integrations. Version 1 lives under /api/v1/, needs no API key, and allows 1,000 GET requests an hour. Errors come back as RFC 9457 application/problem+json.
pnpm dlx shadcn@latest add @mdxcn/all01get
/api/v1index
/componentscatalog
/openapi.jsonopenapi 3.1
/llms.txtchooser
02return
jsonno api keys
problem+jsonrfc 9457
03use
json catalogagents and integrators
what you can fetch
Start at /api/v1 for the list of endpoints. /api/v1/health is there for uptime checks, and /api/v1/components returns every graph with its props. The OpenAPI 3.1 spec is at /openapi.json, and an RFC 9727 API catalog is at /.well-known/api-catalog.
- /api/v1
- index
- /api/v1/health
- health
- /api/v1/components
- catalog
- /openapi.json
- openapi 3.1
- /llms.txt
- chooser + ascii
- /.well-known/api-catalog
- rfc 9727
1,000
get requests
1000 / hr
- no api keys
- RateLimit-* headers
- rfc 9457 errors
- breaking changes as /api/v2/six months notice
- index
- Start at /api/v1 for the list of endpoints. /api/v1/health is there for uptime checks.
- catalog
- Every graph, with its props and examples, is at /api/v1/components. The OpenAPI 3.1 spec is at /openapi.json.
- agents
- /llms.txt has the graph guide and every format in one file, and /agents.md explains how agents write and read the figures.
copy the source
The API describes the components; the shadcn CLI installs them. There's no npm package, so the source lands in your repo.
- cli
- /r/all.json
- skill
- /skill.md
- deprecation
- /developers/deprecation
- comark
- /docs/comark
- knap
- /docs/knap