<p align="center">
  <img src="assets/logo-400.png" width="120" height="120" alt="ProWebLook Logo" />
</p>

<h1 align="center">ProWebLook MCP Server</h1>

<p align="center">
  Official Model Context Protocol (MCP) server for <a href="https://proweblook.com">ProWebLook</a> — 19 real-time tools for email verification, phone validation, WhatsApp active checks, caller ID (CNAM), IP geolocation, blacklist & spam checks, web/social scraping, Google SERP, and AI brand visibility audits.
</p>

---

## Overview

ProWebLook hosts a stateless, globally distributed **Streamable HTTP** MCP server at `https://mcp.proweblook.com/mcp` and also ships a zero-dependency Node.js `stdio` bridge (`bin/proweblook-mcp.mjs`) in this repository so every MCP client works out of the box.

- **Remote Endpoint:** `https://mcp.proweblook.com/mcp`
- **Get an API Key (Free Tier Included):** [https://proweblook.com/user/my_profile](https://proweblook.com/user/my_profile)
- **Privacy Policy:** [https://proweblook.com/privacy-policy](https://proweblook.com/privacy-policy)
- **API Spec:** [https://proweblook.com/openapi.json](https://proweblook.com/openapi.json)

---

## Quick Setup

### 1. Cline (`cline_mcp_settings.json`)

See [`llms-install.md`](llms-install.md) for one-shot AI setup, or add directly:

```json
{
  "mcpServers": {
    "proweblook": {
      "type": "streamableHttp",
      "url": "https://mcp.proweblook.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PROWEBLOOK_API_KEY"
      }
    }
  }
}
```

Or via `stdio` (`npx`, Node.js >= 18):

```json
{
  "mcpServers": {
    "proweblook": {
      "command": "npx",
      "args": ["-y", "github:dubeychandan996/proweblook-mcp"],
      "env": {
        "PROWEBLOOK_API_KEY": "YOUR_PROWEBLOOK_API_KEY"
      }
    }
  }
}
```

### 2. Claude Code

```bash
claude mcp add --transport http proweblook https://mcp.proweblook.com/mcp --header "Authorization: Bearer YOUR_PROWEBLOOK_API_KEY"
```

### 3. Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "proweblook": {
      "url": "https://mcp.proweblook.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PROWEBLOOK_API_KEY"
      }
    }
  }
}
```

### 4. VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "proweblook": {
      "type": "http",
      "url": "https://mcp.proweblook.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PROWEBLOOK_API_KEY"
      }
    }
  }
}
```

### 5. Windsurf (`~/.codeium/windsurf/mcp_config.json`)

```json
{
  "mcpServers": {
    "proweblook": {
      "serverUrl": "https://mcp.proweblook.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PROWEBLOOK_API_KEY"
      }
    }
  }
}
```

---

## Available Tools (19)

| Tool | Description | Credit Cost |
| --- | --- | --- |
| `verify_email` | Real-time email verification (syntax, MX, SMTP, disposable, catch-all) | 1 email credit |
| `validate_phone` | Phone number validation with carrier, line type, country & timezone | 1 phone credit |
| `check_whatsapp` | Check whether a phone number is registered on WhatsApp (+ Business detection, no OTP sent) | 1 WhatsApp credit |
| `whatsapp_batch_submit` | Submit async batch WhatsApp check (up to 1,000 numbers) | 1 WhatsApp credit / number |
| `whatsapp_batch_status` | Poll batch WhatsApp validation status & results | Free |
| `caller_id_lookup` | Reverse phone lookup (CNAM caller name) | 1 caller ID credit |
| `geo_ip` | IP geolocation (country, city, ISP, ASN) | Geo-IP quota |
| `check_blacklist` | Check IP, domain, or URL against global DNSBL blacklists | 1 blacklist credit |
| `check_spam_score` | Score email subject & body (0–100 spam score) | 1 spam-checker credit |
| `scrape_url` | Scrape any URL to clean Markdown, HTML, links, metadata, or screenshot | 1 scraping credit |
| `search_social` | Keyword search across Reddit, X (Twitter), or LinkedIn | 1 scraper credit |
| `get_social_post` | Fetch structured post details by social URL | 1 scraper credit |
| `get_x_comments` | Fetch replies/comments on an X post | 1 scraper credit |
| `google_serp` | Real-time structured Google Search SERP results | 1 SERP credit |
| `run_brand_audit` | Start async AI Brand Visibility audit across ChatGPT, Claude, Gemini & Perplexity | 1 audit credit |
| `get_brand_audit` | Poll audit status & retrieve full visibility report | Free |
| `list_brand_audits` | List historical AI brand visibility audits | Free |
| `get_brand_trend` | Retrieve AI brand visibility score trends over time | Free |
| `get_balance` | Check remaining credit balances across ProWebLook product pools | Free |

---

## License

MIT — see [`LICENSE`](LICENSE).