# junipr-mcp

MCP server for [Junipr](https://junipr.io) 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](https://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`

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

#### Claude Code (CLI)

```bash
claude mcp add junipr -- npx -y junipr-mcp
```

Then set the environment variable:

```bash
export JUNIPR_API_KEY=your-api-key-here
```

#### Cursor

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

```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`):

```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`):

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