MCP Server For 3x Ui

@pyworkload

Basic information

About MCP Server For 3x Ui

MCP server for 3x-ui — an Xray/V2Ray proxy management panel. Exposes the 3x-ui HTTP API as MCP tools so LLMs can manage inbounds, clients, routing rules, Xray service, and server settings.

#v2ray-xray-3x-ui

MCP Server For 3x Ui config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "3x-ui": {
      "command": "go",
      "args": [
        "run",
        "github.com/pyworkload/3x-ui-mcp/cmd/xui-mcp@latest"
      ],
      "env": {
        "XUI_HOST": "http://localhost:2053",
        "XUI_USERNAME": "<your-username>",
        "XUI_PASSWORD": "<your-password>"
      }
    }
  }
}

MCP Server For 3x Ui tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mcp Server For 3x Ui?

An MCP server that exposes the 3x-ui (Xray/V2Ray proxy management panel) HTTP API as MCP tools, enabling LLMs to manage inbounds, clients, routing rules, Xray service, and server settings.

How to use Mcp Server For 3x Ui?

Add the server to your MCP config (claude_desktop_config.json or .mcp.json) with the go run command or a pre-built binary, and set the required environment variables: XUI_HOST, XUI_USERNAME, XUI_PASSWORD. Requires Go 1.23+ if using go run.

Key features of Mcp Server For 3x Ui

40 MCP tools covering the full 3x-ui API
Automatic session management with transparent re-authentication
Stdio transport for seamless LLM integration
Zero external dependencies beyond the MCP SDK

Use cases of Mcp Server For 3x Ui

Manage inbound connections: create, list, update, delete
Manage clients: add, update, delete, reset traffic, view IPs
Configure Xray routing rules and outbounds
Monitor server status and restart Xray or the panel
Reset traffic counters and clean depleted or expired clients

Frequently asked questions

What dependencies are required?

Go 1.23+ or a pre-built binary from the releases page.

How is the server configured?

Via environment variables: required `XUI_HOST`, `XUI_USERNAME`, `XUI_PASSWORD`, and optional `XUI_BASE_PATH` and `XUI_LOG_LEVEL`.

What transport does it use?

Stdio transport.

How does it authenticate with the 3x-ui panel?

Uses the provided admin username and password for session management with automatic re-authentication.

What can it not do?

The README does not specify limitations.

Comments

More Other MCP servers

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K