Server data from the Official MCP Registry
NodeMaven residential proxies: geo-targeted proxy URLs, sticky sessions, checks and usage
About
NodeMaven residential proxies: geo-targeted proxy URLs, sticky sessions, checks and usage
Security Report
Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
6 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: NODEMAVEN_APIKEY
Environment variable: NODEMAVEN_MCP_ALLOW_WRITE
Environment variable: NODEMAVEN_MCP_REVEAL_PASSWORD
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-nodemaven-nodemaven-mcp": {
"env": {
"NODEMAVEN_APIKEY": "your-nodemaven-apikey-here",
"NODEMAVEN_MCP_ALLOW_WRITE": "your-nodemaven-mcp-allow-write-here",
"NODEMAVEN_MCP_REVEAL_PASSWORD": "your-nodemaven-mcp-reveal-password-here"
},
"args": [
"nodemaven-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
nodemaven-mcp
An MCP server for NodeMaven residential proxies. It lets an AI assistant build proxy strings with geo-targeting and sticky sessions, check that a proxy connects and where it exits, test it against a site, look up locations, read traffic usage, and manage sub-users and whitelisted IPs.
Read-only by default: the tools that change the account refuse to run until you allow writes.
Tools
| Tool | What it does |
|---|---|
proxy_url | Proxy string for a country, region, city or ISP, with an optional sticky session and its lifetime. Residential or mobile IPs, HTTP or SOCKS5. |
check_proxy | Opens one connection through the proxy and returns the status, the exit IP and the time it took. Residential or mobile. |
test_proxy_on_site | Requests one page of a site through the proxy and reports the status, size, time, and whether it looks blocked (403, 429, captcha or challenge page). Residential or mobile. The page is not returned. |
list_locations | Countries, regions, cities and ISPs available for targeting, with the codes proxy_url takes. |
account_status | Remaining traffic, subscription status, whether traffic is frozen. |
traffic_stats | Traffic used over time. |
top_domains | Domains reached through the proxy, with traffic per domain. |
list_sub_users | Sub-users with their usage and limits. |
list_whitelist_ips | IP addresses allowed to use the proxy without a password. |
These change the account and work only with NODEMAVEN_MCP_ALLOW_WRITE=1:
| Tool | What it does |
|---|---|
create_sub_user | New sub-user with its own proxy login and an optional traffic limit. The password is generated by the server. |
update_sub_user | Change a sub-user's traffic limit, or turn the limit on or off. |
reset_sub_user_usage | Set the recorded traffic of sub-users back to zero. |
delete_sub_user | Delete a sub-user. |
add_whitelist_ip | Allow an IP address to use the proxy without a password, with its number of ports and optional targeting. |
remove_whitelist_ip | Remove an address from the whitelist. |
The server has no tools for payments, plans or API keys.
Setup
You need an API key from the NodeMaven dashboard. The proxy username and password are read from the account through that key, so nothing else is required.
[!TIP] 🎁 2 GB of free traffic. No account yet? Sign up and enter the code GITHUB. Once per account.
Claude Desktop (claude_desktop_config.json), Cursor and other MCP clients:
{
"mcpServers": {
"nodemaven": {
"command": "uvx",
"args": ["nodemaven-mcp"],
"env": { "NODEMAVEN_APIKEY": "your-api-key" }
}
}
}
Without uv: pip install nodemaven-mcp and use "command": "nodemaven-mcp".
| Variable | |
|---|---|
NODEMAVEN_APIKEY | Required. |
NODEMAVEN_LOGIN, NODEMAVEN_PASSWORD | Optional. Proxy credentials to use instead of the account's own, e.g. a sub-user. |
NODEMAVEN_MCP_ALLOW_WRITE | 1 allows the tools that change the account. Off by default. |
NODEMAVEN_MCP_REVEAL_PASSWORD | 1 puts real passwords into proxy_url and create_sub_user output. Off by default. |
Credentials
Tool results go into the model's context and usually into the chat history, so the server keeps secrets out of them:
proxy_urlandcreate_sub_userreturn the password as<PROXY_PASSWORD>unlessNODEMAVEN_MCP_REVEAL_PASSWORD=1is set.- API responses are reduced to a fixed list of fields; proxy passwords and the account email are never returned.
test_proxy_on_sitereturns no page content, and removes the proxy password from connection errors.
Development
uv sync
uv run pytest
Built on the nodemaven Python SDK.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Lharries · Communication
Read, search, and send WhatsApp messages through your AI assistant