# NexusGrid Unified MCP Server (`nexusgrid-mcp`)

[![npm version](https://img.shields.io/npm/v/nexusgrid-mcp.svg?color=blue)](https://www.npmjs.com/package/nexusgrid-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Official **Model Context Protocol (MCP)** server providing AI coding agents and LLMs with instant web scraping, email deliverability auditing, and signup fraud verification tools.

Engineered for **Claude Desktop, Cursor, Windsurf, Zed, and LangChain**.

---

## ⚡ Available Tools

| Tool Name | Description | Source API |
| :--- | :--- | :--- |
| `nexus_scrape` | Fetches any URL and extracts clean, LLM-optimized Markdown while stripping ads, cookie banners, navigation, and clutter. | [NexusScrape API](https://rapidapi.com/benjaminsamson0210/api/nexusscrape-web-to-markdown-llm-content-extractor) |
| `email_deliverability_audit` | Full audit of SPF, DKIM, DMARC, BIMI, MTA-STS, and RFC 7208 lookup cap depth. Verifies Google/Yahoo 2024 compliance. | [MailAuthGuard API](https://rapidapi.com/benjaminsamson0210/api/mailauthguard-email-authentication-deliverability-auditor) |
| `verify_email_risk` | Instant disposable email detection, fraud scoring, and MX deliverability check for any email address. | [FraudShield API](https://rapidapi.com/benjaminsamson0210/api/fraudshield-email-risk-guard) |

---

## 🚀 Quickstart

Run directly without installing via `npx`:

```bash
npx nexusgrid-mcp
```

Or install globally:

```bash
npm install -g nexusgrid-mcp
```

---

## 🛠️ Configuration

### 1. Claude Desktop

Add this to your Claude Desktop configuration file:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`  
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "nexusgrid": {
      "command": "npx",
      "args": ["-y", "nexusgrid-mcp"]
    }
  }
}
```

### 2. Cursor IDE

In Cursor Settings -> **Features** -> **MCP Servers** -> **Add New MCP Server**:
- **Name:** `nexusgrid`
- **Type:** `command`
- **Command:** `npx -y nexusgrid-mcp`

### 3. Optional: RapidAPI Pro Key (For High-Volume Quotas)

By default, the server includes community rate limits. If you have a RapidAPI Pro key for unlimited requests across the NexusGrid suite, pass `RAPIDAPI_KEY`:

```json
{
  "mcpServers": {
    "nexusgrid": {
      "command": "npx",
      "args": ["-y", "nexusgrid-mcp"],
      "env": {
        "RAPIDAPI_KEY": "your-rapidapi-key-here"
      }
    }
  }
}
```

---

## 📖 Tool Usage & Schema

### 1. `nexus_scrape`
Converts any web article or documentation into clean Markdown.

```json
{
  "url": "https://example.com/blog/my-post",
  "include_images": false,
  "only_main": true
}
```

### 2. `email_deliverability_audit`
Runs comprehensive RFC-compliant email health audits.

```json
{
  "domain": "stripe.com",
  "dkim_selector": "google"
}
```

### 3. `verify_email_risk`
Detects throwaway and disposable emails in signups or outreach lists.

```json
{
  "email": "user@tempmail.com"
}
```

---

## 📄 License

MIT License © 2026 NexusGrid