Metadata-Version: 2.4
Name: nexargio-mcp
Version: 1.1.0
Summary: Nexargio Sovereign Cyber-Physics Threat Scanner for MCP
Author-email: Nexargio Technologies <engineering@nexargio.com>
License: Proprietary
Project-URL: Homepage, https://nexargio-vip-gateway-bepltxkx4a-el.a.run.app
Project-URL: Documentation, https://nexargio-vip-gateway-bepltxkx4a-el.a.run.app/portal/api-keys
Keywords: mcp,model-context-protocol,cybersecurity,zero-day,phishing-detection,threat-intelligence,quishing
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Security
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp<2.0.0,>=1.0.0
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: opencv-python-headless>=4.8.0
Provides-Extra: test
Requires-Dist: pytest>=7.4.0; extra == "test"
Requires-Dist: qrcode>=7.4.0; extra == "test"

# Nexargio Sovereign Model Context Protocol (MCP) Server
The Sovereign Cyber-Physics Defense Organ for Autonomous AI Agents

Connects **Claude Desktop**, **Cursor IDE**, **Antigravity**, and autonomous agent frameworks directly to the Nexargio Autonomous Cyber-Physics & Neural Defense Gateway.

---

## 🛠️ The Unified Sovereign Tool: `nexargio_scan`

We provide **ONE single, polymorphic tool**. No confusion, no multiple buttons:

```
nexargio_scan(target: str, scan_mode: str = "fast")
```

### What `target` accepts:
1. **Full URL:** e.g. `https://login.microsoftonline.portal-security-check.com/auth`
2. **Domain name:** e.g. `portal-security-check.com` (automatically normalized to `https://`)
3. **QR Code Image:** e.g. `C:\Downloads\invoice_qr.png` or Base64 (automatically decodes to URL and scans the destination)

### What it executes:
- All **18 DOM Primitives** (credential sinks, login forms, hidden fields, exfiltration actions)
- **Sensory DAG** (DNS domain age/NRD, TLS/X.509 cert authority, BGP ASN routing)
- **Brand Contradiction Analysis** (detects mimicry of Microsoft, Google, PayPal, Amazon, etc.)
- **Autonomous Neural Reasoning:**
  - **Single Scan:** Evaluated by **Qwen** for deep forensic explanation and verdict.
  - **Bulk / Fleet Scan:** Evaluated by **JEV** for high-velocity probability scoring.
- **RFC 3161 NIST SHA-256 Notarization:** Returns an immutable evidence seal for SOC compliance.

---

---

## 🚀 Connect to Claude Desktop

### Option A: Via `uvx` (Recommended - Zero Path Dependency)
In `%APPDATA%\Claude\claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "nexargio": {
      "command": "uvx",
      "args": ["nexargio-mcp"],
      "env": {
        "NEXARGIO_API_KEY": "<YOUR_PORTAL_API_KEY>",
        "NEXARGIO_GATEWAY_URL": "https://nexargio-vip-gateway-bepltxkx4a-el.a.run.app"
      }
    }
  }
}
```

### Option B: Local Direct Python Path
```json
{
  "mcpServers": {
    "nexargio": {
      "command": "python",
      "args": [
        "c:\\Users\\venky\\my project 4-1\\myproject\\nexargio_mcp.py"
      ],
      "env": {
        "NEXARGIO_API_KEY": "<YOUR_PORTAL_API_KEY>",
        "NEXARGIO_GATEWAY_URL": "https://nexargio-vip-gateway-bepltxkx4a-el.a.run.app"
      }
    }
  }
}
```

---

## 🚀 Connect to Cursor IDE

In `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "nexargio-defense": {
      "command": "uvx",
      "args": ["nexargio-mcp"],
      "env": {
        "NEXARGIO_API_KEY": "<YOUR_PORTAL_API_KEY>"
      }
    }
  }
}
```

---

## 🧪 Verification

Run the validation test:
```powershell
python "c:\Users\venky\my project 4-1\myproject\test_mcp_client.py"
```
