# makesPDF Documentation

> Documentation index for makesPDF. Each page below is an HTML page with
> full details. This index helps you pick the right starting point.
>
> **URLs in this document are HTTP URLs, not filesystem paths.** Fetch them
> with a web/HTTP tool, not a filesystem `Read` tool.

## Pages

- **Getting Started** — https://makespdf.com/docs/getting-started
  Account setup, API key creation, first PDF, and the three rendering
  paths (Markdown, DSL, AI-generated).

- **API Reference** — https://makespdf.com/docs/api
  Complete endpoint documentation for /api/v1/*. Request/response schemas,
  authentication, error codes, rate limits, and curl examples.

- **AI Agent Setup** — https://makespdf.com/docs/ai-setup
  Step-by-step guide for integrating makesPDF into an AI agent or MCP
  server. Covers the skill file, device authorization flow, and the
  preview API.

- **Server-side integration** (markdown) — https://makespdf.com/docs/integration
  How to wire makesPDF into an application codebase: API-key setup,
  storing templateIds, error handling, retry policy, and copy-pasteable
  snippets in Node, Python, Go, Ruby, and PHP. Served as raw markdown
  so agents driving an integration task can ingest it directly.

## Machine-readable resources

These return plain text / markdown and are designed for AI consumption:

- Site manifest (llmstxt.org): https://makespdf.com/llms.txt
- Full manifest (with inlined skill file): https://makespdf.com/llms-full.txt
- Skill file (DSL reference for template authoring): https://makespdf.com/skills/pdf-template-author.md

## Quick decision guide

- **"I need to generate a PDF right now"** → Read the skill file at
  https://makespdf.com/skills/pdf-template-author.md, then call `POST /api/v1/preview`
- **"I need an API key / auth token"** → https://makespdf.com/docs/ai-setup (device flow)
- **"I want the full endpoint list"** → https://makespdf.com/docs/api
- **"I'm new, where do I start?"** → https://makespdf.com/docs/getting-started