# ClaudEye — MCP Server Setup

## What is ClaudEye?

ClaudEye gives AI agents a real browser. When `WebFetch` returns empty HTML shells from JavaScript-rendered pages (React, Vue, Angular SPAs), ClaudEye renders the full page using headless Chromium and returns clean markdown.

**Cost:** $0.01 USDC per page on Base (paid automatically via x402 micropayments).

## Prerequisites

- A wallet with USDC on Base (even $1 gets you 100 pages)
- The wallet's private key (hex string starting with `0x`)

## Installation

Run this command to register the ClaudEye MCP server:

```bash
claude mcp add --transport stdio claudeye \
  --env X402_PRIVATE_KEY=0x_REPLACE_WITH_PRIVATE_KEY \
  -- npx claudeye-mcp
```

Replace `0x_REPLACE_WITH_PRIVATE_KEY` with the wallet's actual private key. The key is stored locally in your MCP config and is never sent to ClaudEye.

After running this command, restart your Claude Code session so the MCP server loads.

## Usage

Once installed, the `scrape` tool is available. Use it when `WebFetch` returns incomplete content:

- Empty `<div id="root"></div>` with script tags
- "You need to enable JavaScript to run this app"
- Mostly empty response from a known content-rich site

The tool accepts a single `url` parameter and returns rendered markdown.

## When to use ClaudEye vs WebFetch

| Scenario | Tool |
|----------|------|
| Site returns full HTML content | WebFetch (no need for ClaudEye) |
| Site returns empty JS shell | ClaudEye |
| "JavaScript is not available" | ClaudEye |
| SSR/SSG sites (docs, blogs) | WebFetch |
| SPAs (dashboards, web apps) | ClaudEye |

## API

```
GET https://claudeye.notoriousd3v.workers.dev/scrape?url={encoded_url}
```

Payment is handled automatically by the MCP server via the x402 protocol.

## Links

- Landing page: https://claudeye.notoriousd3v.workers.dev
- Test page: https://claudeye.notoriousd3v.workers.dev/test
- x402 Protocol: https://x402.org
- MCP: https://modelcontextprotocol.io