junipr-mcp

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

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

config.json

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

Claude Code (CLI)

Terminal

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

Then set the environment variable:

server.ts

export JUNIPR_API_KEY=your-api-key-here

Cursor

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

config.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):

config.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):

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