# NodeMaven

Builds geo-targeted NodeMaven proxy strings, tests live connections and checks remaining account bandwidth.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: nodemaven
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nodemaven/nodemaven-mcp
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/mcp/nodemaven

## What it does

This integration connects an assistant to residential proxies without modifying account resources. The agent generates HTTP or SOCKS5 endpoints targeted by country, region, city, or network provider. It also configures sticky session durations.

Available tools allow the assistant to test latency via `check_proxy`, inspect exit IPs, and pull location identifiers. For usage tracking, it reads account balances, sub-user limits, and per-domain data consumption. Sensitive credentials stay protected: passwords appear masked as `<PROXY_PASSWORD>` to avoid spilling secrets into the chat context.

Execution relies on `uvx` or a local `pip` installation of the Python package. Without a valid `NODEMAVEN_APIKEY`, the server will refuse to operate. Default credentials load via the dashboard key, though custom sub-user logins can be supplied through environment variables.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `NODEMAVEN_APIKEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add nodemaven-mcp -e NODEMAVEN_APIKEY=<NODEMAVEN_APIKEY> -- uvx nodemaven-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nodemaven-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add nodemaven --env NODEMAVEN_APIKEY=<NODEMAVEN_APIKEY> -- uvx nodemaven-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nodemaven-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nodemaven": {
            "command": "uvx",
            "args": [
                "nodemaven-mcp"
            ],
            "env": {
                "NODEMAVEN_APIKEY": "<NODEMAVEN_APIKEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nodemaven-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nodemaven": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "nodemaven-mcp"
            ],
            "env": {
                "NODEMAVEN_APIKEY": "<NODEMAVEN_APIKEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nodemaven-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e NODEMAVEN_APIKEY=<NODEMAVEN_APIKEY> nodemaven uvx nodemaven-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nodemaven-mcp <command>

## When to use it
- generate proxy endpoints for specific regions or ISPs
- verify exit IP addresses and test connection latency
- check current subscription status and traffic balance
- inspect bandwidth usage broken down by visited domains

## Example prompts
- Generate an HTTP proxy string targeted to Berlin with a ten-minute sticky session.
- Run check_proxy on our active endpoint and show me the exit IP.
- Check how much traffic remains on my NodeMaven account.

## Similar
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/decodo-mcp-server.md) — MCP server · ★ 39
- [fetch](https://affpapa.org/en/nevibecode/skills/fetch.md) — skill · 3000 installs
- [proxy-scraper](https://affpapa.org/en/nevibecode/mcp/proxy-scraper.md) — MCP server · ★ 74
- [zenrows-mcp](https://affpapa.org/en/nevibecode/mcp/zenrows-mcp.md) — MCP server · ★ 21
- [steel-reliability](https://affpapa.org/en/nevibecode/skills/steel-reliability.md) — skill · 432 installs
- [brightdata-plugin](https://affpapa.org/en/nevibecode/plugins/brightdata-plugin.md) — plugin · ★ 268

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md