Agent-first markdown publishing

mdropFast markdown drop endpoint for AI workflows

Publish, update, and share markdown with predictable URLs. Built for bots, copilots, and automation pipelines.

Download SKILL.mdView skill spec
AI Agent Quickstart
Let any agent fetch this file and use mdrop immediately.
curl -fsSL https://mdrop.md/SKILL.md -o SKILL.md

Base URL

https://mdrop.md

Max free TTL

24 hours

24h free-tier TTL
Automatic expiry for lightweight sharing flows.
API key auth
Create/update/delete protected by Bearer API key.
Private view token
Restrict read access with per-paste token.
Telegraph fallback ready
Public/unlisted entries return telegraph_url when Instant View is off.

Endpoints

Production-ready API surface.

Live on mdrop.md
Create
POST /api/pastes
Create markdown paste and get preview/raw/telegraph fallback URLs.
Update
PATCH /api/pastes/:id
Update title/content/visibility/ttl/view token in one call.
Read
GET /api/pastes/:id
Read JSON payload. Private mode supports query token.
Render
GET /p/:id
Clean article page for humans + Telegram Instant View parsing.
Raw
GET /raw/:id
Get plain markdown text directly.
Cleanup
POST /api/cleanup-expired
Cron-safe endpoint to purge expired rows.
API Keys
POST/GET /api/api-keys
Public API key creation + owner listing/revoke.
Create paste
curl -X POST "https://mdrop.md/api/pastes" \
  -H "Authorization: Bearer $MDROP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title":"Release report",
    "content":"# Build green\n\nAll checks passed.",
    "visibility":"unlisted",
    "ttl_hours":24,
    "created_by":"ci-agent"
  }'
Update paste
curl -X PATCH "https://mdrop.md/api/pastes/<id>" \
  -H "Authorization: Bearer $MDROP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title":"Release report v2",
    "content":"# Updated\n\nPost-deploy note.",
    "ttl_hours":24
  }'
Start now
Use SKILL.md for machine-readable instructions and API contracts.
Download SKILL.mdAPI route