Skip to main content
Glama
ssasuoirafen

remnawave-mcp-server

by ssasuoirafen
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

remnawave-mcp-server

MCP server for Remnawave panel API. Manage VPN users, nodes, hosts, and system stats from Claude Code or any MCP-compatible client.

Tools

Users

Tool

Description

remnawave_list_users

List users with pagination

remnawave_get_user

Get user by UUID, username, telegram ID, or email

remnawave_create_user

Create new user

remnawave_update_user

Update user properties

remnawave_delete_user

Permanently delete user

remnawave_enable_user

Enable disabled user

remnawave_disable_user

Disable user (suspend VPN)

remnawave_revoke_user

Revoke subscription, regenerate credentials

remnawave_reset_user_traffic

Reset traffic counter to zero

Nodes

Tool

Description

remnawave_list_nodes

List all XRay nodes

remnawave_get_node

Get node details by UUID

remnawave_enable_node

Enable node

remnawave_disable_node

Disable node

remnawave_restart_node

Restart single node

remnawave_restart_all_nodes

Restart all nodes

Note: remnawave_restart_node (single node) is broken upstream - the panel reports the event as sent, but the node-side processor hardcodes forceRestart=false, so XRay is not actually restarted when the config hash matches. Prefer remnawave_disable_node + remnawave_enable_node, or remnawave_restart_all_nodes (which sends forceRestart=true).

Hosts

Tool

Description

remnawave_list_hosts

List all subscription hosts

remnawave_get_host

Get host details by UUID

Squads

Tool

Description

remnawave_list_internal_squads

List inbound groups

remnawave_list_external_squads

List tariff plans

Subscriptions

Tool

Description

remnawave_get_subscription_settings

View global subscription settings

remnawave_list_config_profiles

List XRay config profiles

System

Tool

Description

remnawave_get_system_stats

User counts, traffic, server resources

remnawave_get_system_health

Process health (CPU, memory)

remnawave_get_bandwidth_stats

Bandwidth over time range

remnawave_get_node_metrics

Real-time node metrics

Related MCP server: uptime-kuma-mcp-server

Configuration

Claude Code (.mcp.json)

{
  "mcpServers": {
    "remnawave-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ssasuoirafen/remnawave-mcp-server", "remnawave-mcp"],
      "env": {
        "REMNAWAVE_API_URL": "https://panel.example.com",
        "REMNAWAVE_API_USERNAME": "your-username",
        "REMNAWAVE_API_PASSWORD": "your-password"
      }
    }
  }
}

Variable

Description

REMNAWAVE_API_URL

Panel root URL, no /api suffix - the server prefixes /api/... on every request (e.g. https://panel.example.com)

REMNAWAVE_API_USERNAME

Admin username

REMNAWAVE_API_PASSWORD

Admin password

Note: the panel client connects with TLS verification disabled (verify=False) by design, so it works with internal panels that use self-signed certificates. Make sure you trust the network path to your panel.

Development

git clone https://github.com/ssasuoirafen/remnawave-mcp-server.git
cd remnawave-mcp-server
uv sync

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ssasuoirafen/remnawave-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server