junipr-labs/mcp-server

MCP server for Junipr APIs. Gives AI assistants access to 75+ web intelligence tools — screenshots, PDFs, metadata extraction, scrapers, validators, and more.

Tools

Tool	Description
screenshot	Capture a screenshot of any webpage (PNG, JPEG, or WebP)
pdf	Generate a PDF from a URL or raw HTML
metadata	Extract title, description, Open Graph, Twitter Cards, JSON-LD, and more
run_tool	Run any of 75+ Junipr tools by slug (scrapers, validators, converters, analyzers)

Setup

1. Get an API key

Sign up at junipr.io/login to get a free API key (500 credits/month).

2. Configure your MCP client

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "junipr": {
      "command": "npx",
      "args": ["-y", "junipr-mcp"],
      "env": {
        "JUNIPR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add junipr -- npx -y junipr-mcp

Then set the environment variable:

export JUNIPR_API_KEY=your-api-key-here

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "junipr": {
      "command": "npx",
      "args": ["-y", "junipr-mcp"],
      "env": {
        "JUNIPR_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "junipr": {
      "command": "npx",
      "args": ["-y", "junipr-mcp"],
      "env": {
        "JUNIPR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "junipr": {
      "command": "npx",
      "args": ["-y", "junipr-mcp"],
      "env": {
        "JUNIPR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tool Reference

screenshot

Capture a screenshot of any webpage.

Parameter	Type	Default	Description
url	string	(required)	URL to capture
format	png | jpeg | webp	png	Image format
width	number	1280	Viewport width (320-3840)
height	number	720	Viewport height (200-2160)
fullPage	boolean	false	Capture full scrollable page
deviceType	desktop | mobile | tablet	desktop	Device to emulate
blockCookieBanners	boolean	true	Hide cookie banners

pdf

Generate a PDF from a URL or HTML.

Parameter	Type	Default	Description
url	string	—	URL to convert (provide url or html)
html	string	—	Raw HTML to convert (provide url or html)
format	A4 | Letter | Legal | Tabloid | A3 | A5	A4	Paper format
landscape	boolean	false	Landscape orientation
printBackground	boolean	true	Include backgrounds
margin	object	1cm each	{ top, right, bottom, left } in CSS units
headerTemplate	string	—	Header HTML template
footerTemplate	string	—	Footer HTML template
displayHeaderFooter	boolean	false	Show header/footer

metadata

Extract metadata from any webpage.

Parameter	Type	Default	Description
url	string	(required)	URL to extract metadata from

Returns title, description, Open Graph tags, Twitter Cards, JSON-LD structured data, favicon, canonical URL, language, and more.

License

MIT