@rendermark/mcp-server

MCP (Model Context Protocol) server for RenderMark — expose markdown rendering and document management to AI agents.

Installation

npm install @rendermark/mcp-server

CLI

The package also installs a rendermark CLI for agents and humans that cannot use MCP directly:

rendermark export README.md --format pdf --out README.pdf
rendermark export README.md --format html
rendermark publish README.md --json
rendermark auth setup

Publishing requires RENDERMARK_API_KEY or ~/.rendermark/config.json.

Configuration

Create ~/.rendermark/config.json:

{
  "apiKey": "rm_live_your_api_key_here",
  "apiBaseUrl": "https://rendermark.app"
}

Get your API key from rendermark.app/settings/keys.

Tools

The MCP server exposes 17 tools:

Rendering

| Tool | Description | |------|-------------| | render_markdown | Convert markdown to styled HTML with themes, templates, TOC, and syntax highlighting | | render_to_image | Render markdown to PNG or JPEG image | | render_diff | Generate a side-by-side or inline diff view between two markdown versions | | export_markdown | Export markdown to a PDF, DOCX, or HTML file on disk | | export_batch | Batch export multiple markdown files at once | | validate_markdown | Check markdown for common issues and formatting problems |

Publishing & Sharing

| Tool | Description | |------|-------------| | publish_to_rendermark | Publish a markdown document to RenderMark and get a shareable link | | publish_to_google_docs | Publish a markdown document as a Google Doc | | share_live_preview | Create a temporary shareable URL with configurable expiration (1h–7d) | | share_document | Share a published document with specific email addresses |

Document Management

| Tool | Description | |------|-------------| | read_document | Fetch a document from RenderMark by URL, slug, or ID | | update_document | Update an existing document's content, title, or settings | | list_documents | List your documents with search, filtering, and pagination | | delete_document | Delete a document (requires explicit confirmation) |

Sync

| Tool | Description | |------|-------------| | sync_from_github | Sync a markdown file from a GitHub repository to RenderMark |

Setup

| Tool | Description | |------|-------------| | setup_api_key | Set up a RenderMark API key via browser authentication | | get_rendermark_instructions | Retrieve agent workflow guidance for RenderMark tool selection |

Agent Skill

An open-standard SKILL.md for Codex and Claude Code ships in:

packages/mcp-server/skills/rendermark/

Install it by copying that rendermark folder into the agent's skills directory, such as ~/.codex/skills/ or ~/.claude/skills/.

Claude Desktop MCPB

Build a one-click Claude Desktop bundle with:

npm run pack:mcpb -w packages/mcp-server

The generated .mcpb file is written to packages/mcp-server/mcpb/dist/.

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "rendermark": {
      "command": "npx",
      "args": ["-y", "@rendermark/mcp-server@latest"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "rendermark": {
      "command": "npx",
      "args": ["-y", "@rendermark/mcp-server@latest"]
    }
  }
}

OpenClaw

Add to your OpenClaw MCP configuration:

{
  "mcpServers": {
    "rendermark": {
      "command": "npx",
      "args": ["-y", "@rendermark/mcp-server@latest"]
    }
  }
}

Examples

Render a document

Ask your AI agent:

"Render this markdown as a styled HTML document with the serif theme"

Publish and share

"Publish my README.md to RenderMark and share it with [email protected]"

Export to PDF

"Export the project documentation to PDF with a table of contents"

Diff two versions

"Show me the diff between the old and new versions of this document"

License

MIT