# mcp-si-radar

> **Authoritative Registry Socket Scanner, Real-Time Availability Checker, GEMINI Rule 10 Evaluator & Instant Checkout Generator for .si (Slovenia) ccTLDs.**

[![npm version](https://img.shields.io/npm/v/mcp-si-radar.svg)](https://www.npmjs.com/package/mcp-si-radar)
[![smithery badge](https://smithery.ai/badge/mcp-si-radar)](https://smithery.ai/server/mcp-si-radar)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

---

## 📌 Problem & Technical Architecture

### 1. Common Bottlenecks in `.si` Domain Acquisition
* **Registrar Search Lag:** Web interfaces of major registrars (Dynadot, Spaceship, Namecheap) frequently hang, show infinite loading spinners, or rate-limit users when searching for `.si` domains because of multi-TLD suggestions, marketplace calls, and heavy frontend bundles.
* **Anti-Bot Roadblocks:** Aggressive Cloudflare Turnstile, CAPTCHAs, and session timeouts disrupt research and domain acquisition workflows.
* **Cart Flow Friction:** Adding domains through a web search bar re-triggers redundant checks and upsell popups that slow down domain registration.

### 2. The `mcp-si-radar` Solution
1. **Direct Socket Connection to ARNES Registry (Port 43):**
   * Connects directly via raw TCP socket to `whois.register.si:43` (the sovereign national registry of Slovenia).
   * Blazing-fast response time (**~50ms – 200ms**).
   * 100% real-time authoritative accuracy, bypassing all web proxies, CDN queues, and CAPTCHAs.
2. **Pacing Delay Engine (Batch Scanning):**
   * Automatically paces sequential queries (default 350ms) to ensure ARNES firewall never rate-limits or blocks your IP.
3. **Fast Checkout Deep-Links:**
   * Generates clean direct URLs that open registrars with the target domain pre-selected and an immediate "Add to Cart" button, bypassing homepage search lag.
4. **Automated Headless API Registration:**
   * Direct integration with Dynadot REST API (`api.dynadot.com/api3.json`) for zero-click purchases right from the AI chat window.
5. **GEMINI Rule 10 Discipline ("Two-Reading Rule"):**
   * Automatically scores **Reading A** (Domestic Slovenian Real-Economy Baseline) and **Reading B** (Superintelligence Option Value).
   * Delivers actionable verdicts: **🟢 HOLD (ACQUIRE)**, **🟡 OPTIONAL (SPECULATIVE)**, or **🔴 AVOID (HIGH RISK)** to prevent portfolio dilution.

---

## 🛠️ MCP Tools Reference

| Tool Name | Description |
| :--- | :--- |
| `si_check_domain` | Real-time availability query via ARNES socket port 43. Returns registration status, socket latency, registrar details, expiry, fast checkout links, and Rule 10 evaluation. |
| `si_batch_check` | Scans a list of candidate `.si` keywords with an intelligent pacing delay to prevent registry throttling. Separates available vs registered domains. |
| `si_fast_checkout` | Generates instant deep-links to pre-fill shopping carts across Dynadot, Spaceship, Namecheap, and Porkbun. |
| `si_evaluate_rule10` | Evaluates `.si` domains under GEMINI Rule 10 (Slovenian Baseline Salary vs Superintelligence Lottery Ticket). |
| `si_api_register` | Executes instant automated domain purchase via Dynadot API (requires `DYNADOT_API_KEY` in `.env`). |

---

## 🚀 Installation & Configuration

### 1. Global / Project MCP Configuration
Add `mcp-si-radar` to your MCP configuration file (`mcp_config.json` or `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "mcp-si-radar": {
      "command": "npx",
      "args": ["-y", "mcp-si-radar"],
      "env": {
        "DYNADOT_API_KEY": ""
      }
    }
  }
}
```

Or run directly from local source:
```json
{
  "mcpServers": {
    "mcp-si-radar": {
      "command": "node",
      "args": ["/path/to/mcp-si-radar/index.js"]
    }
  }
}
```

### 2. Optional Environment Variables
In your project `.env`:
```env
# Optional: Enables zero-click automated purchases via si_api_register
DYNADOT_API_KEY=your_dynadot_api_key_here
```

---

## 📋 Example Usage

### Single Domain Check
```json
{
  "name": "si_check_domain",
  "arguments": {
    "domain": "compute.si"
  }
}
```
**Sample Response:**
```json
{
  "domain": "compute.si",
  "available": false,
  "status": "REGISTERED",
  "latency_ms": 118,
  "details": {
    "registrar": "Dynadot Inc",
    "status": "ok",
    "created": "2026-09-20",
    "expire": "2027-09-20"
  },
  "rule_10_assessment": {
    "reading_A": {
      "concept": "Territory / Slovenian Real Economy (BASELINE SALARY)",
      "score": "1/3",
      "analysis": "Universal tech and cloud compute term applicable to Slovenian data centers."
    },
    "reading_B": {
      "concept": "Domain Hack: [Word] + Superintelligence (OPTION VALUE)",
      "score": "2/3",
      "analysis": "Natural semantic synergy with Superintelligence compute clusters."
    },
    "verdict": "🟡 OPTIONAL (SPECULATIVE)"
  }
}
```

### Batch Scanning
```json
{
  "name": "si_batch_check",
  "arguments": {
    "domains": ["compute", "piloting", "kinging", "nuclear", "safe.si"],
    "delay_ms": 350
  }
}
```

---

## 👤 Author & Support
- **Author:** Tu Da (Founder & Research Lead | Dot The World)
- **Website:** [https://dottheworld.com](https://dottheworld.com)
- **Email:** [ceo@dottheworld.com](mailto:ceo@dottheworld.com)

---

## 📄 License
MIT © Tu Da (Dot The World) <ceo@dottheworld.com>