npm package: @rendermark/mcp-server
Description: > MCP (Model Context Protocol) server for RenderMark — expose markdown rendering and document management to AI agents.
Latest version: 0.1.8

# @rendermark/mcp-server

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

## Installation

```bash
npm install @rendermark/mcp-server
```

## Configuration

Create `~/.rendermark/config.json`:

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

Get your API key from [rendermark.app/settings/keys](https://rendermark.app/settings/keys).

## Tools

The MCP server exposes 16 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 |

## Setup

### Claude Desktop

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

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

### Cursor

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

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

### OpenClaw

Add to your OpenClaw MCP configuration:

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

## 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 team@example.com"

### 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