BorrowIP MCP Server
Allows Hermes AI agents to use the BorrowIP MCP server for routing traffic through a mobile IP, providing tools for status checks, proxy retrieval, and URL fetching.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BorrowIP MCP Server fetch https://example.com using key BIP-a1b2c3"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BorrowIP š”
Borrow mobile IP for AI agents ā route traffic through your phone's cellular connection via SSH reverse tunnel.
Zero infrastructure. Uses existing SSH (port 22). Works with any MCP-compatible AI agent.
How it works
š± Phone (Termux) š„ļø VPS š¤ AI Agent
āāāāāāāāāāāāāāāā āāāāāāāāā āāāāāāāāāā
borrowip connect borrowip-mcp Hermes/Claude
BIP-xxxx@vps-ip (auto-started) ā
ā ā borrowip_fetch()
āāā SSH :22 āāāāāāāāāāāāāāā SSH :22 ā
ā pproxy :1080 SOCKS5 :10001 ā cellular IP
āāā cellular āāā internet āāāāRelated MCP server: @proxies-sx/mcp-server
Quick Start
1. VPS: Install & configure AI agent
git clone https://github.com/wahyuzero/borrowip
cd borrowip && pip install -e .Add to your AI agent config (e.g. Hermes config.yaml):
mcp_servers:
borrowip:
command: borrowip-mcpWhen AI agent starts, ask: "check borrowip status" ā shows your pair code.
2. Phone (Termux): Install & connect
# Install
curl -sL https://raw.githubusercontent.com/wahyuzero/borrowip/main/scripts/install-termux.sh | bash
# Setup (first time only) ā choose key or password auth
borrowip init
# Connect using pair code from VPS
borrowip connect BIP-xxxxxx@your-vps-ip3. Done!
"Fetch https://example.com using borrowip key BIP-xxxxxx"AI agent routes traffic through your phone's cellular IP automatically.
For AI Agents (LLM)
See LLM_GUIDE.md for a complete reference written for AI agents.
Quick summary of the 3-step workflow:
borrowip_status()ā check what's connectedborrowip_get_proxy()ā get thesocks5://URLborrowip_fetch(url)orbrowser_launch(proxy=<url>)ā use the proxy
MCP Tools
Tool | Returns | Description |
| Text | Pair code + connected proxies with ports/IPs/alive status. Run first. |
|
| Ready-to-use proxy URL. Use with browser tools. |
| HTML/text | Fetch a URL through mobile proxy. |
|
| Fast 3s liveness test. Use when fetch fails. |
| IP address | Phone's external cellular IP. |
| Text | List all proxies with details. |
Architecture
MCP Server (
borrowip-mcp): Runs on VPS, auto-started by AI agent via stdio. Generates pair code, manages proxy connections.Client (
borrowip connect): Runs on Termux. Starts local SOCKS5 proxy (pproxy), creates SSH reverse tunnel, registers with pair code.
All traffic flows through SSH port 22 ā no extra firewall rules.
Requirements
VPS: Python 3.10+, SSH on port 22, AI agent with MCP support (Hermes, Claude, Cursor, etc.)
Phone: Android + Termux, Python 3.10+, pproxy (pip install pproxy), SSH access to VPS (key or password)
Installation
VPS
git clone https://github.com/wahyuzero/borrowip
cd borrowip && pip install -e .Termux
# Quick install
curl -sL https://raw.githubusercontent.com/wahyuzero/borrowip/main/scripts/install-termux.sh | bash
# Or manual
pkg install openssh python
pip install pproxy
git clone https://github.com/wahyuzero/borrowip
cd borrowip && pip install -e ".[client]"Configuration
VPS (Hermes config.yaml)
mcp_servers:
borrowip:
command: borrowip-mcpTermux (~/.borrowip.toml)
Created by borrowip init. Supports two auth methods:
Key auth:
[server]
host = "your-vps-ip"
user = "your-ssh-user"
ssh_key = "~/.ssh/id_ed25519"Password auth:
[server]
host = "your-vps-ip"
user = "your-ssh-user"
ssh_password = "your-password"Then just run borrowip connect (reads config automatically).
Auto-start (Termux)
# Install Termux:Boot from F-Droid
mkdir -p ~/.termux/boot/
echo 'borrowip connect &' > ~/.termux/boot/start-borrowip.sh
chmod +x ~/.termux/boot/start-borrowip.shTunnel auto-reconnects on drop.
Security
SSH key or password auth
Pair code = identifier only; SSH credentials are the real auth
All traffic encrypted via SSH
SOCKS proxy bound to 127.0.0.1 only (not exposed to WiFi)
Pair code validated (prevents shell injection)
License
MIT
Available Tools
6 toolsborrowip_check_ipA
Check the external IP address of the mobile proxy.
Useful to verify the proxy is working and see which IP/cellular network is being used.
Args: key: Optional connection code. If omitted, uses first available proxy.
Inputs: key. Returns: result
borrowip_fetchA
Fetch a URL through the mobile proxy.
Use when a website blocks your server/VPS IP (Cloudflare, rate limits, geo-blocks). The request goes through the phone's cellular connection instead.
Args: url: The URL to fetch key: Optional connection code. If omitted, uses first available proxy.
Inputs: url (required), key. Returns: result
borrowip_get_proxyA
Get a ready-to-use SOCKS5 proxy URL.
Returns the proxy URL string directly (e.g. 'socks5://127.0.0.1:10002'). Use this URL with any tool that accepts a proxy parameter:
CloakBrowser: browser_launch(proxy='socks5://127.0.0.1:10002')
curl: curl --socks5-hostname 127.0.0.1:10002
requests: requests.get(url, proxies={'https': 'socks5h://127.0.0.1:10002'})
Args: key: Optional connection code (e.g. BIP-xxxxxx). If omitted, uses first available.
Inputs: key. Returns: result
borrowip_health_checkA
Quick liveness check ā is the proxy tunnel actually working?
Tests if the SOCKS5 port is open AND can reach the internet. Much faster than borrowip_fetch (3s timeout vs 30s).
Args: key: Optional connection code. If omitted, checks first available proxy.
Inputs: key. Returns: result
borrowip_list_proxiesA
List all connected mobile proxies with details.
Returns one line per proxy: code, SOCKS5 URL, IP, age, alive status.
Inputs: no named parameters. Returns: result
borrowip_statusA
Check BorrowIP status. ALWAYS run this first.
Returns the pair code (for connecting a phone) and lists connected proxies with their SOCKS5 ports.
Example output: BorrowIP Status Pair code: BIP-ab12cd Proxies: 1 connected BIP-xw9su6 | socks5://127.0.0.1:10002 | IP: 140.213.141.84 | alive
If no proxies: tells you the exact Termux command to run.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 6 tools
Each tool has a distinct purpose: checking IP, fetching, getting proxy URL, health check, listing, and status. No two tools perform the same function, making it clear for an agent which tool to use.
All tools start with 'borrowip_', but the suffix patterns vary: verb_noun (check_ip, get_proxy, list_proxies), verb only (fetch), noun (status), and compound noun (health_check). This inconsistency could confuse an agent slightly.
With 6 tools, the set is well-scoped for a proxy management server. Each tool serves a necessary function without being too few or too many.
The tools cover core proxy workflows: connecting (via status), listing, validating (check_ip, health_check), and using (fetch, get_proxy). Missing a dedicated disconnect tool is a minor gap but agents can work around it.
Maintenance
Related MCP Connectors
Control dedicated 4G mobile and residential proxies on mobileproxy.space from AI agents.
Proxy-rotated web scraping and cross-platform intelligence for AI agents.
Residential and mobile proxies and Private modems for AI agents: proxy URLs, stock, rotation, top-up
Mobile proxies, non-VoIP SMS verifications, dedicated numbers, and global eSIMs for AI agents.
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceEnables AI agents to route HTTP requests through millions of real residential IPs, bypassing anti-bot systems and geo-targeting by country or city.4MIT- AlicenseAqualityCmaintenanceEnables AI agents to autonomously buy and operate mobile proxies via MCP, supporting both API key and on-chain USDC payments for tasks like port creation, IP rotation, and traffic management.44211 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables agents to autonomously route traffic through real 4G/5G mobile and residential IPs by country, with tools to check live proxy stock, obtain ready-to-use proxy URLs, and monitor remaining data usage.51 npmMIT
- AlicenseNot gradedqualityDmaintenanceRoutes AI agent HTTP requests through residential proxies to bypass anti-bot systems, geo-target by country/city, and maintain sticky sessions across multi-step workflows.15 npm1MIT