lightpaper-mcp — Claude Code MCP server: publish markdown
Ships a markdown document to lightpaper.org from inside the agent and hands back a permanent link with a quality score.
claude mcp add --env LIGHTPAPER_API_KEY=<LIGHTPAPER_API_KEY> --env LIGHTPAPER_BASE_URL=<LIGHTPAPER_BASE_URL> --transport stdio lightpaper-mcp -- uvx lightpaper-mcpWhat lightpaper-mcp does
The server wraps the lightpaper.org publishing API for your coding agent. Send a document, get two addresses back: a readable one and a permanent path under https://lightpaper.org/d/..., along with a score from 0 to 100 split into structure, substance, tone and attribution. The page renders in a browser and produces a preview card when shared on social platforms or in chat apps. Fetch the same URL with Accept: application/json and you get the content as data.
It runs as a stdio server through uvx, so uv has to be present and an API key is required. One Claude setup passes a single variable; a second also sets LIGHTPAPER_BASE_URL, which you want when publishing to your own instance rather than the main domain. No LIGHTPAPER_API_KEY means no connection to the API, so sort the key out first. Anything scoring under 40 gets noindex and stays out of search results, which matters when you push a draft.
Every document sits under a human account, and the platform verifies identity starting with email. How well that identity is confirmed shifts search ranking. A setup tool can walk the agent through the flow, but the OAuth clicks and DNS records still need a person.
What it helps with
- publish an agent report as a permanent link instead of a chat attachment
- check a draft's quality score before it goes public
- fetch structured data back from a document URL
- get a preview card for a document on social and in chat apps
- turn a local markdown file into a public page
Example prompts for the agent
- Publish
report.mdto lightpaper and give me the permanent link - Publish this write-up and tell me what quality score it got
- Use lightpaper-mcp to fetch the permanent URL as JSON
How to install lightpaper-mcp
Platform CLI
claude mcp add --env LIGHTPAPER_API_KEY=<LIGHTPAPER_API_KEY> --env LIGHTPAPER_BASE_URL=<LIGHTPAPER_BASE_URL> --transport stdio lightpaper-mcp -- uvx lightpaper-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lightpaper-mcp <command>
Platform CLI
codex mcp add lightpaper-mcp --env LIGHTPAPER_API_KEY=<LIGHTPAPER_API_KEY> --env LIGHTPAPER_BASE_URL=<LIGHTPAPER_BASE_URL> -- uvx lightpaper-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lightpaper-mcp <command>
Config file
{
"mcpServers": {
"lightpaper-mcp": {
"command": "uvx",
"args": [
"lightpaper-mcp"
],
"env": {
"LIGHTPAPER_API_KEY": "<LIGHTPAPER_API_KEY>",
"LIGHTPAPER_BASE_URL": "<LIGHTPAPER_BASE_URL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lightpaper-mcp <command>
Config file
{
"servers": {
"lightpaper-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"lightpaper-mcp"
],
"env": {
"LIGHTPAPER_API_KEY": "<LIGHTPAPER_API_KEY>",
"LIGHTPAPER_BASE_URL": "<LIGHTPAPER_BASE_URL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lightpaper-mcp <command>
Platform CLI
gemini mcp add -e LIGHTPAPER_API_KEY=<LIGHTPAPER_API_KEY> -e LIGHTPAPER_BASE_URL=<LIGHTPAPER_BASE_URL> lightpaper-mcp uvx lightpaper-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lightpaper-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about lightpaper-mcp
How do I install lightpaper-mcp in Claude Code?
Run claude mcp add lightpaper-mcp -e LIGHTPAPER_API_KEY=<LIGHTPAPER_API_KEY> -- uvx lightpaper-mcp. To point at your own platform host, use the two-variable form: `claude mcp add --env LIGHTPAPER_API_KEY=<LIGHTPAPER_API_KEY> --env LIGHTPAPER_BASE_URL=<LIGHTPAPER_BASE_URL> --transport stdio lightpaper-mcp -- uvx lightpaper-mcp`.
What does lightpaper-mcp do?
It publishes markdown to lightpaper.org through the platform API and returns a link, a permanent URL and a quality score. It also has a tool that guides an author through identity verification.
What do I need before it works?
A LIGHTPAPER_API_KEY from a lightpaper.org account and uvx on the machine, since the server starts as a stdio process.
