MCP Server

Orim provides a native Model Context Protocol (MCP) server, allowing AI assistants to generate PDFs and capture screenshots directly.

Supported clients

• Claude Desktop — Anthropic’s desktop app
• Claude Code — CLI for developers
• Cursor — AI-first code editor
• Windsurf — Codeium’s AI IDE
• Any MCP-compatible client

Setup

1. Get your API key

Get a free API key — 20 credits/month, no credit card.

2. Configure your client

Claude Desktop

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

{
  "mcpServers": {
    "orim": {
      "type": "http",
      "url": "https://api.orim.io/mcp",
      "headers": {
        "X-API-Key": "sk_live_YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Add to your project’s .mcp.json:

{
  "mcpServers": {
    "orim": {
      "type": "http",
      "url": "https://api.orim.io/mcp",
      "headers": {
        "X-API-Key": "sk_live_YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to Cursor settings (Settings > MCP Servers):

{
  "orim": {
    "type": "http",
    "url": "https://api.orim.io/mcp",
    "headers": {
      "X-API-Key": "sk_live_YOUR_API_KEY"
    }
  }
}

3. Restart your client

After adding the config, restart your AI client. Orim tools will be available immediately.

Available tools

html_to_pdf

Convert HTML to PDF.

Parameter	Type	Default	Description
html	string	required	HTML content to convert
format	string	"A4"	Page format: A4, Letter, Legal
landscape	boolean	false	Landscape orientation

url_to_pdf

Convert a webpage URL to PDF.

Parameter	Type	Default	Description
url	string	required	URL to convert
format	string	"A4"	Page format: A4, Letter, Legal
landscape	boolean	false	Landscape orientation

url_to_screenshot

Capture a webpage screenshot.

Parameter	Type	Default	Description
url	string	required	URL to capture
width	number	1280	Viewport width
height	number	720	Viewport height
fullPage	boolean	false	Capture full scrollable page
format	string	"png"	Image format: png, jpeg, webp

check_usage

Check your API usage and remaining credits.

Example prompts

Once configured, just ask your AI:

• “Generate a PDF invoice for customer John Doe, $500 for consulting services”
• “Take a screenshot of https://github.com”
• “Convert this HTML table to PDF in landscape format”
• “Check my Orim API usage”

The AI will use Orim tools automatically and return download links.

How it works

1. You ask your AI to generate a PDF or screenshot
2. AI calls the appropriate Orim MCP tool
3. Orim processes the request using Chromium
4. AI receives a temporary download URL (valid 10 minutes)
5. AI shares the link with you

Troubleshooting

Tools not appearing

• Verify your API key is correct
• Restart your AI client after config changes
• Check the config file path matches your OS

”Invalid API key” error

• Ensure the key starts with sk_live_
• Get a new key at orim.io/dashboard

”Credit limit reached”

• Check usage at orim.io/dashboard
• Upgrade your plan for more credits

Next steps

• PDF Generation Guide — All PDF options
• Screenshots Guide — All screenshot options
• API Reference — REST API documentation