Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NODEMAVEN_LOGINNoOptional. Proxy credential login to use instead of the account's own, e.g. a sub-user.
NODEMAVEN_APIKEYYesRequired. API key from the NodeMaven dashboard.
NODEMAVEN_PASSWORDNoOptional. Proxy credential password to use instead of the account's own, e.g. a sub-user.
NODEMAVEN_MCP_REVEAL_PASSWORDNoSet to `1` to put the real password into `proxy_url` output. Off by default.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
proxy_urlA

Build a NodeMaven proxy string.

Targeting goes into the username. Without session_id every request gets a
new exit IP; with session_id the same exit is kept for ttl (e.g. "10m",
"1h", "24h"). country is a two-letter code; region, city and isp take the
codes from list_locations. filter is the IP quality filter, e.g. "medium".
connection_type picks residential or mobile IPs; for mobile, take the
location codes from list_locations with connection_type="mobile".
The password is a placeholder unless the server allows revealing it.
check_proxyB

Open one connection through the proxy and report the result.

Sends no traffic through the tunnel. Returns the gateway status, the exit
IP when the gateway reports it, and how long the connection took. A 407 can
mean a wrong parameter value as well as wrong credentials. For mobile, take
the location codes from list_locations with connection_type="mobile".
test_proxy_on_siteA

Request one page of a site through the proxy and say whether it answered.

Sends one GET and reads at most 2 MB. Returns the status, the final URL,
the size and time, and a block reason when the status or the page looks like
a refusal (403, 429, a captcha or a challenge page). The page itself is not
returned. A plain HTTP request is a weaker test than a browser: a site that
needs JavaScript can refuse it and still serve the same proxy in a browser.
For mobile, take the location codes from list_locations with
connection_type="mobile".
list_locationsA

List locations available for targeting, with the codes proxy_url takes.

regions need country_code; cities and isps can be narrowed by country_code
and region_code. At most 100 rows per call: when next_offset is returned,
call again with offset=next_offset for the rest.
account_statusB

Remaining traffic (bytes), subscription status and whether traffic is frozen.

traffic_statsB

Traffic used over time, as parallel labels and data arrays.

Pass period, or start and end as dd-mm-yyyy (not ISO). Defaults to today.

top_domainsB

Domains reached through the proxy, largest traffic first, with bytes and request counts.

Pass period, or start and end as dd-mm-yyyy (not ISO). Defaults to today.

list_sub_usersA

Sub-users of the account with their traffic usage and limits. No passwords.

Paged from page 1. When next_page is returned, call again with it for the
rest; a page past the end comes back empty.
create_sub_userA

Create a sub-user with its own proxy login. Changes the account.

The password is generated here. It is returned only if the server allows
revealing passwords; otherwise the user reads it in the dashboard.
traffic_limit is in the same unit list_sub_users shows for traffic_limit and
used_traffic; leave it out for no limit.
update_sub_userB

Change a sub-user's traffic limit, or turn the limit on or off. Changes the account.

reset_sub_user_usageA

Set the recorded traffic of one or more sub-users back to zero. Changes the account.

delete_sub_userA

Delete a sub-user. Its proxy login stops working. Cannot be undone.

list_whitelist_ipsA

IP addresses allowed to use the proxy without a password, with their ports and targeting.

Paged from page 1. When next_page is returned, call again with it for the rest.
add_whitelist_ipA

Allow an IP address to use the proxy without a password. Changes the account.

ports_count is how many proxy ports the address gets. country, region, city
and isp take the codes from list_locations. An address removed in the last
hour can be refused as already whitelisted for a while.
remove_whitelist_ipA

Remove an address from the whitelist, by the id list_whitelist_ips or add_whitelist_ip gave.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 15 tools

Disambiguation4/5

Most tools target clearly distinct resources and actions, and the descriptions make the boundaries readable. The only notable overlap is between check_proxy and test_proxy_on_site, which both test proxy behavior but differ in scope.

Naming Consistency4/5

Names are consistently snake_case, and most action tools follow a verb_noun pattern. A few read-only/analytics tools use noun phrases instead, which is a minor deviation but still predictable.

Tool Count5/5

With 15 tools, the set is well-scoped for proxy account management, covering analytics, sub-users, whitelist IPs, and proxy testing. Each tool appears to earn its place without obvious redundancy.

Completeness4/5

The surface covers the main lifecycle operations for sub-users and whitelist IPs, plus analytics and proxy testing. Some smaller gaps exist, such as no direct update for whitelist IP targeting or sub-user password reset, but these are workable around via remove/add or dashboard access.

Maintenance

ActivityMaintained
ResponsivenessNo issues