NodeMaven
NodeMaven residential proxies: geo-targeted proxy URLs, sticky sessions, checks and usage
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
Not assessed yet.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
uvx nodemaven-mcp
MCP client config
{
"mcpServers": {
"nodemaven": {
"command": "uvx",
"args": [
"nodemaven-mcp"
]
}
}
}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
