mcp-server

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

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