{"slug":"nodemaven","name":"NodeMaven MCP (community)","provider_slug":"nodemaven","publisher":"community","publisher_name":"Artirain","kind":"provider-integration","description":"An unofficial local MCP server for inspecting NodeMaven proxy targeting, fetching pages through proxies and reading account location or usage information.","tasks":["Build a proxy URL with explicit location and session settings.","Check an exit IP and fetch page text through a NodeMaven proxy.","Read available targeting locations and account traffic usage."],"limitations":["Community project by Artirain; not affiliated with or maintained by NodeMaven.","Runs third-party Python code locally. The example pins the reviewed repository revision, but dependencies are resolved separately.","Account API calls need NODEMAVEN_API_KEY; proxy requests need a separate proxy username and password.","Page fetching performs HTTP retrieval and text conversion; it does not render JavaScript or control a browser.","Proxy checks contact an external IP information service; requests use the provider account’s traffic.","The URL builder masks the password by default; reveal_credentials can include it in tool output.","Source and documentation were reviewed; the package was not installed or connection-tested."],"capabilities":["proxy-management","scraping-extraction"],"connections":[{"id":"local","label":"Local community server from pinned source","transport":"stdio","hosting":"local","endpoint":null,"package":"nodemaven-mcp","auth":"NODEMAVEN_API_KEY for account metadata; NODEMAVEN_PROXY_USERNAME and NODEMAVEN_PROXY_PASSWORD for proxy traffic.","prerequisites":["Review the community repository and its dependencies before running it locally.","Python 3.10 or later, Git and uv/uvx available to the MCP client.","NodeMaven account with proxy credentials and traffic for fetch or exit-IP tools.","Account API key for the location and usage tools."],"config_label":"Local stdio JSON using a pinned Git revision","config":"{\n  \"mcpServers\": {\n    \"nodemaven\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/Artirain/nodemaven-mcp@aaba70e5c4e882c7e1d3a75d1d61f166593449d9\",\n        \"nodemaven-mcp\"\n      ],\n      \"env\": {\n        \"NODEMAVEN_API_KEY\": \"YOUR_API_KEY\",\n        \"NODEMAVEN_PROXY_USERNAME\": \"YOUR_PROXY_USERNAME\",\n        \"NODEMAVEN_PROXY_PASSWORD\": \"YOUR_PROXY_PASSWORD\"\n      }\n    }\n  }\n}","source_ids":["repository","package-source","entrypoint","uv-tools"]}],"tools":[{"name":"nodemaven_build_proxy_url","description":"Build a targeting URL locally, with the password masked unless explicitly revealed.","task":"Prepare a location and session configuration.","source_ids":["tool-source"]},{"name":"nodemaven_check_proxy","description":"Send a proxy request to an IP information endpoint and return its reported exit details.","task":"Inspect the route before retrieving a page.","source_ids":["tool-source","fetch-source"]},{"name":"nodemaven_fetch","description":"Retrieve a URL through the proxy and return bounded text or HTML.","task":"Read page content from a selected exit location.","source_ids":["tool-source","fetch-source"]},{"name":"nodemaven_list_locations","description":"Read location choices through the account API.","task":"Find documented targeting values.","source_ids":["tool-source","provider-api"]},{"name":"nodemaven_get_usage","description":"Read traffic, request or domain usage through the account API.","task":"Inspect account consumption.","source_ids":["tool-source","provider-api"]}],"commercial":{"account_required":true,"product":"NodeMaven proxy traffic","billing":"The community code is MIT licensed. Proxy requests use a NodeMaven account’s paid traffic under its current subscription or pay-as-you-go terms.","pricing_url":"https://docs.nodemaven.com/en/articles/10290028-how-does-pay-as-you-go-work"},"sources":[{"id":"repository","label":"Community repository and affiliation disclosure","url":"https://github.com/Artirain/nodemaven-mcp","claims":["Unofficial project, local operation and credential setup."],"checked_at":"2026-09-27"},{"id":"package-source","label":"Pinned package and console entrypoint","url":"https://github.com/Artirain/nodemaven-mcp/blob/aaba70e5c4e882c7e1d3a75d1d61f166593449d9/pyproject.toml","claims":["Python requirement, dependencies, MIT declaration and nodemaven-mcp console script."],"checked_at":"2026-09-27"},{"id":"entrypoint","label":"Pinned stdio startup implementation","url":"https://github.com/Artirain/nodemaven-mcp/blob/aaba70e5c4e882c7e1d3a75d1d61f166593449d9/src/nodemaven_mcp/__main__.py","claims":["Local stdio startup; client environment values override local .env values."],"checked_at":"2026-09-27"},{"id":"tool-source","label":"Pinned tool implementation","url":"https://github.com/Artirain/nodemaven-mcp/blob/aaba70e5c4e882c7e1d3a75d1d61f166593449d9/src/nodemaven_mcp/server.py","claims":["Five MCP tool names and arguments, credential masking and targeting validation."],"checked_at":"2026-09-27"},{"id":"config-source","label":"Pinned credentials and default endpoints","url":"https://github.com/Artirain/nodemaven-mcp/blob/aaba70e5c4e882c7e1d3a75d1d61f166593449d9/src/nodemaven_mcp/config.py","claims":["Separate account API and proxy credentials; defaults use NodeMaven domains."],"checked_at":"2026-09-27"},{"id":"fetch-source","label":"Pinned HTTP retrieval implementation","url":"https://github.com/Artirain/nodemaven-mcp/blob/aaba70e5c4e882c7e1d3a75d1d61f166593449d9/src/nodemaven_mcp/fetch.py","claims":["HTTP retrieval, text conversion, truncated flag and external IP information request."],"checked_at":"2026-09-27"},{"id":"uv-tools","label":"uv documentation: tools from Git commits","url":"https://docs.astral.sh/uv/guides/tools/","claims":["uvx --from supports a Git source pinned to a commit."],"checked_at":"2026-09-27"},{"id":"provider-api","label":"NodeMaven account API authentication","url":"https://docs.nodemaven.com/en/articles/10329935-api-access","claims":["Account API key location, authorization format, location and statistics access."],"checked_at":"2026-09-27"},{"id":"provider-billing","label":"NodeMaven proxy traffic billing","url":"https://docs.nodemaven.com/en/articles/10290028-how-does-pay-as-you-go-work","claims":["Proxy traffic is available through pay-as-you-go and subscription plans."],"checked_at":"2026-09-27"}],"checked_at":"2026-09-27","updated_at":"2026-09-27","review_due_at":"2026-10-27","verification":"docs-confirmed","test":null,"status":"published","withdrawal_reason":null,"repository_url":"https://github.com/Artirain/nodemaven-mcp","license":"MIT","editorial":{"seo_title":"NodeMaven MCP: Community Setup, Proxy URLs and Page Fetches","seo_description":"Review the unofficial NodeMaven MCP server, pinned local setup, separate API and proxy credentials, exit-IP checks and HTTP page-fetch limitations.","intro":"This community NodeMaven MCP server turns proxy targeting into explicit agent tools. It can build connection strings, inspect a proxy route and retrieve page text. The server runs on your machine and is not a NodeMaven-hosted integration.","selection":{"best_for":["Developers who want location and session settings visible in a proxy workflow.","Reading HTTP page content alongside account usage or targeting information."],"not_for":["A requirement for provider-maintained MCP software.","JavaScript rendering or interactive browser navigation."],"source_ids":["repository","tool-source","fetch-source"]},"recommended_connection":{"connection_id":"local","reason":"The local profile pins the reviewed Git revision and invokes its declared console script through uvx. It is an adaptation of the source package using uv’s documented Git mechanism; it has not been installation-tested.","source_ids":["package-source","entrypoint","uv-tools"]},"workflow":{"title":"Inspect a route before fetching a page","steps":[{"title":"Choose supported targeting values","body":"Read available locations with the account API key, then choose a country and any narrower fields needed for the task.","tool_names":["nodemaven_list_locations"],"source_ids":["tool-source","provider-api"]},{"title":"Check the proxy exit","body":"Supply the proxy username and password, then inspect the reported exit-IP result. Reduce narrow filters if the connection fails.","tool_names":["nodemaven_check_proxy"],"source_ids":["config-source","fetch-source"]},{"title":"Fetch and inspect the response","body":"Request the page with the same targeting settings. Check status_code and truncated before using the returned text; max_bytes limits the returned body, not the total downloaded response.","tool_names":["nodemaven_fetch"],"source_ids":["fetch-source"]}]},"troubleshooting":[{"symptom":"Locations load but page requests fail for missing credentials.","resolution":"Add the proxy username and password. The account API key authenticates metadata calls, not proxy traffic.","source_ids":["config-source","provider-api"]},{"symptom":"The proxy URL contains asterisks in the password position.","resolution":"The builder masks it by default. reveal_credentials exposes the real password in tool output; use it only when that output is needed for an authenticated connection.","source_ids":["tool-source"]},{"symptom":"A page fetch omits content visible in a browser.","resolution":"Check the truncation flag and response status. This implementation converts returned HTML to text; it has no JavaScript rendering step.","source_ids":["fetch-source"]}],"faqs":[{"question":"Is this NodeMaven’s official MCP server?","answer":"No. Artirain publishes it as an unofficial community project. NodeMaven supplies the underlying proxy and account services.","source_ids":["repository"]},{"question":"Do I need all three credential values for every tool?","answer":"No. Location and usage tools require the account API key. URL building, exit-IP checks and page fetching use the proxy username and password. Missing values affect their relevant tool family.","source_ids":["config-source","tool-source"]},{"question":"Does the pinned Git commit lock every installed dependency?","answer":"No. It fixes the server source revision. The package declares dependency ranges, so dependency resolution can change; this directory has not verified a complete installed environment.","source_ids":["package-source","uv-tools"]}]},"url":"https://workingproxysites.info/mcp/nodemaven","provider_url":"https://workingproxysites.info/t/34-nodemaven-proxies","review_due":false,"version":null}