Skip to content
mdxcn is now part of Shadcn Labs. details

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/all
[ api ]

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.

[ fetch ]
/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
[ rate ]

1,000

get requests

1000 / hr

1,000 get requests. 1000 / hr
[ contract ]
  • no api keys
  • RateLimit-* headers
  • rfc 9457 errors
  • breaking changes as /api/v2/six months notice
3 of 4 done
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.

[ paths ]
cli
/r/all.json
skill
/skill.md
deprecation
/developers/deprecation
comark
/docs/comark
knap
/docs/knap