@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

``bash
npx @proxies-sx/mcp-proxy-tester
`

Or install globally:

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

Configuration

$3

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

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

$3

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

`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

$3

`
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
`

$3

`
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
`

$3

`
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.
`

$3

`
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
`

$3

`
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: support@proxies.sx

License

MIT License - see LICENSE

---

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