ProxySEO MCP Server

Español | English

---

Español

Servidor MCP (Model Context Protocol) para tu servicio de proxies ProxySEO. Permite a Claude Desktop, Claude Code y cualquier cliente MCP consultar y usar tus proxies directamente desde el asistente.

Tools disponibles

Tool	Descripción
get_proxy	Devuelve un proxy listo para usar (URL http://user:pass@ip:puerto o JSON)
list_proxies	Lista todas las IPs asignadas a tu servicio (simple o detailed)
proxy_status	Estado del servicio: plan, nº de IPs, puertos, tipo de auth
check_proxy	Comprueba conectividad y anonimato a través del proxy

Todas las tools son de solo lectura sobre tu propio servicio. La API key identifica tu servicio: no necesitas configurar ningún ID.

Instalación

Descarga el binario para tu plataforma desde la última release. Por ejemplo, en Linux/macOS:

# Linux (amd64) — cambia el sufijo por tu plataforma:
# proxy-mcp-linux-arm64 · proxy-mcp-darwin-amd64 · proxy-mcp-darwin-arm64 · proxy-mcp-windows-amd64.exe
curl -L -o proxy-mcp https://github.com/juliobrasa/proxyseo-mcp/releases/latest/download/proxy-mcp-linux-amd64
chmod +x proxy-mcp
sudo mv proxy-mcp /usr/local/bin/proxy-mcp

Genera tu API key desde el panel de cliente de ProxySEO (sección «Acceso para agentes IA»). Se muestra una sola vez: guárdala en un gestor de contraseñas.

Configuración en Claude Desktop / Claude Code

Añade a tu claude_desktop_config.json (Desktop) o .mcp.json (Claude Code):

{
  "mcpServers": {
    "proxyseo": {
      "command": "/usr/local/bin/proxy-mcp",
      "env": {
        "PROXYSEO_API_KEY": "tu-api-key-aqui"
      }
    }
  }
}

Variables de entorno

Variable	Obligatoria	Default	Descripción
PROXYSEO_API_KEY	Sí	—	API key de tu servicio (64 caracteres hex)
PROXYSEO_API_URL	No	https://api.proxyseo.es	URL base de la API

Ejemplo de uso

En Claude, simplemente pide:

«Dame un proxy en formato URL para usar con curl»

Claude llamará a get_proxy y devolverá algo como:

http://usuario:contraseña@185.x.x.x:58542

«¿Cuántas IPs tiene mi servicio y están funcionando?»

Claude combinará proxy_status y check_proxy.

Troubleshooting

Síntoma	Causa	Solución
ERROR: PROXYSEO_API_KEY environment variable is required	Falta la variable	Añádela al bloque env del config MCP
unauthorized: invalid or revoked API key	Key incorrecta o revocada	Verifica la key; pide una nueva si fue revocada
rate limit exceeded (60 req/min)	Demasiadas llamadas	Espera 1 minuto; el límite es por key
service not found or inactive	Servicio suspendido/cancelado	Revisa el estado de tu servicio en el panel
El server no aparece en Claude	Ruta del binario incorrecta	Usa ruta absoluta en command y reinicia Claude

---

English

MCP (Model Context Protocol) server for your ProxySEO proxy service. Lets Claude Desktop, Claude Code and any MCP client query and use your proxies directly from the assistant.

Available tools

Tool	Description
get_proxy	Returns a ready-to-use proxy (URL http://user:pass@ip:port or JSON)
list_proxies	Lists all IPs assigned to your service (simple or detailed)
proxy_status	Service status: plan, IP count, ports, auth type
check_proxy	Checks connectivity and anonymity through the proxy

All tools are read-only over your own service. The API key identifies your service: no service ID configuration needed.

Installation

Download the binary for your platform from the latest release. On Linux/macOS:

# Linux (amd64) — swap the suffix for your platform:
# proxy-mcp-linux-arm64 · proxy-mcp-darwin-amd64 · proxy-mcp-darwin-arm64 · proxy-mcp-windows-amd64.exe
curl -L -o proxy-mcp https://github.com/juliobrasa/proxyseo-mcp/releases/latest/download/proxy-mcp-linux-amd64
chmod +x proxy-mcp
sudo mv proxy-mcp /usr/local/bin/proxy-mcp

Generate your API key from the ProxySEO client panel ("AI agent access" section). It is shown only once: store it in a password manager.

Claude Desktop / Claude Code configuration

Add to your claude_desktop_config.json (Desktop) or .mcp.json (Claude Code):

{
  "mcpServers": {
    "proxyseo": {
      "command": "/usr/local/bin/proxy-mcp",
      "env": {
        "PROXYSEO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment variables

Variable	Required	Default	Description
PROXYSEO_API_KEY	Yes	—	Your service API key (64 hex characters)
PROXYSEO_API_URL	No	https://api.proxyseo.es	API base URL

Usage example

In Claude, just ask:

"Give me a proxy URL to use with curl"

Claude will call get_proxy and return something like:

http://user:password@185.x.x.x:58542

"How many IPs does my service have and are they working?"

Claude will combine proxy_status and check_proxy.

Troubleshooting

Symptom	Cause	Fix
ERROR: PROXYSEO_API_KEY environment variable is required	Missing variable	Add it to the env block of your MCP config
unauthorized: invalid or revoked API key	Wrong or revoked key	Verify the key; request a new one if revoked
rate limit exceeded (60 req/min)	Too many calls	Wait 1 minute; the limit is per key
service not found or inactive	Service suspended/cancelled	Check your service status in the panel
Server not showing up in Claude	Wrong binary path	Use an absolute path in command and restart Claude

Build from source

make mcp   # produces bin/proxy-mcp (linux-amd64) and bin/proxy-mcp-darwin-arm64