1001Proxy - Proxy MCP Server for AI Agents

Usa Claude, OpenAI Cursor y cualquier agente de IA compatible con MCP para comprar y gestionar proxies usando lenguaje natural. No se necesitan integraciones personalizadas: simplemente conecta tu cliente al servidor y empieza a chatear.

Ver en 1001proxy.io

Documentación

Servidor MCP para Agentes de IA

Permite que Claude, GPT, Cursor y cualquier agente de IA compatible con MCP compren y gestionen proxies mediante lenguaje natural. Sin integraciones personalizadas: solo apunta tu cliente al servidor y empieza a conversar.

Ver Instalación

Funciona con:Claude DesktopClaude CodeCursorWindsurfCualquier cliente MCP

Resumen

Qué es MCP y por qué es importante para la automatización de proxies.

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los agentes de IA comunicarse con servicios externos a través de una interfaz estructurada de llamadas a herramientas. En lugar de construir integraciones frágiles basadas en prompts, MCP le da a tu agente de IA herramientas tipadas y documentadas que puede invocar con confianza.

El Servidor MCP de 1001Proxy conecta tu cliente de IA directamente con la infraestructura de proxies de 1001Proxy. El agente puede consultar tu saldo, explorar los tipos de proxies y países disponibles, calcular el precio de un pedido, realizarlo y recuperar credenciales, todo mediante conversación en lenguaje natural, sin código personalizado de tu parte.

Cero código de integración

Añade un bloque JSON a la configuración de tu cliente de IA y ya estás operativo.

Seguro por defecto

Las herramientas destructivas como create_order requieren confirmación explícita del usuario en el bucle del agente.

Ciclo de vida completo del proxy

12 herramientas que cubren compra, gestión, credenciales y facturación.

Inicio Rápido

Ponte en marcha en tres pasos.

Obtén tu clave de API

Inicia sesión en tu panel de 1001Proxy, navega a Configuración → Claves de API y crea una nueva clave. Cópiala: la necesitarás en el siguiente paso.

Instala el servidor MCP

Instala globalmente con npm, u omite la instalación por completo y usa npx (el servidor se descargará automáticamente).

npm install -g @1001proxy-mcp/server

Añade la configuración a tu cliente de IA

Abre tu archivo de configuración de Claude Desktop (claude_desktop_config.json) y añade el bloque del servidor a continuación. Reemplaza your_api_key_here con tu clave real.

{
  "mcpServers": {
    "1001proxy": {
      "command": "npx",
      "args": ["-y", "@1001proxy-mcp/server"],
      "env": {
        "PROXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Reinicia Claude Desktop. Las herramientas de 1001Proxy aparecerán automáticamente en la lista de herramientas.

Instalación

Múltiples opciones de instalación y referencia de variables de entorno.

Instalación global (npm)

npm install -g @1001proxy-mcp/server

Sin instalación (npx)

Usa npx -y para ejecutar la última versión sin instalar nada globalmente. Este es el enfoque recomendado para la mayoría de las configuraciones de clientes MCP.

npx -y @1001proxy-mcp/server

Variables de entorno

Variable	Obligatoria	Predeterminada	Descripción
PROXY_API_KEY	obligatoria	—	Tu clave de API de 1001Proxy.
PROXY_API_URL	opcional	https://api.1001proxy.io/api/v1	Sobrescribe la URL base de la API. Útil para entornos autoalojados o de prueba.

Configuración

Ejemplos de configuración para cada cliente MCP compatible.

Claude Desktop

Ubicación del archivo de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows).

{
  "mcpServers": {
    "1001proxy": {
      "command": "npx",
      "args": ["-y", "@1001proxy-mcp/server"],
      "env": {
        "PROXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

Añade el servidor desde tu terminal con el comando claude mcp add.

claude mcp add 1001proxy \
  --command "npx -y @1001proxy-mcp/server" \
  --env PROXY_API_KEY=your_api_key_here

Cursor

Abre la Configuración de Cursor, ve a Funciones → Servidores MCP y añade el siguiente JSON:

{
  "mcpServers": {
    "1001proxy": {
      "command": "npx",
      "args": ["-y", "@1001proxy-mcp/server"],
      "env": {
        "PROXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cliente MCP genérico

Cualquier cliente que siga la especificación MCP puede conectarse mediante stdio. Inicia el proceso del servidor y canaliza stdin/stdout:

PROXY_API_KEY=your_api_key_here npx -y @1001proxy-mcp/server

Herramientas Disponibles

12 herramientas que cubren el ciclo de vida completo del proxy, desde el descubrimiento hasta la recuperación de credenciales.

get_account

Cuenta

Recupera información de la cuenta y el saldo actual.

Parámetros: Ninguno

list_proxy_types

Referencia

Lista todos los tipos de proxies disponibles con precios actuales.

Parámetros: Ninguno

get_reference_data

Referencia

Obtén países, períodos de alquiler y tarifas para un tipo de proxy determinado.

Parámetros: type: ipv4 | ipv6 | mobile | isp | resident

calculate_order

Pedidos

Vista previa del costo total de un pedido antes de confirmarlo. No se descuenta saldo.

Parámetros: type, countryId, periodId, quantity, protocol, tarifId

create_order

Pedidos

Realiza un nuevo pedido de proxies. Descuenta tu saldo inmediatamente.

Parámetros: type, countryId, periodId, quantity, protocol, tarifId, idempotency_key

list_orders

Pedidos

Lista los pedidos existentes con filtros opcionales.

Parámetros: page, per_page, status, type

get_order

Pedidos

Recupera los detalles completos de un pedido específico.

Parámetros: order_id

get_proxies

Proxies

Obtén el host, puerto y credenciales del proxy para un pedido.

Parámetros: order_id

download_proxies

Proxies

Descarga la lista de proxies como archivo de texto plano o CSV.

Parámetros: order_id, format: txt | csv

extend_order

Pedidos

Extiende la duración de un pedido activo. Carga a tu saldo.

Parámetros: order_id, periodId

get_transactions

Cuenta

Recupera el historial de transacciones de tu saldo (depósitos, cargos, reembolsos).

Parámetros: page, per_page

get_deposit_addresses

Cuenta

Lista las direcciones de tu billetera de depósito en criptomonedas.

Parámetros: Ninguno

Ejemplos de Flujos de Trabajo

Cómo maneja un agente de IA tareas reales de proxies de principio a fin.

Flujo de trabajo 1 — "Compra 10 proxies de centro de datos en EE. UU."

Usuario

Cómprame 10 proxies de centro de datos en Estados Unidos por 30 días.

Llamando a get_reference_data para encontrar el ID de país de EE. UU. y el ID de período de 30 días para proxies IPv4.

get_reference_data({ type: "ipv4" })
→ countryId: 1 (United States), periodId: 3 (30 days)

Calculando el precio del pedido antes de confirmarlo.

calculate_order({
  type: "ipv4",
  countryId: 1,
  periodId: 3,
  quantity: 10,
  protocol: "http"
})
→ total: $3.00

Agente

10 proxies de centro de datos en EE. UU. (HTTP) por 30 días costarán $3.00. Tu saldo actual es de $45.20. ¿Procedo?

Usuario

Sí, adelante.

Realizando el pedido.

create_order({
  type: "ipv4",
  countryId: 1,
  periodId: 3,
  quantity: 10,
  protocol: "http",
  idempotency_key: "ord_20260406_001"
})
→ order_id: "ord_abc123", status: "active"

Pedido realizado. Obteniendo tus credenciales de proxy ahora.

get_proxies({ order_id: "ord_abc123" })
→ 10 proxies returned

Agente

¡Listo! Aquí tienes tus 10 proxies de EE. UU. (HTTP, 30 días, vence el 2026-05-06): user_abc:[email protected]:10001 user_abc:[email protected]:10002... (8 más)

Flujo de trabajo 2 — "Consulta mi saldo y lista los pedidos activos"

Usuario

¿Cuál es mi saldo y tengo algún pedido de proxy activo?

Obteniendo información de la cuenta y pedidos activos en paralelo.

get_account()          → balance: $42.20
list_orders({ status: "active", per_page: 10 })
  → 3 active orders returned

Agente

Tu saldo es de $42.20. Tienes 3 pedidos activos: • ord_abc123 — 10x IPv4 EE. UU. (vence el 2026-05-06) • ord_def456 — 5x IPv6 DE (vence el 2026-04-20) • ord_ghi789 — 2x Móvil Reino Unido (vence el 2026-04-15)

Flujo de trabajo 3 — "Descarga la lista de proxies del pedido ord_abc123"

Usuario

Descarga mi lista de proxies del pedido ord_abc123 como archivo de texto.

Llamando a download_proxies con formato txt.

download_proxies({ order_id: "ord_abc123", format: "txt" })
→ plain-text proxy list returned

Agente

Aquí tienes tu lista de proxies como texto plano (formato host:puerto:usuario:contraseña): us1.1001proxy.io:10001:user_abc:pass_xyz us1.1001proxy.io:10002:user_abc:pass_xyz... (8 más) Puedes pegarla directamente en la configuración de tu scraper o bot.

Solución de Problemas

Soluciones a los problemas más comunes.

Clave de API no configurada: las herramientas devuelven un error de autenticación

Asegúrate de que la variable de entorno PROXY_API_KEY esté configurada en tu cliente MCP. En Claude Desktop, verifica que el bloque "env" en claude_desktop_config.json contenga tu clave y reinicia la aplicación. El servidor rechazará todas las solicitudes si la variable falta o está vacía.

# Verify the variable is set before running
echo $PROXY_API_KEY

# Or pass it inline for a quick test
PROXY_API_KEY=sk_live_... npx -y @1001proxy-mcp/server

Conexión rechazada / servidor no encontrado

Confirma que Node.js 18+ esté instalado y disponible en tu PATH. El comando npx debe poder acceder al registro npm para descargar el paquete en la primera ejecución. Verifica tu red o la configuración del proxy corporativo si estás detrás de un firewall.

# Check Node.js version (18+ required)
node --version

# Confirm npx works
npx --version

La API de 1001Proxy aplica límites de velocidad por minuto. Si tu agente llama a las herramientas en un bucle cerrado, añade una breve pausa entre llamadas o reduce la frecuencia. El servidor MCP mostrará el estado 429 en el resultado de la herramienta para que el agente pueda retroceder automáticamente.

# The server returns structured error results:
{
  "error": "rate_limited",
  "message": "Too many requests. Retry after 10s.",
  "retryAfter": 10
}

Saldo insuficiente (402 en create_order)

El saldo de tu cuenta es demasiado bajo para el pedido solicitado. Usa get_account para consultar tu saldo actual, luego deposita fondos mediante get_deposit_addresses y envía criptomonedas a la dirección de billetera devuelta.

¿Listo para conectar tu agente de IA?

Crea tu cuenta, carga tu saldo y ten un agente de IA comprando proxies en menos de cinco minutos.