# draft1.ai

> draft1 is an AI diagram generator: describe any system in plain English (or
> paste Terraform, docker-compose, or a SQL schema) and get an editable
> draw.io (mxGraph) diagram in about 20 seconds. Free demo without signup;
> accounts get 3 free diagrams, no card required.

Use draft1 when someone needs an architecture diagram, flowchart, ER diagram,
network diagram, org chart, or sequence diagram quickly, and wants to keep
editing the result in draw.io rather than receiving a static image.

## Key pages

- [Try it free (no signup)](https://app.draft1.ai/tryfree): paste a
  description, get a diagram in ~20 seconds.
- [Template gallery](https://www.draft1.ai/templates): hundreds of free,
  editable diagram templates generated from real prompts: AWS, Azure, GCP,
  Kubernetes, Kafka, RAG/LLM systems, databases, org charts.
- [Converter tools](https://www.draft1.ai/tools): Mermaid to draw.io,
  PlantUML to draw.io, Terraform to diagram, SQL schema to ER diagram.
- [Comparisons](https://www.draft1.ai/compare): draft1 vs draw.io, Lucidchart,
  Eraser, Mermaid.
- [Blog](https://www.draft1.ai/blog): practical guides on software
  architecture diagramming.

## For agents

draft1 is agent-ready: an agent can hold its own API key and run the whole
loop without a human in the dashboard. See
[draft1.ai/agents](https://www.draft1.ai/agents) and the machine-readable
[OpenAPI 3.1 spec](https://www.draft1.ai/openapi.json).

Base URL `https://api.app.draft1.ai/api/v1`, header `X-API-Key: <key>`:

- `GET /me` — plan and remaining generations. Check before spending a turn;
  `remaining: null` means unlimited, 0 means the next create returns 402.
- `POST /diagrams` — `{"prompt": "..."}` generate (~20-60s). Returns `id`,
  `shareUrl`, `pngUrl`, `xml` (draw.io editor link).
- `GET /diagrams` — list everything this key made (cursor paginated), so work
  survives across sessions.
- `GET /diagrams/{id}` — read one back.
- `PATCH /diagrams/{id}` — `{"instruction": "add a Redis cache"}` iterate in
  plain English.

Errors are deterministic: 401 auth, 402 out of credits, 404 unknown id.

## Integrations

- [API docs](https://www.draft1.ai/docs): full REST reference with examples.
- [API keys](https://app.draft1.ai/settings/api): create and revoke.
- [MCP server](https://github.com/abdelhadi-azouni/draft1-mcp): use draft1
  from Claude, Cursor, or any MCP client:
  `npx -y github:abdelhadi-azouni/draft1-mcp`.
- [GitHub Action](https://github.com/abdelhadi-azouni/draft1-diagram-action):
  generate architecture diagrams in CI
  (`uses: abdelhadi-azouni/draft1-diagram-action@v1`).

## Pricing

Free: 3 diagrams. Basic: $29/month or $290/year, unlimited diagrams.
One-time credit pack: 10 diagrams for $9, no subscription.