@proxies-sx/mcp-proxy-tester

MCP Server for AI agents to test proxies via natural language. Test any HTTP, HTTPS, or SOCKS5 proxy for connectivity, DNS leaks, anonymity, speed, and more.

Features

• 3 Powerful Tools - One master tester + specialized DNS leak & fingerprint tests
• Smart Auto-Detection - Detects SOCKS5 from format (socks5://) or port (1080) automatically
• Bulk Testing - Test up to 10 proxies simultaneously
• Works with ANY proxy - Not limited to PROXIES.SX
• AI-Native - Designed for Claude, Cursor, Cline, and other MCP clients

Installation

npx @proxies-sx/mcp-proxy-tester

Or install globally:

npm install -g @proxies-sx/mcp-proxy-tester

Configuration

Claude Code / Cursor

Add to your .mcp.json or .cursor/mcp.json:

{
  "mcpServers": {
    "proxy-tester": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-proxy-tester"],
      "env": {
        "PROXY_TESTER_API_KEY": "ptx_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "proxy-tester": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-proxy-tester"],
      "env": {
        "PROXY_TESTER_API_KEY": "ptx_your_api_key_here"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | test_proxy | Universal proxy tester. Auto-detects HTTP/SOCKS5, runs UDP tests for SOCKS5 automatically. Supports bulk testing (up to 10 proxies). | | test_dns_leak | DNS leak detection. Tests TCP and UDP DNS to ensure your real DNS isn't exposed. | | test_p0f | P0F OS fingerprinting. Checks if your real operating system is being leaked through TCP/IP stack analysis. |

Example Usage

Test a single proxy (auto-detect type)

User: Test this proxy: 192.168.1.1:8080:admin:password

AI: ✅ **Proxy Working**

**Proxy:** `192.168.1.1:8080:***:***`
**Type:** HTTP (auto-detected)
**Tests:** 5/5 passed
**Duration:** 1250ms

**Connectivity:**
  HTTP:  ✓ 45.123.xxx.xxx
  HTTPS: ✓ 45.123.xxx.xxx

**Latency:**
  HTTP:  156ms
  HTTPS: 189ms
  RTT:   45ms

Test a SOCKS5 proxy (UDP auto-included)

User: Test socks5://proxy.example.com:1080:user:pass

AI: ✅ **Proxy Working**

**Proxy:** `proxy.example.com:1080:***:***`
**Type:** SOCKS5 (auto-detected)
**Tests:** 8/8 passed

**Connectivity:**
  HTTP:  ✓ 203.45.xxx.xxx
  HTTPS: ✓ 203.45.xxx.xxx

**SOCKS5 UDP:**
  UDP:    ✓ Supported
  UDP IP: ✓ 203.45.xxx.xxx

**Latency:**
  HTTP:  89ms
  HTTPS: 112ms
  RTT:   23ms

Check for DNS leaks

User: Does this proxy leak DNS? socks5://proxy.example.com:1080

AI: ✅ **NO DNS LEAK**

**Proxy:** `proxy.example.com:1080`

**TCP DNS:** ✓ Safe
  Cloudflare (172.69.xxx.xxx)

**UDP DNS:** ✓ Safe
  Cloudflare (172.69.xxx.xxx)

Your DNS requests are properly routed through the proxy.

Bulk test proxies

User: Test these 5 proxies and tell me which work

AI: **Bulk Proxy Test Results**

1. ✅ `proxy1.com:8080` (HTTP) - 5/5 passed
2. ❌ `proxy2.com:8080` (HTTP) - All tests failed
3. ⚠️ `proxy3.com:1080` (SOCKS5) - 6/8 passed
4. ✅ `proxy4.com:8080` (HTTP) - 5/5 passed
5. ❌ `proxy5.com:8080` (HTTP) - Connection timeout

**Summary:** 2 working, 1 partial, 2 dead

Check OS fingerprint anonymity

User: Check if this proxy leaks my OS fingerprint

AI: **P0F Fingerprint Analysis**

**Proxy:** `proxy.example.com:8080`
**Proxy IP:** 45.123.xxx.xxx

**IPv4 Fingerprint:**
  ✓ Linux 3.11+ (generic)

**Anonymity Assessment:**
✓ OS fingerprint appears normal/masked. Good anonymity.

Test Modes

The test_proxy tool supports different modes:

| Mode | Description | Tests Run | |------|-------------|-----------| | auto | Smart detection based on proxy type (default) | HTTP/HTTPS + Speed. Adds UDP for SOCKS5 | | quick | Fast connectivity check | HTTP/HTTPS + Speed only | | full | Comprehensive testing | Everything including IPv6 | | ipv6 | IPv6 only | HTTP/HTTPS over IPv6 |

Supported Proxy Formats

host:port                     # HTTP (auto-detected)
host:port:user:pass           # HTTP with auth
http://host:port              # Explicit HTTP
http://user:pass@host:port    # HTTP with auth
socks5://host:port            # SOCKS5 (auto-runs UDP tests)
socks5://user:pass@host:port  # SOCKS5 with auth

Auto-Detection: Proxies are detected as SOCKS5 if:

• URL starts with socks5:// or socks://
• Port is 1080, 1081, 9050, or 9051

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PROXY_TESTER_API_KEY | Yes | API key from proxies.sx | | PROXY_TESTER_API_URL | No | Custom API endpoint |

Rate Limits

| Tier | Tests/Hour | Price | |------|------------|-------| | Free | 10 | $0 | | Basic | 100 | $9.99/mo | | Pro | 1,000 | $29.99/mo | | Enterprise | Unlimited | Custom |

Get your API key at: https://proxies.sx/mcp/tester

Links

• Website: https://proxies.sx/mcp/tester
• Documentation: https://proxies.sx/docs/mcp-tester
• API Reference: https://api.proxies.sx/docs
• Support: [email protected]

License

MIT License - see LICENSE

Built by PROXIES.SX - Premium 4G/5G Mobile Proxies