Developer API

Markdown Graphs exposes a read-only JSON API for agents and integrators. Version 1 is prefixed at /api/v1/. No API keys. Responses include RateLimit-* headers (1000 GET requests per hour). Errors are RFC 9457 application/problem+json with code, detail, and recovery links.

Start at /api/v1 for the endpoint index, /api/v1/health for a health check, and /api/v1/components for the full graph catalog. OpenAPI 3.1 is at /openapi.json. RFC 9727 API catalog is at /.well-known/api-catalog.

Install graph source files with the shadcn CLI: pnpm dlx shadcn@latest add https://mdx-graphs.kshv.me/r/all.json. That is the official CLI path — there is no separate npm package of React components.

Agent resources: /agents and /agents.md for the write/read story, /skill.md for the skill file, /llms.txt for the chooser and ASCII twins. Deprecation policy: /developers/deprecation.

• OpenAPI · API index · Health
• JSON catalog · llms.txt · agents.md
• Deprecation policy · For agents

Install graphs with the shadcn CLI: pnpm dlx shadcn@latest add https://mdx-graphs.kshv.me/r/all.json