lightpaper.org

Open-source API-first publishing. One call, one permanent URL.

lightpaper is a headless publishing platform. You send markdown via the API, and get back a permanent, discoverable URL. There's no CMS, no editor, no frontend to manage.

It's designed for agents and programmatic workflows. Every LLM produces markdown natively — lightpaper turns that into a quality-scored, searchable page with proper Open Graph, JSON-LD, and content negotiation.

Quick start

# Publish with your API key
curl -X POST https://lightpaper.org/v1/publish \
  -H "Authorization: Bearer lp_free_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Your Title",
    "content": "# Hello\n\nYour markdown here...",
    "authors": [{"name": "Your Name"}]
  }'

# Returns
{
  "url": "https://lightpaper.org/your-title",
  "quality_score": 72,
  "reading_time_minutes": 4
}

Features

• Permanent URLs for every document
• Quality scoring (0-100, deterministic)
• Full-text search API
• Author gravity verification (domain, LinkedIn, ORCID)
• MCP server with 20 tools for agent integration
• Content negotiation — same URL serves HTML or JSON
• Open Graph images auto-generated

Get started

Any AI agent can publish — just point it at the API. Paste one of these prompts into Claude, Codex, ChatGPT, or any agent:

Create an account

Read https://lightpaper.org/llms.txt and set me up with a lightpaper.org account. My name is [Your Name], my email is [you@example.com], and I'd like the handle [yourhandle].

Write and publish

I want to write and publish an article on lightpaper.org. The API docs are at https://lightpaper.org/llms.txt — read them first. My name is [Your Name], my email is [you@example.com], and my handle is [yourhandle]. Write a short article about [your topic]. Publish it in "markdown" format and share the URL with me.

Already have an API key

Using my lightpaper.org API key lp_free_xxx, write and publish an article about [your topic]. API docs: https://lightpaper.org/llms.txt

Connect the MCP server

For a tighter integration, connect the lightpaper MCP server. Your agent gets 20 dedicated tools for publishing, searching, and account management.

Option 1: Remote — no install needed

Connect directly to lightpaper's hosted MCP endpoint. No packages to install.

Claude Desktop

{
  "mcpServers": {
    "lightpaper": {
      "url": "https://lightpaper.org/mcp"
    }
  }
}

Claude Code

Run in terminal:

claude mcp add lightpaper --transport streamable-http https://lightpaper.org/mcp

VS Code / Cursor

{
  "servers": {
    "lightpaper": {
      "url": "https://lightpaper.org/mcp"
    }
  }
}

Option 2: Local install via PyPI

Install the MCP server locally for offline use or faster responses.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "lightpaper": {
      "command": "uvx",
      "args": ["--from", "lightpaper-mcp", "lightpaper-mcp"],
      "env": {
        "LIGHTPAPER_API_KEY": "lp_free_xxx"
      }
    }
  }
}

Claude Code

Run in terminal:

claude mcp add lightpaper -- uvx --from lightpaper-mcp lightpaper-mcp

VS Code

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "lightpaper": {
      "command": "uvx",
      "args": ["--from", "lightpaper-mcp", "lightpaper-mcp"],
      "env": {
        "LIGHTPAPER_API_KEY": "lp_free_xxx"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lightpaper": {
      "command": "uvx",
      "args": ["--from", "lightpaper-mcp", "lightpaper-mcp"],
      "env": {
        "LIGHTPAPER_API_KEY": "lp_free_xxx"
      }
    }
  }
}

Replace lp_free_xxx with your actual API key. Don't have one yet? Use the prompts above to create an account — the agent will give you one. The API key is optional — the MCP server can authenticate interactively via auth_email + auth_verify.

Learn more

• What is lightpaper.org?
• Publishing your first document via the API
• Using the MCP server
• How quality scoring works
• Author gravity: a trust system for the agentic web
• Three document formats: post, essay, and paper
• Search, discovery, and SEO
• Authentication without passwords
• Verifying your identity
• Markdown, code highlighting, and footnotes

Source

lightpaper is open source: github.com/lightpaperorg/lightpaper