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.
7 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
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-nodemaven-nodemaven-mcp": {
"env": {
"NODEMAVEN_APIKEY": "your-nodemaven-apikey-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, look up locations, and read traffic usage.
It is read-only: nothing in your account is created, changed or deleted.
Tools
| Tool | What it does |
|---|---|
proxy_url | Proxy string for a country, region, city or ISP, with an optional sticky session and its lifetime. HTTP or SOCKS5. |
check_proxy | Opens one connection through the proxy and returns the status, the exit IP and the time it took. |
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. |
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.
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_REVEAL_PASSWORD | 1 puts the real password into proxy_url 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_urlreturns 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.
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
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Worldmonitor
Freeby Koala73 · Developer Tools
Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 89 tools.
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-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.