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_update_node

Update node settings (address, config profile/inbounds, traffic limits, tags, note)

remnawave_enable_node

Enable node

remnawave_disable_node

Disable node

remnawave_restart_node

Restart single node (sends forceRestart; force_cycle=true for disable+enable)

remnawave_restart_all_nodes

Restart all nodes

Note: panel 2.8.0 requires forceRestart in the single-node restart body and honors it (older panels ignored the flag and skipped the restart when the config hash matched). The tool sends forceRestart=true by default. force_cycle=true disables and re-enables the node instead - a heavier fallback that also re-establishes the panel-node connection (briefly drops its connections).

Hosts

Tool

Description

remnawave_list_hosts

List all subscription hosts

remnawave_get_host

Get host details by UUID

remnawave_create_host

Create a host on a config profile inbound

remnawave_update_host

Update host properties

remnawave_delete_host

Permanently delete a host

Squads

Tool

Description

remnawave_list_internal_squads

List inbound groups (with inbound UUIDs)

remnawave_update_internal_squad

Update squad name/inbounds (replaces the inbound set)

remnawave_list_external_squads

List tariff plans

Config Profiles

Tool

Description

remnawave_list_config_profiles

List XRay config profiles with inbound UUIDs

remnawave_get_config_profile

Full raw XRay config JSON + inbounds + attached nodes

remnawave_update_config_profile

Replace a profile's XRay config and/or rename it

Subscriptions

Tool

Description

remnawave_get_subscription_settings

View global subscription settings

System

Tool

Description

remnawave_get_system_stats

User counts, traffic, server resources

remnawave_get_system_health

Panel process health (runtime metrics per process)

remnawave_get_bandwidth_stats

Per-node bandwidth over a date range

remnawave_get_node_users_usage

Per-user traffic on one node over a date range

remnawave_get_node_metrics

Real-time node metrics

remnawave_get_keygen

Node provisioning SECRET_KEY (sensitive)

Related MCP server: openclaw-mcp

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

REMNAWAVE_TLS_VERIFY

Optional. Set to false for panels with self-signed certificates (TLS verification is on by default)

Targets Remnawave panel 2.8.x and carries forward-compat guards for known 2.9.0 changes (bodyless DELETE responses, removal of the by-telegram-id/by-email user endpoints, the keygen pubKey → secretKey rename).

Development

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

License

MIT

Install Server
A
license - permissive license
A
quality
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.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Remote Desktop Commander

    Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • Supabase

    MCP server for interacting with the Supabase platform

  • DataDoe MCP

    Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.

View all MCP Connectors

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