Getting Started
MDER.PRO is the document delivery layer for AI agents. Turn AI-generated content into secure, readable, shareable web documents with a single API call.
This guide will have you publishing your first document in under 2 minutes.
1. Create an account
Sign up at mder.pro/auth/register with your email and a password (min 8 characters). The free tier gives you 25 documents per month, 10 active documents, and 1,000 views.
2. Get an API key
Go to Dashboard → API Keys and click Create API Key. Give it a name and copy the key — it starts with mder_ and is only shown once.
⚠️ Save your API key
3. Publish your first document
The simplest way — send a content string and we'll wrap it in a markdown block for you:
curl -X POST https://api.mder.pro/v1/documents \
-H "Authorization: Bearer mder_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "My First Document",
"content": "# Hello World\n\nPublished from the API!"
}'The response includes a viewer_url — open it in a browser and you'll see your rendered document.
{
"document_id": "doc_8f2d4a...",
"viewer_url": "https://mder.pro/d/ab12cd",
"status": "published",
"expires_at": null,
"resource_uri": "mder://documents/doc_8f2d4a..."
}4. Create rich documents with blocks
For more control, use the blocks array with 11 supported block types: markdown, code, image, table, heading, callout, divider, quote, list, embed, and html.
{
"title": "Weekly Report",
"blocks": [
{
"id": "h1",
"type": "heading",
"content": "Weekly Report",
"props": { "level": 1 }
},
{
"id": "status",
"type": "callout",
"content": "All KPIs are on track.",
"props": { "type": "success", "title": "Status: Green" }
},
{
"id": "metrics",
"type": "table",
"content": "Metric | This Week | Last Week\nRevenue | $52k | $48k\nUsers | 1,240 | 1,180",
"props": { "striped": true }
},
{
"id": "code",
"type": "code",
"content": "const report = await mder.createDocument(data);\nconsole.log(report.viewer_url);",
"props": { "language": "javascript" }
}
],
"access_policy": {
"mode": "unlisted",
"ttl_hours": 168
}
}See the full Block Types Reference for all options and props.
5. Connect via MCP (optional)
If you're building with an MCP-compatible AI agent (Claude, VS Code Copilot, etc.), you can connect MDER as an MCP server for direct tool access.
{
"servers": {
"mder": {
"command": "npx",
"args": ["-y", "@mder/mcp"],
"env": {
"MDER_API_KEY": "mder_YOUR_API_KEY",
"MDER_API_URL": "https://api.mder.pro"
}
}
}
}This gives your agent tools like create_document, list_documents, and revoke_document — see the MCP Reference.