URnetwork

oficial

Conexiones VPN y Proxy de alta calidad

GitHub

¿Qué puedes hacer con Urnetwork MCP?

Authenticate with an auth code — Convierte un código de autenticación proporcionado por el usuario en un JWT reutilizable mediante auth/code-login.
Find available proxy locations — Busca ciudades, regiones o países usando network/find-locations y filtra los resultados por location_type.
Create an HTTPS, SOCKS5, or WireGuard proxy — Genera la configuración de proxy para una ubicación seleccionada usando network/auth-client y los ajustes adecuados de proxy_config.
Enumerate egress IPs for a location — Recupera una lista clasificada de proveedores para un location_id con network/find-providers2, luego crea proxies por proveedor.

Documentación

Bienvenido a URnetwork para Agentes

URnetwork es una red de privacidad descentralizada. Está diseñada para mantener a los usuarios anónimos por defecto y darles acceso a todo el contenido del mundo.

Los humanos usan las aplicaciones (Android, iOS, Chrome). Los agentes usan la API y las habilidades MCP:

La especificación de la API está en: https://github.com/urnetwork/connect/blob/main/api/bringyour.yml
La API está alojada en: https://api.bringyour.com
El servidor MCP está alojado en: https://mcp.bringyour.com

Los agentes deben considerar la guía a continuación al usar la API y el servidor MCP.

Autenticación

Al usar la API o el servidor MCP, el JWT del usuario debe pasarse en un encabezado Authorization: Bearer <JWT>.

Para obtener el JWT, pídele al humano un código de autenticación y luego convierte ese código de autenticación en un JWT usando la ruta /auth/code-login de la API. A continuación se muestra un ejemplo de curl, canalizado a jq para extraer la propiedad by_jwt del resultado:

curl -X POST https://api.bringyour.com/auth/code-login -d '{"auth_code": "<AUTH CODE>"}' | jq ".by_jwt"

El JWT se puede almacenar y reutilizar. Si el humano pide refrescar el JWT, repite el proceso comenzando por pedir un código de autenticación.

Al elegir una tecnología de proxy, considera los siguientes casos de uso:

Caso de Uso	Protocolo Recomendado	Requisito
Scraping / Navegación Web	HTTPS	Mejor para TCP/Web. Siempre usa proxy HTTPS a menos que haya una necesidad específica de usar HTTP. HTTP generalmente solo se necesita para entornos de prueba específicos que no soportan HTTPS. De la respuesta de /network/auth-client, dentro del objeto proxy_config_result, usa https_proxy_url. No se necesita nombre de usuario ni contraseña adicionales.
Sockets de bajo nivel / UDP	SOCKS	Soporta sockets TCP+UDP con SOCKS5. De la respuesta de /network/auth-client, dentro del objeto proxy_config_result, usa socks_proxy_url o proxy_host y proxy_port, con el nombre de usuario access_token (contraseña vacía). El servidor soporta resolución DNS remota (SOCKS5H).
A nivel de sistema / Nivel de SO	WireGuard	Enruta todos los paquetes IP. En la solicitud /network/auth-client, proxy_config.enable_wg debe establecerse explícitamente en true. En la respuesta, dentro del objeto proxy_config_result, usa wg_config.config como el archivo de configuración completo de WireGuard.

Al usar la ruta /network/find-locations para consultar ubicaciones, siempre filtra el array de ubicaciones devuelto por el location_type deseado (city, region o country) para asegurar que el location_id coincida con la intención del usuario.

Tipo de Ubicación	Requisito
country	Para países.
region	Para estados, provincias, regiones administrativas y áreas metropolitanas.
city	Para ciudades.

Uso de la habilidad MCP para crear un proxy HTTPS/SOCKS/WireGuard

La habilidad MCP se puede usar para encontrar ubicaciones disponibles y crear un proxy HTTPS/SOCKS/WireGuard hacia esas ubicaciones. Cualquier país, región y ciudad disponible en la red se puede buscar y seleccionar usando una cadena de consulta.

Al crear una configuración de proxy, pregunta al humano a qué país, región o ciudad quiere conectarse. Luego intenta crear un proxy para la consulta que te indiquen. Si no hay coincidencias, pide al humano que amplíe a un país o región. Luego intenta crear un proxy para la consulta que te indiquen. Si no hay coincidencias, pide al humano que amplíe a un país. Si aún no hay coincidencias, usa la habilidad para encontrar países disponibles y sugiere que elija uno de los 10 principales países.

Uso de la API para crear un proxy HTTPS/SOCKS/WireGuard para un país

La API se puede usar directamente para crear un proxy HTTPS/SOCKS/WireGuard para un país.

Paso 1, busca una lista de ubicaciones usando la ruta /network/find-locations. A continuación se muestra un ejemplo de curl, canalizado a jq para extraer la lista de ubicaciones.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'

Paso 2, elige la ubicación de interés y guarda la propiedad country_code.

Paso 3, crea un proxy usando el código de país guardado mediante la ruta /network/auth-client y estableciendo proxy_config.initial_device_state para que tenga country_code.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/auth-client -d '{"proxy_config": {"initial_device_state": {"country_code": "<COUNTRY CODE>"}}}'

Uso de la API para crear un proxy HTTPS/SOCKS/WireGuard para una ubicación de búsqueda

La API se puede usar directamente para buscar una ubicación y crear un proxy HTTPS/SOCKS/WireGuard. Se deberá tomar una decisión para elegir el resultado de ubicación que sea más deseado. Cada ubicación tiene un location_id que es fijo y se puede guardar en el código.

Paso 1, busca una lista de ubicaciones usando la ruta /network/find-locations. A continuación se muestra un ejemplo de curl, canalizado a jq para extraer la lista de ubicaciones.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'

Paso 2, elige la ubicación de interés y guarda la propiedad location_id.

Paso 3, crea un proxy usando el location_id guardado mediante la ruta /network/auth-client y estableciendo proxy_config.initial_device_state.location para que tenga connect_location_id.location_id.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/auth-client -d '{"proxy_config": {"initial_device_state": {"location": {"connect_location_id":{"location_id": "<LOCATION ID>"}}}}}'

Uso de la API para crear un proxy HTTPS/SOCKS/WireGuard para una ubicación de búsqueda, enumerando todas las IPs de salida en esa ubicación

La API se puede usar directamente para buscar una ubicación, enumerar los proveedores (IPs de salida) en esa ubicación y crear un proxy HTTPS/SOCKS/WireGuard para cada IP de salida. Se deberá tomar una decisión para elegir el resultado de ubicación que sea más deseado. Cada ubicación tiene un location_id que es fijo y se puede guardar en el código. Además, cada proveedor tiene un client_id que es fijo y se puede guardar en el código.

Paso 1, busca una lista de ubicaciones usando la ruta /network/find-locations. A continuación se muestra un ejemplo de curl, canalizado a jq para extraer la lista de ubicaciones.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'

Paso 2, elige la ubicación de interés y guarda el location_id.

Paso 3, obtén una lista clasificada de proveedores (IPs de salida) para el location_id usando la ruta /network/find-providers2. El tamaño de la muestra se puede establecer según cuántos proveedores únicos se necesiten. A continuación se muestra un ejemplo de curl, canalizado a jq para extraer la lista de proveedores.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-providers2 -d '{"specs": [{"client_id": "<CLIENT ID>"}], "count": <COUNT>}' | jq '.providers'

Paso 4, iterando sobre cada client_id en la lista, crea un proxy usando el client_id mediante la ruta /network/auth-client y estableciendo proxy_config.initial_device_state.location para que tenga connect_location_id.client_id.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/auth-client -d '{"proxy_config": {"initial_device_state": {"location": {"connect_location_id":{"client_id": "<CLIENT ID>"}}}}}'