mcp-remnawave
mcp-remnawave
面向 Remnawave VPN 面板的 MCP 服务器——已适配 Remnawave 3.x
能够通过面板的 REST API 读取和管理用户、节点、主机、配置档案、群组、订阅模板、计费和 HWID 设备。
这是 TrackLine/mcp-remnawave v1.2.0 的维护分支——已对齐 Remnawave 3.x(已在真实运行的 3.3.x 面板上验证),并经过重构,使工具 Schema 从此不会再与面板 API 脱节。
✨ Highlights
数字型用户 id | Remnawave 3.0 移除了用户的 |
Schema 取自契约 | 写工具的输入 Schema 直接取自 |
真实错误信息 | 校验错误会带字段级返回,而不是一个光秃秃的 |
一装、多面板 | 面板配置先在当前项目里查——生效的面板取决于你正在哪个项目里 |
默认只读 | 设置 |
Related MCP server: remnawave-mcp
Quick start
git clone https://github.com/Maaagiic/mcp-remnawave.git
cd mcp-remnawave
npm install && npm run build
cp .env.example .env # set REMNAWAVE_BASE_URL and REMNAWAVE_API_TOKEN
# Claude Code — available in every project:
claude mcp add --scope user remnawave -- node "$PWD/dist/index.js"对。让你的客户端调一个 system_metadata 就行——它应返回面板版本。
{
"mcpServers": {
"remnawave": {
"command": "node",
"args": ["/absolute/path/to/mcp-remnawave/dist/index.js"]
}
}
}任何 stdio 型 MCP 客户端都可以用——把命令指向 节点 dist/index.js, 并传入下方表格中的这些环境变量(也可以靠配置文件自动查找)。
舱 配置
Variable | Required | Description |
| 面板 URL,例如 | |
| API 令牌(Bearer)——面板 → API 命令令牌 | |
| — |
|
| — | Caddy 自定义部署线时 |
| — | 显式路径到配置文件 |
配置文件从哪来
服务器在第一个提供了 REMNAWAVE_BASE_URL 和 REMNAWAVE_API_TOKEN 的文件处停止:
1. $REMNAWAVE_ENV_FILE explicit path
2. <cwd>/.remnawave.env per-project — add it to .gitignore
3. <cwd>/.env
4. <package>/.env fallbackMCP 客户端以项目根目录为 cwd 启动 stdio 服务器,因此只要全局安装一次,生效面板就是你正在工作的那个项目。给某个项目加点面板,只要把 .remnawave.env 拖进该项目即可——服务端侧完全不用动。环境里已存在的变量永远不被覆盖,所以注册客户端时传过来的 env 总是生效。
只读模式
以 REMNAWAVE_READONLY=true 启动。此模式下,写工具(create / update / delete / enable / disable / bulk)完全不会注册,客户端连尝试都不能。当确认需要写入时,把它改为 false 并重启服务。
🧰 工具
约 150 个工具,按面板 API 分组。读工具一直可用;写工具只在关闭只读后提供。
Read | Write |
|
|
按 telegram / email / tag / status 搜索:
users_list传filters: [{"id": "telegramId", "value": 123456789}](按需也可加filterModes、sorting。用这个替代 3.x 中移除的 `by- toda* 路由。话题:
users_resolve只接受id、shortUuid、username中 恰好一个。批量工具接收
userIds: number[](1–500);users_bulk_update把变更字段放到fields下面。users_create可以传显式的vlessUuid/ssPassword/trojanPassword/shortUid——服务账号时不显得方便。
| 分组 | 读 | 写 |
| ---- | ---- |
| 节点 | nodes_list, nodes_get, nodes_tags_list | nodes_create / update / delete, nodes_enable / disable, nodes_restart, nodes_restart_all, nodes_reorder, nodes_reset_raffic, nodes_bulk_* |
| 主机 | hosts_list, hosts_get, hosts_tags_list | hosts_create / update / delete, hosts_bulk_* |
| 配置档案 | config_profiles_list / get, config_profiles_get_inbounds, config_profiles_get_computed_config, inbounds_list | config_profiles_create / update / delete / reorder |
config_profiles_update带config时替换的是档案里整个 xray 配置——先读出来、打补丁、再写回去。hosts_create需要传inbound: { configProfileUuid, configProfileInoundUuid }。
分组 | 读 | 写 |
群组 |
|
|
订阅 |
| — |
— | ||
模板页面 |
|
|
分组 | 读 | 写 |
HWID |
|
|
系统 |
|
|
计费 |
|
|
节点插件 |
|
|
杂项 |
|
|
`` api_tokens_list 和 settings_* 需要具有匹配权限的 API 令牌——否则面板会返回 Forbidden。
🔧 与上游相比的变更
所有地方均使用数值型用户 ID;移除了
users_get_by_telegram_id/_by_email/_by_tag/_by_subscription_uuid以及subscriptions_get_by_uuid(这些路由已不存在)。contractTool()——写入工具根据契约中的RequestSchema.shape进行注册。 之前:23 个写入工具中有 20 个只暴露了字段子集,MCP SDK 会静默丢弃其余字段。users_*仍为手写实现:已安装的契约仍为users声明了uuid。新增:
users_extend_expiration、users_accessible_nodes、subscriptions_get_by_user_id、subscription_templates_list/get/update;config_profiles_update现在接受profile。客户端:完整的 API 错误体;处理批量操作时的空
2xx响应体; 针对仅存在于 3.x 的路由采用尾部斜杠安全的手工构建路径。来自契约的枚举(
RESET_PERIODS含MONTH_ROLLING、USERS_STATUS)。多面板配置查找;默认推荐只读;版本号提升至 2.0.0。
🛠 开发
npm run dev # tsup --watch
npm run build # tsup → dist/index.js
npx tsc --noEmit # typecheck🐳 Docker
docker compose up -d参见 docker-compose.yml 并传入相同的环境变量。
📄 许可证
MIT。上游作者:TrackLine/mcp-remnawave。
Available Tools
204 toolsapi_requestADestructive
Send a raw request to the panel REST API with the configured token. Use it only for endpoints no dedicated tool covers. All methods are allowed.
Inputs: path (required), body, query, method.
api_tokens_createA
Create a new API token. This endpoint is forbidden to use via "API-key". It can only be used with an admin JWT-token.
Inputs: name (required), expiresInDays (required), scopes.
api_tokens_deleteADestructive
Delete API token. This endpoint is forbidden to use via "API-key". It can be used only with an admin JWT-token.
Inputs: uuid (required).
api_tokens_listARead-only
Get all API tokens. This endpoint is forbidden to use via "API-key". It can only be used with admin JWT-token.
Inputs: no named parameters.
api_tokens_scopesARead-only
Get available API token scopes. Returns the catalog of scopes that can be granted to an API token, grouped by resource. Forbidden via "API-key", admin JWT only.
Inputs: no named parameters.
auth_statusCRead-only
Get the status of the authentication
Inputs: no named parameters.
bandwidth_nodes_usageCRead-only
Get Nodes Usage by Range
Inputs: end (required), start (required), topNodesLimit.
bandwidth_nodes_usage_thresholdARead-only
Get users exceeding a traffic threshold on the given nodes for a period. Returns users whose total usage over the period on the given nodes is >= minTotalBytes. Underlying usage data is flushed to the database roughly every 2 minutes.
Inputs: end (required), start (required), nodesUuids (required), minTotalBytes.
bandwidth_nodes_usersCRead-only
Get Nodes Users Usage by Nodes UUIDs
Inputs: end (required), start (required), nodesUuids (required), topUsersLimit.
bandwidth_node_usersCRead-only
Get Node Users Usage by Node UUID
Inputs: end (required), uuid (required), start (required), topUsersLimit.
bandwidth_squad_usageARead-only
Get internal squad users traffic usage for a period. Returns users whose total usage over the period on the given nodes is >= minTotalBytes, scoped to the nodes reachable via the internal squad inbounds. Underlying usage data is flushed to the database roughly every 2 minutes.
Inputs: end (required), uuid (required), start (required), limit, +2 more.
bandwidth_squad_user_usageCRead-only
Get a single user daily traffic usage on the internal squad nodes for a period. Returns users whose total usage over the period on the given nodes is >= minTotalBytes, scoped to the nodes reachable via the Internal Squad inbounds. Every day in the range is present (zero-filled). Underlying usage data is flushed to the database roughly every 2 minutes.
Inputs: end (required), start (required), userId (required), squadUuid (required).
bandwidth_user_usageCRead-only
Get User Usage by Range
Inputs: end (required), start (required), userId (required), topNodesLimit.
billing_history_createC
Create infra billing history
Inputs: amount (required), billedAt (required), providerUuid (required).
billing_history_deleteCDestructive
Delete infra billing history
Inputs: uuid (required).
billing_history_listCRead-only
Get infra billing history
Inputs: size, start.
billing_node_createC
Create infra billing node
Inputs: name (required), nodeUuid (required), providerUuid (required), nextBillingAt (required).
billing_node_deleteCDestructive
Delete infra billing node
Inputs: uuid (required).
billing_nodes_listCRead-only
Get infra billing nodes
Inputs: no named parameters.
billing_node_updateC
Update infra billing nodes
Inputs: uuids (required), nextBillingAt (required).
billing_provider_createC
Create infra provider
Inputs: name (required), loginUrl, faviconLink.
billing_provider_deleteCDestructive
Delete infra provider by uuid
Inputs: uuid (required).
billing_provider_getCRead-only
Get infra provider by uuid
Inputs: uuid (required).
billing_providers_listBRead-only
Get all infra providers
Inputs: no named parameters.
billing_provider_updateD
Update infra provider
Inputs: uuid (required), name, loginUrl, faviconLink.
config_profiles_createC
Create config profile
Inputs: name (required), config (required).
config_profiles_deleteCDestructive
Delete config profile
Inputs: uuid (required).
config_profiles_getBRead-only
Get config profile by uuid
Inputs: uuid (required).
config_profiles_get_computed_configBRead-only
Get computed config profile by uuid
Inputs: uuid (required).
config_profiles_get_inboundsCRead-only
Get inbounds by profile uuid
Inputs: uuid (required).
config_profiles_listARead-only
List config profiles with their inbounds and nodes. The xray config itself is left out: use config_profiles_get for one profile, or full=true.
Inputs: full.
config_profiles_reorderC
Reorder config profiles
Inputs: items (required).
config_profiles_set_tagsC
Set tags of Config Profile
Inputs: tags (required), uuid (required).
config_profiles_tags_listBRead-only
Get tags of Config Profiles
Inputs: no named parameters.
config_profiles_updateA
Update a config profile: name and/or the full xray config. Nodes that use the profile restart xray to apply it.
Inputs: uuid (required), name, config.
connections_by_node_requestARead-only
Request the active connections on a node. Starts a job on the node(s) and returns a jobId — fetch the outcome with connections_by_node_result.
Inputs: nodeUuid (required).
connections_by_node_resultCRead-only
Get Connections for Node by Job ID
Inputs: jobId (required).
connections_by_user_requestARead-only
Request the active connections (IPs) of a user. Starts a job on the node(s) and returns a jobId — fetch the outcome with connections_by_user_result.
Inputs: userId (required).
connections_by_user_resultCRead-only
Get Connections for User by Job ID
Inputs: jobId (required).
connections_dropCDestructive
Drop Connections for Users or IPs
Inputs: dropBy (required), targetNodes (required).
connections_geocheck_requestARead-only
Check how a node's exit IP is geolocated. Starts a job on the node(s) and returns a jobId — fetch the outcome with connections_geocheck_result.
Inputs: nodeUuid (required), ip, interface.
connections_geocheck_resultCRead-only
Get Geocheck for Node by Job ID
Inputs: jobId (required).
external_squads_add_all_usersBDestructive
Add EVERY user to an external squad
Inputs: uuid (required).
external_squads_createC
Create external squad
Inputs: name (required).
external_squads_deleteCDestructive
Delete external squad
Inputs: uuid (required).
external_squads_getCRead-only
Get external squad by uuid
Inputs: uuid (required).
external_squads_listBRead-only
Get all external squads
Inputs: no named parameters.
external_squads_remove_all_usersBDestructive
Remove EVERY user from an external squad
Inputs: uuid (required).
external_squads_reorderC
Reorder external squads
Inputs: items (required).
external_squads_set_tagsC
Set tags of External Squad
Inputs: tags (required), uuid (required).
external_squads_tags_listBRead-only
Get tags of External Squads
Inputs: no named parameters.
external_squads_updateD
Update external squad
Inputs: uuid (required), name, templates, hwidSettings, +6 more.
hosts_bulk_deleteCDestructive
Delete hosts by UUIDs
Inputs: uuids (required).
hosts_bulk_disableC
Disable hosts by UUIDs
Inputs: uuids (required).
hosts_bulk_enableC
Enable hosts by UUIDs
Inputs: uuids (required).
hosts_bulk_updateB
Update many hosts at once: the given fields (same as hosts_update) are applied to every host in uuids
Inputs: uuids (required), sni, alpn, host, +28 more.
hosts_cloneC
Clone host
Inputs: cloneFromUuid (required).
hosts_createC
Create a new host
Inputs: port (required), remark (required), address (required), inbound (required), +27 more.
hosts_deleteCDestructive
Delete a host by UUID
Inputs: uuid (required).
hosts_getCRead-only
Get a host by UUID
Inputs: uuid (required).
hosts_listCRead-only
Get hosts
Inputs: no named parameters.
hosts_reorderD
Reorder hosts
Inputs: hosts (required).
hosts_tags_listBRead-only
Get tags of hosts
Inputs: no named parameters.
hosts_updateC
Update a host
Inputs: uuid (required), sni, alpn, host, +28 more.
hwid_device_createC
Create a user HWID device
Inputs: hwid (required), userId (required), platform, osVersion, +3 more.
hwid_device_deleteCDestructive
Delete a user HWID device
Inputs: hwid (required), userId (required).
hwid_devices_delete_allBDestructive
Delete all user HWID devices
Inputs: userId (required).
hwid_devices_listCRead-only
Get user HWID devices
Inputs: userId (required).
hwid_devices_list_allBRead-only
Get HWID devices. Please note that the filters here are primarily intended for use by the frontend and rely on expensive operators such as LIKE under the hood. Misusing these filters may negatively impact the performance of your database.
Inputs: size, start, filters, sorting, +2 more.
hwid_statsCRead-only
Get HWID devices stats
Inputs: no named parameters.
hwid_top_usersBRead-only
Get top users by HWID devices
Inputs: size, start.
inbounds_listARead-only
List inbounds of all config profiles (tag, type, port, squads). full=true adds the raw xray inbound objects.
Inputs: full.
keygen_getBRead-only
Get SECRET_KEY for Remnawave Node
Inputs: no named parameters.
metadata_node_getCRead-only
Get node metadata
Inputs: uuid (required).
metadata_node_upsertC
Update or create Node Metadata
Inputs: uuid (required), metadata (required).
metadata_user_getCRead-only
Get user metadata
Inputs: userId (required).
metadata_user_upsertC
Update or create User Metadata
Inputs: userId (required), metadata (required).
node_integrations_createD
Create Node Integration
Inputs: name (required), config (required), description.
node_integrations_deleteCDestructive
Delete Node Integration
Inputs: uuid (required).
node_integrations_getCRead-only
Get Node Integration by uuid
Inputs: uuid (required).
node_integrations_listBRead-only
Get all Node Integrations
Inputs: no named parameters.
node_integrations_updateD
Update Node Integration
Inputs: uuid (required), name, config, description, +1 more.
node_plugins_cloneD
Clone Node Plugin
Inputs: cloneFromUuid (required).
node_plugins_createC
Create Node Plugin
Inputs: name (required).
node_plugins_deleteCDestructive
Delete Node Plugin
Inputs: uuid (required).
node_plugins_executeC
Execute command on node plugins
Inputs: command (required), targetNodes (required).
node_plugins_getCRead-only
Get Node Plugin by uuid
Inputs: uuid (required).
node_plugins_listBRead-only
Get all Node Plugins
Inputs: no named parameters.
node_plugins_reorderC
Reorder Node Plugins
Inputs: items (required).
node_plugins_set_tagsC
Set tags of Node Plugin
Inputs: tags (required), uuid (required).
node_plugins_syncA
Sync Node Plugin to nodes. Push the current plugin config, including referenced shared lists, to every connected node this plugin is active on.
Inputs: uuid (required).
node_plugins_tags_listBRead-only
Get tags of Node Plugins
Inputs: no named parameters.
node_plugins_torrent_reportsBRead-only
Get Torrent Blocker Reports. Please note that the filters here are primarily intended for use by the frontend and rely on expensive operators such as LIKE under the hood. Misusing these filters may negatively impact the performance of your database.
Inputs: size, start, filters, sorting, +2 more.
node_plugins_torrent_statsCRead-only
Get Torrent Blocker Reports Stats
Inputs: no named parameters.
node_plugins_torrent_truncateCDestructive
Truncate Torrent Blocker Reports
Inputs: no named parameters.
node_plugins_updateD
Update Node Plugin
Inputs: uuid (required), name, pluginConfig.
nodes_bulk_actionsC
Perform actions for many nodes
Inputs: uuids (required), action (required).
nodes_bulk_profile_modificationC
Modify Inbounds & Profile for many nodes
Inputs: uuids (required), configProfile (required).
nodes_bulk_updateD
Update many nodes
Inputs: uuids (required), fields (required).
nodes_createD
Create a new node
Inputs: name (required), address (required), configProfile (required), ips, +14 more.
nodes_deleteCDestructive
Delete a node
Inputs: uuid (required).
nodes_disableC
Disable a node
Inputs: uuid (required).
nodes_enableC
Enable a node
Inputs: uuid (required).
nodes_getCRead-only
Get node by UUID
Inputs: uuid (required).
nodes_listARead-only
List all nodes. Compact by default: inbounds as tags, provider as name, system info trimmed. Pass full=true for the raw panel response, or use nodes_get for one node.
Inputs: full.
nodes_reorderD
Reorder nodes
Inputs: nodes (required).
nodes_reset_trafficC
Reset Node Traffic
Inputs: uuid (required).
nodes_restartC
Restart node
Inputs: uuid (required), forceRestart (required).
nodes_restart_allBDestructive
Restart EVERY node
Inputs: forceRestart (required).
nodes_tags_listCRead-only
Get nodes tags
Inputs: no named parameters.
nodes_updateD
Update node
Inputs: uuid (required), ips, name, note, +15 more.
settings_getCRead-only
Get Remnawave settings
Inputs: no named parameters.
settings_updateC
Update Remnawave settings
Inputs: oauth2Settings, passkeySettings, brandingSettings, passwordSettings.
snippets_createD
Create snippet
Inputs: name (required), snippet (required).
snippets_deleteCDestructive
Delete snippet
Inputs: name (required).
snippets_listCRead-only
Get snippets
Inputs: no named parameters.
snippets_syncB
Sync snippet to affected config profiles. Trigger the sync of a snippet to all config profiles that reference it. Nodes which use affected config profiles will be restarted.
Inputs: name (required).
snippets_updateD
Update snippet
Inputs: name (required), snippet (required).
squads_accessible_nodesDRead-only
Get internal squad accessible nodes
Inputs: uuid (required).
squads_add_all_usersADestructive
Add EVERY user to an internal squad. For selected users use squads_add_many_users.
Inputs: uuid (required).
squads_add_many_usersC
Add many users to internal squad
Inputs: uuid (required), userIds (required).
squads_createC
Create internal squad
Inputs: name (required), inbounds (required).
squads_deleteCDestructive
Delete internal squad
Inputs: uuid (required).
squads_getBRead-only
Get internal squad by uuid
Inputs: uuid (required).
squads_listBRead-only
List internal squads with their inbounds. full=true adds the raw xray inbound objects.
Inputs: full.
squads_remove_all_usersADestructive
Remove EVERY user from an internal squad. For selected users use squads_remove_many_users.
Inputs: uuid (required).
squads_remove_many_usersC
Delete many users from internal squad
Inputs: uuid (required), userIds (required).
squads_reorderC
Reorder internal squads
Inputs: items (required).
squads_set_tagsC
Set tags of Internal Squad
Inputs: tags (required), uuid (required).
squads_tags_listBRead-only
Get tags of Internal Squads
Inputs: no named parameters.
squads_updateC
Update internal squad
Inputs: uuid (required), name, inbounds.
sub_page_configs_cloneC
Clone subscription page config
Inputs: cloneFromUuid (required).
sub_page_configs_createC
Create subscription page config
Inputs: name (required).
sub_page_configs_deleteCDestructive
Delete subscription page config
Inputs: uuid (required).
sub_page_configs_getCRead-only
Get subscription page config by uuid
Inputs: uuid (required).
sub_page_configs_listBRead-only
Get all subscription page configs
Inputs: no named parameters.
sub_page_configs_reorderC
Reorder subscription page configs
Inputs: items (required).
sub_page_configs_set_tagsC
Set tags of Subpage Config
Inputs: tags (required), uuid (required).
sub_page_configs_tags_listBRead-only
Get tags of Subpage Configs
Inputs: no named parameters.
sub_page_configs_updateC
Update subscription page config
Inputs: uuid (required), name, config.
subscription_infoCRead-only
Get Subscription Info by Short UUID
Inputs: shortUuid (required).
subscription_request_history_listARead-only
Get all subscription request history. Please note that the filters here are primarily intended for use by the frontend and rely on expensive operators such as LIKE under the hood. Misusing these filters may negatively impact the performance of your database.
Inputs: size, start, filters, sorting, +2 more.
subscription_request_history_statsCRead-only
Get subscription request history stats
Inputs: no named parameters.
subscription_settings_getCRead-only
Get subscription settings
Inputs: no named parameters.
subscription_settings_updateD
Update subscription settings
Inputs: uuid (required), hwidSettings, customRemarks, responseRules, +4 more.
subscriptions_get_by_short_uuidBRead-only
Get subscription by short uuid (protected route)
Inputs: shortUuid (required).
subscriptions_get_by_user_idCRead-only
Get subscription by User ID
Inputs: userId (required).
subscriptions_get_by_usernameCRead-only
Get subscription by username
Inputs: username (required).
subscriptions_get_connection_keysBRead-only
Get connection keys (base64 format) by user id
Inputs: userId (required).
subscriptions_get_raw_by_short_uuidDRead-only
Get Raw Subscription by Short UUID
Inputs: shortUuid (required), withDisabledHosts.
subscriptions_listCRead-only
Get all subscriptions
Inputs: size, start.
subscription_templates_createC
Create subscription template
Inputs: name (required), templateType (required).
subscription_templates_deleteCDestructive
Delete subscription template
Inputs: uuid (required).
subscription_templates_getCRead-only
Get subscription template by uuid
Inputs: uuid (required).
subscription_templates_listBRead-only
Get all subscription templates (wihout content)
Inputs: no named parameters.
subscription_templates_reorderC
Reorder subscription templates
Inputs: items (required).
subscription_templates_set_tagsC
Set tags of Subscription Template
Inputs: tags (required), uuid (required).
subscription_templates_tags_listBRead-only
Get tags of Subscription Templates
Inputs: no named parameters.
subscription_templates_updateC
Update subscription template
Inputs: uuid (required), name, templateJson, encodedTemplateYaml.
system_bandwidth_statsCRead-only
Get Bandwidth Stats
Inputs: tz.
system_configurationBRead-only
Get Remnawave Configuration. Returns some of the configuration values.
Inputs: no named parameters.
system_generate_x25519BRead-only
Generate 30 X25519 keypairs
Inputs: no named parameters.
system_healthCRead-only
Get Remnawave Health
Inputs: no named parameters.
system_http_statsCRead-only
Get HTTP Stats
Inputs: no named parameters.
system_metadataARead-only
Get panel version and build information
Inputs: no named parameters.
system_nodes_metricsCRead-only
Get Nodes Metrics
Inputs: no named parameters.
system_nodes_statisticsCRead-only
Get Nodes Statistics
Inputs: tz.
system_srr_matcherBRead-only
Validate a subscription response rules (SRR) config against the panel matcher. The body is the full responseRules config object, not an input string.
Inputs: responseRules (required).
system_statsDRead-only
Get Stats
Inputs: tz.
system_stats_digestARead-only
Get Stats Digest. Aggregated statistics for a datetime range [start, end): created and expired users, total traffic, traffic spent by users created within the range and new HWID devices. Per-user traffic history is stored with daily granularity (UTC), so the "traffic by new users" metric snaps to whole days at the range edges.
Inputs: end (required), start (required).
system_stats_recapDRead-only
Get Recap
Inputs: no named parameters.
users_accessible_nodesARead-only
Which nodes a user can actually reach: per node — config profile, active squads and their inbounds. Handy for debugging squad/inbound routing.
Inputs: userId (required).
users_bulk_all_extend_expirationADestructive
Extend expiration date for EVERY user by days
Inputs: extendDays (required).
users_bulk_all_reset_trafficADestructive
Reset used traffic for EVERY user
Inputs: no named parameters.
users_bulk_all_updateCDestructive
Update EVERY user at once
Inputs: tag, email, status, expireAt, +5 more.
users_bulk_deleteCDestructive
Bulk delete users by User IDs
Inputs: userIds (required).
users_bulk_delete_by_statusBDestructive
Delete ALL users that have the given status
Inputs: status (required).
users_bulk_extend_expirationC
Extend expiration date for specified users by days
Inputs: userIds (required), extendDays (required).
users_bulk_reset_trafficC
Bulk reset traffic users by User IDs
Inputs: userIds (required).
users_bulk_revoke_subscriptionC
Revoke users subscription by User IDs
Inputs: userIds (required).
users_bulk_updateC
Bulk update users by User IDs
Inputs: fields (required), userIds (required).
users_bulk_update_squadsC
Bulk update users internal squads by User IDs
Inputs: userIds (required), activeInternalSquads (required).
users_createA
Create a user. Credentials (vlessUuid/ssPassword/trojanPassword/shortUuid) are generated by the panel unless given — pass them explicitly for service users.
Inputs: expireAt (required), username (required), tag, email, +14 more.
users_deleteCDestructive
Delete user
Inputs: userId (required).
users_disableC
Disable user
Inputs: userId (required).
users_enableC
Enable user
Inputs: userId (required).
users_extend_expirationA
Extend user expiration date. If user status is EXPIRED, the new expiration date is calculated from the current date and the user becomes ACTIVE. If user status is ACTIVE, the given number of days is added to the existing expiration date. DISABLED and LIMITED users will be extended, but their status will not change.
Inputs: days (required), userId (required).
users_getCRead-only
Get user by ID
Inputs: userId (required).
users_get_by_short_uuidCRead-only
Get user by Short UUID
Inputs: shortUuid (required).
users_get_by_usernameCRead-only
Get user by username
Inputs: username (required).
users_listBRead-only
List users with offset pagination and optional TanStack-style filters. To find users by telegramId, email, tag, status etc. pass filters, e.g. [{"id":"telegramId","value":123456789}]. Users are identified by numeric id.
Inputs: size, start, filters, sorting, +2 more.
users_reset_trafficC
Reset user traffic
Inputs: userId (required).
users_resolveARead-only
Resolve a user by EXACTLY ONE of: id, shortUuid, username
Inputs: id, username, shortUuid.
users_revoke_subscriptionB
Revoke user subscription: rotates the subscription link (and credentials unless told otherwise)
Inputs: userId (required), shortUuid, revokeOnlyPasswords.
users_streamBRead-only
Get all users using cursor-based (keyset) pagination with filtering options
Inputs: tag, size, email, cursor, +4 more.
users_subscription_request_historyARead-only
Get user subscription request history, recent 24 records
Inputs: userId (required).
users_tags_listCRead-only
Get users tags
Inputs: no named parameters.
users_updateC
Update a user. Identify by id OR username.
Inputs: id, tag, email, status, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 204 tools
Tools are generally named by resource and action, but several overlapping getters/resolvers exist (e.g., users_get, users_get_by_username, users_get_by_short_uuid, users_resolve; multiple subscription getters; generic nodes_bulk_actions vs specific bulk tools). The sheer number of closely related bulk and stats tools creates selection friction, though descriptions usually clarify intent.
Names predominantly follow a snake_case resource_action pattern (users_list, nodes_create, hosts_update). Minor inconsistencies appear in singular/plural prefixes and special cases like api_request, auth_status, keygen_get, subscription_info, and metadata_node_get vs nodes_get.
204 tools is an extreme mismatch for an MCP server; even a comprehensive panel API can be exposed more compactly. This volume makes tool selection impractical and exceeds any reasonable agent context.
The surface covers the full Remnawave domain: users, nodes, hosts, config profiles, squads, subscriptions, templates, plugins, shared lists, billing, stats, and more, with CRUD and bulk operations. A raw api_request fallback further covers any unlisted endpoints, so no obvious gaps remain.
Maintenance
Related MCP Connectors
Rent Manager MCP server for ChatGPT, Claude and any AI agent: post charge, create work order, message tenant and list tenants in your own Rent Manager account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Rent Manager yourself; Cotlet does not store your password and you need no Rent Manager API key. About the official Rent Manager API: Rent Manager has an API that reads and writes your database, but it is not self-serve (checked 11 Oct 2026). Its public pages offer no key signup: access goes through the Integrations Partner Program or an API support request, and a developer then builds the connector. Setup and FAQ: https://cotlet.dev/integrations/rent-manager-api-mcp-server
ResMan MCP server for ChatGPT, Claude and any AI agent: list work orders, create work order, update work order status, list units and make-ready status, list leases, list move-outs, list prospects and list aged receivables in your own ResMan account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to ResMan yourself; Cotlet does not store your password and you need no ResMan API key. About the official ResMan API: ResMan has an API, but only for approved Integration Partners (checked 23 Oct 2026). A property manager cannot get a key for their own account, and ResMan has no official MCP server. Setup and FAQ: https://cotlet.dev/integrations/resman-api-mcp-server
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
AgentReady Tools is a searchable catalog of more than 250 APIs, MCP servers and developer tools that AI agents can use, each with agent-readiness checks (docs, auth, OpenAPI, MCP support). Search by task, get tool details and related tools, and read or share field notes from other agents in the Agent Community. Remote MCP endpoint: https://agentready-tools.com/mcp
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for Remnawave panel API. Manage VPN users, nodes, hosts, and system stats from Claude Code or any MCP-compatible client.341MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to manage a Remnawave panel through its full API, covering users, nodes, hosts, subscriptions, and more with configurable tool profiles and read/write token access.11 npmMIT
- AlicenseCqualityCmaintenanceEnables managing a Remnawave VPN panel from MCP clients, providing tools for users, nodes, subscriptions, statistics, billing, and system operations, plus resources and prompts for common admin tasks.190MIT
- AlicenseCqualityCmaintenanceEnables AI clients to drive the full Remnawave panel API, exposing one tool per method+path operation (users, nodes, hosts, subscriptions, inbound, bulk actions) plus search, describe, status, audit and metrics helpers. Read-only/read-write gating, deny rules, confirm-preview and dry-run, response secret redaction and an audit journal keep mutations controlled.222MIT