# Skuuy Tools — Comprehensive LLM Context & Engineering Reference (llms-full.txt) > Skuuy Tools (https://skuuy.com) is a free, open-source privacy and network diagnostics suite built on serverless edge infrastructure. > All utilities run without user registration, tracking cookies, or payment requirements. > Zero-knowledge cryptographic operations execute locally in the browser via native WebCrypto APIs (W3C standard) or via zero-log serverless edge workers. > Every tool is equipped with a high-performance, CORS-enabled JSON REST API and Model Context Protocol (MCP) tooling designed for autonomous AI agents and software engineers. --- ## 1. System Architecture & Core Principles - **Zero-Knowledge Computation**: For security-critical utilities like 2FA TOTP generation, secret keys are never transmitted across HTTP/HTTPS networks or persisted to databases. Cryptographic HMAC and AES-GCM operations execute inside client browser memory (`crypto.subtle`) or in stateless edge memory without disk persistence. - **Zero Traffic Logging**: Web requests, proxy tests, IP lookups, port checks, and DNS queries are not associated with persistent identifiers or logged for surveillance/profiling. - **Ephemeral Storage with Strict TTL**: Dynamic payloads (e.g. incoming temporary emails on mail.skuuy.com) reside in edge key-value storage with an automated 30-minute Time-To-Live (TTL) expiration before permanent deletion. - **Serverless Edge Performance**: Deployed across 300+ global Anycast PoPs, ensuring sub-30ms execution and automated Anycast DDoS protection globally. - **Zero Friction for AI Agents**: All public APIs feature `Access-Control-Allow-Origin: *`, require zero API keys, and return standardized JSON formats. - **Pricing & Monetization**: 100% Free Forever. Sustained through non-intrusive Google AdSense advertising (ca-pub-8440630877434169) and verified infrastructure referral partnerships. --- ## 2. Active Ecosystem Tools & REST API Specifications ### 2.1 Skuuy IP & Leak Intelligence - **URL**: https://ip.skuuy.com - **Purpose**: Inspect public IP address, geolocation, Autonomous System (ASN), network provider, and security leaks. - **Public API**: `GET https://ip.skuuy.com/api/myip` - **Curl Example**: ```bash curl -s https://ip.skuuy.com/api/myip ``` - **API Response Structure**: ```json { "ip": "203.0.113.195", "country": "Indonesia", "countryCode": "ID", "city": "Jakarta", "region": "Jakarta", "postalCode": "10110", "latitude": -6.2088, "longitude": 106.8456, "asn": "AS7713", "isp": "Telkom Indonesia", "colo": "CGK", "isProxy": false, "isVpn": false } ``` - **Diagnostics**: - Dual-stack IPv4 and IPv6 detection. - WebRTC STUN candidate leak detector (`RTCPeerConnection` ice candidate analysis). - Recursive DNS leak and DoH resolver audit. - IPv4 CIDR subnet range calculator and netmask matrix. - IP risk and commercial VPN scoring. --- ### 2.2 Skuuy 2FA Authenticator & TOTP Generator - **URL**: https://2fa.skuuy.com - **Specification**: RFC 6238 Time-Based One-Time Password (TOTP) algorithm. - **Public API**: `GET https://2fa.skuuy.com/api/totp?secret={BASE32_SECRET}` - **Curl Example**: ```bash curl -s "https://2fa.skuuy.com/api/totp?secret=JBSWY3DPEHPK3PXP" ``` - **API Response Structure**: ```json { "ok": true, "code": "839201", "epoch": 1728471234, "period": 30, "remainingSeconds": 26, "validUntil": 1728471260, "previousCode": "194820", "nextCode": "402914", "algorithm": "SHA-1", "digits": 6 } ``` - **Edge Time Sync API**: `GET https://2fa.skuuy.com/api/time` - Returns Anycast edge UTC timestamp to eliminate local clock drift. - **Features**: - Multi-source QR scanner: live webcam stream, image file drag-and-drop, and clipboard screenshot paste (`Ctrl + V`). - High-security client-side vault encrypted with AES-GCM 256-bit and PBKDF2 (100,000 hashing rounds). - Sub-10ms clock drift synchronization via Anycast edge time endpoint. - Previous (-30s) and Next (+30s) code history window for seamless login validation. --- ### 2.3 Skuuy Temp Mail & Instant OTP Suite - **URL**: https://mail.skuuy.com - **Purpose**: Ephemeral disposable inboxes with automated multi-domain rotation and AI-friendly OTP extraction. - **Generate Inbox API**: `GET https://mail.skuuy.com/api/generate` - **Curl Example**: ```bash curl -s https://mail.skuuy.com/api/generate ``` Response: ```json { "ok": true, "email": "agent-q938x@gmeow.page", "domain": "gmeow.page", "expiresAt": "2026-10-09T18:00:00.000Z", "ttlMinutes": 30 } ``` - **Direct OTP Fetch API**: `GET https://mail.skuuy.com/api/otp?email={EMAIL}` - **Curl Example**: ```bash curl -s "https://mail.skuuy.com/api/otp?email=agent-q938x@gmeow.page" ``` Response: ```json { "ok": true, "email": "agent-q938x@gmeow.page", "otp": "492018", "service": "GitHub", "actionLink": "https://github.com/users/verify?token=xyz", "receivedAt": "2026-10-09T17:35:12.000Z" } ``` - **Full Inbox Poll API**: `GET https://mail.skuuy.com/api/inbox?email={EMAIL}` - **Features**: - RFC 2045 MIME Quoted-Printable and Base64 parser ensuring zero URL mangling. - 1-click OTP code detector with regex extraction. - Password Reset Action Link extraction with sandboxed rendering. - 30-minute automated KV deletion. --- ### 2.4 Skuuy Free Proxy & SOCKS Hub - **URL**: https://proxy.skuuy.com - **Public API**: `GET https://proxy.skuuy.com/api/proxies` - **Curl Example**: ```bash curl -s "https://proxy.skuuy.com/api/proxies?protocol=socks5&country=US&limit=10" ``` - **API Response Structure**: ```json { "success": true, "total": 10, "proxies": [ { "ip": "198.51.100.24", "port": 1080, "protocol": "socks5", "country": "United States", "countryCode": "US", "anonymity": "elite", "latencyMs": 85, "lastChecked": "2026-10-09T17:30:00Z" } ] } ``` - **Export Formats**: `GET https://proxy.skuuy.com/api/export?format=clash|singbox|curl|python` --- ### 2.5 Skuuy DNS Propagation & DoH Matrix - **URL**: https://dns.skuuy.com - **Public API**: `GET https://dns.skuuy.com/api/resolve?name={DOMAIN}&type={TYPE}` - **Curl Example**: ```bash curl -s "https://dns.skuuy.com/api/resolve?name=skuuy.com&type=A" ``` - **API Response Structure**: ```json { "status": 0, "domain": "skuuy.com", "type": "A", "dnssec": true, "latencyMs": 14, "answers": [ { "name": "skuuy.com", "type": 1, "typeString": "A", "TTL": 300, "data": "104.21.48.1" } ] } ``` - **Features**: Supports A, AAAA, MX, TXT, CNAME, NS, SOA, PTR, SRV, CAA across Anycast DoH resolvers. --- ### 2.6 Skuuy Edge TCP Port Scanner - **URL**: https://ports.skuuy.com - **Public API**: - Single Port: `GET https://ports.skuuy.com/api/check?host={HOST}&port={PORT}` - Multi-Port: `GET https://ports.skuuy.com/api/scan?host={HOST}&ports=22,80,443,3306` - **Curl Example**: ```bash curl -s "https://ports.skuuy.com/api/check?host=1.1.1.1&port=53" ``` - **API Response Structure**: ```json { "open": true, "host": "1.1.1.1", "port": 53, "service": "DNS", "latencyMs": 12 } ``` - **Features**: Powered by native edge TCP sockets. RFC 1918 loopback protection prevents cloud edge SSRF abuse. --- ### 2.7 Skuuy Public APIs Directory & Health Matrix - **URL**: https://apis.skuuy.com - **Public API**: - Directory: `GET https://apis.skuuy.com/api/v1/apis?q=weather&auth=null&cors=yes` - Random: `GET https://apis.skuuy.com/api/v1/random` - Health Probe: `POST https://apis.skuuy.com/api/v1/probe` with JSON `{ "url": "https://api.publicapis.io/entries" }` - **Curl Example**: ```bash curl -s "https://apis.skuuy.com/api/v1/apis?limit=5" ``` - **API Response Structure**: ```json { "count": 1420, "entries": [ { "API": "Cat Facts", "Description": "Daily cat facts", "Auth": "", "HTTPS": true, "Cors": "yes", "Link": "https://catfact.ninja/", "Category": "Animals" } ] } ``` --- ### 2.8 Skuuy Read — URL to Markdown Reader - **URL**: https://read.skuuy.com - **Public API**: - Raw Markdown (Path Prefix): `GET https://read.skuuy.com/https://{URL}` - JSON API: `GET https://read.skuuy.com/api/read?url={URL}&format=json` - **Pricing & Quota**: Free tier: 100 reads/day; past quota: $0.001/read via x402 on Base. - **Curl Example**: ```bash curl -s "https://read.skuuy.com/https://skuuy.com" ``` - **JSON API Response Structure**: ```json { "ok": true, "url": "https://skuuy.com", "title": "Skuuy Tools", "description": "Free open-source privacy and network diagnostics suite", "length": 1420, "estimatedTokens": 355, "markdown": "# Skuuy Tools\n\n> URL: https://skuuy.com\n\n---\n\n1. [IP Intelligence](https://ip.skuuy.com)..." } ``` - **Features**: Converts public HTML into clean, token-efficient GFM Markdown. Automatically strips scripts, styles, cookie consent banners, and navigational noise for zero LLM prompt waste. --- ### 2.9 Skuuy Edge Speedtest - **URL**: https://speed.skuuy.com - **Features**: Pure client-side Web Worker speed test measuring download throughput, upload throughput, ping, and jitter directly against Anycast edge servers. --- ### 2.10 Skuuy File Drop & Ephemeral Paste - **URL**: https://file.skuuy.com - **Public API**: - Drop API: `POST https://file.skuuy.com/drop` (Converts base64/url to ephemeral download link) - Paste API: `POST https://file.skuuy.com/paste` (Creates secure, scriptless Markdown/code paste) - Direct Upload API: `POST https://file.skuuy.com/upload` (Binary/multipart upload) - **Pricing & Quota**: Free tier: 25 drops/pastes per day; past quota: $0.001/req via x402 on Base. --- ### 2.11 Skuuy Private RPC Relay - **URL**: https://rpc.skuuy.com - **Public API**: `POST https://rpc.skuuy.com/{chain}` (12 EVM chains supported: base, eth, arb, bnb, bera, polygon, op, avax, blast, etc.) - **Pricing & Quota**: Free tier: 2,500 calls/day/IP; past quota: $0.001/call via x402 on Base. --- ## 3. Model Context Protocol (MCP) Integration The Skuuy MCP Server provides native tool execution for LLM agents (Claude, Cursor, Cline, Antigravity, Gemini, OpenAI). It supports both **Streamable HTTP** (recommended for remote agents) and **Stdio CLI** (for local runners). - **Server Info**: `name: "skuuy-mcp"`, `version: "1.2.1"` - **Protocol Version**: `2024-11-05` - **Rate Limit**: 60 req/min/IP (Free tier, zero API keys required). - **Global Error Format**: JSON-RPC 2.0 (`-32602` Invalid params, `-32000` Rate limit exceeded, `-32001` Upstream failure). ### 3.1 Agent Configuration #### Option A: Streamable HTTP (Remote Serverless - Recommended) ```json { "mcpServers": { "skuuy": { "url": "https://mcp.skuuy.com/mcp" } } } ``` #### Option B: Stdio Local Process (npm / npx) ```json { "mcpServers": { "skuuy": { "command": "npx", "args": ["-y", "skuuy-mcp"] } } } ``` ### 3.2 Complete MCP Tool Registry (16 Tools) | Tool Name | Type | Description | Key Arguments | |:---|:---|:---|:---| | `skuuy_get_egress_ip` | Read-only | Returns the caller's public egress IP, geolocation, ASN, ISP, and proxy/datacenter detection. | None | | `skuuy_list_proxies` | Read-only | Lists tested-live public proxies across 150+ countries with freshness timestamp. | `protocol`, `country`, `anonymity` (L1/L2/L3), `max_latency_ms`, `only_tested`, `limit`, `offset` | | `skuuy_generate_totp` | Ephemeral | Generates RFC 6238 TOTP codes. In-memory WebCrypto execution, zero server logging. | `secret` (Base32), `digits` (6-8), `period` (30), `algorithm` (SHA1/SHA256/SHA512) | | `skuuy_create_temp_inbox` | Resource | Creates an ephemeral disposable email inbox. | `prefix` (optional), `ttl_minutes` (1-120, default 30) | | `skuuy_read_inbox` | Read-only | Reads incoming emails from a temporary inbox with automatic regex extraction of OTPs & action links. | `inbox_id`, `limit`, `offset` | | `skuuy_resolve_dns` | Read-only | Queries DNS records via Anycast DoH with DNSSEC validation and multi-location propagation. | `domain`, `types` (A, AAAA, MX, TXT, CNAME, NS, PTR, SRV, CAA), `locations` (max 10) | | `skuuy_check_ports` | Read-only | Safe TCP exposure audit. Strictly allowlisted ports only: [22, 80, 443, 3306, 5432, 6379, 51820]. | `host`, `ports` (array), `timeout_ms` (max 3000) | | `skuuy_check_security_headers` | Read-only | Audits HTTP security headers (HSTS, CSP, X-Frame-Options, Permissions-Policy) and TLS details. | `url`, `follow_redirects` (boolean) | | `skuuy_read_url` | Read-only | Converts public web pages into clean, token-efficient Markdown. Best-effort DOM cleanup, zero logs. | `url`, `include_links`, `max_length` | | `skuuy_create_webhook_bin` | Resource | Creates a temporary HTTP request inspection bin for capturing and debugging webhooks. | `ttl_minutes` (5-1440, default 60) | | `skuuy_get_bin_requests` | Read-only | Retrieves captured HTTP requests received by a webhook bin (method, headers, body, query). | `bin_id`, `limit`, `offset` | | `skuuy_hash_encode` | Stateless | Cryptographic hashing (SHA-256, SHA-512, MD5), Base64 encoding/decoding, UUIDv4, and secure passwords. | `operation`, `input`, `password_length`, `password_options` | | `skuuy_search_public_apis` | Read-only | Curated meta-directory of 1,400+ public developer APIs with category filter, auth requirements, and CORS. | `query`, `category`, `auth`, `cors`, `limit`, `offset` | | `skuuy_drop_file` | Resource | Ephemeral binary/base64 file sharing with configurable TTL (15m to 7d) and optional burn-after-reading. | `content_base64`, `filename`, `ttl`, `burn` | | `skuuy_paste` | Resource | Scriptless, XSS-safe Markdown or code paste sharing with configurable TTL (15m to 7d). | `content`, `title`, `ttl`, `burn` | | `skuuy_rpc` | Network | Private, no-log JSON-RPC relay across 12 EVM chains with automated failover and x402 metering. | `chain`, `method`, `params` | --- ## 4. Technical Engineering Guides & Whitepapers - **Proxies vs VPNs vs Tor**: OSI Layer comparisons (Layer 3 vs 5 vs 7), transport encapsulation (tun/tap vs socket), encryption trade-offs, and latency dynamics. Link: https://skuuy.com/guides/proxies-vs-vpns-vs-tor - **Understanding WebRTC STUN Leaks**: How browser media streaming APIs bypass proxy tunnels to broadcast public and local IPs, with browser configuration remedies. Link: https://skuuy.com/guides/understanding-webrtc-leaks - **The Cryptographic Mechanics of TOTP**: HMAC-SHA1 mathematical truncation, shared secret base32 decoding, and anti-replay protection. Link: https://skuuy.com/guides/cryptographic-mechanics-totp - **Subnetting & CIDR Guide**: Subnet bitmasks, wildcard masks, VLSM design, and broadcast address allocation. Link: https://skuuy.com/guides/subnetting-cidr-guide - **DNS Propagation & Resolution Mechanics**: Recursive vs iterative resolution, Anycast edge routing, TTL caches, and DNSSEC chain-of-trust validation. Link: https://skuuy.com/guides/dns-propagation-resolution - **TCP Port Probing & Network Firewalls**: SYN scans, TCP handshakes, stateful vs stateless packet inspection, and cloud edge egress limits. Link: https://skuuy.com/guides/tcp-port-probing-firewalls - **Public API Discovery & Reliability**: CORS preflight headers, authentication paradigms, token bucket rate limits, and health monitoring. Link: https://skuuy.com/guides/public-api-discovery-reliability --- ## 5. Site Navigation & Canonical Endpoints - Master Portal: https://skuuy.com/ - Tools Directory: https://skuuy.com/tools - Engineering Guides: https://skuuy.com/guides - Engineering & Architecture: https://skuuy.com/about - Feedback & Vulnerability Disclosure: https://skuuy.com/contact - Privacy Policy: https://skuuy.com/privacy-policy - Terms of Service: https://skuuy.com/terms-of-service - Legal Disclaimer: https://skuuy.com/disclaimer - Machine-Readable Summary: https://skuuy.com/llms.txt - Comprehensive Machine Reference: https://skuuy.com/llms-full.txt - Publisher ads.txt: https://skuuy.com/ads.txt - XML Sitemap: https://skuuy.com/sitemap.xml - Robots Specification: https://skuuy.com/robots.txt