Advertise
MCP.so
Sign In
M

MCP Server For 3x Ui

@pyworkload

Repository

Basic information

Category

Other

Transports

stdio

Author

pyworkload

Submitted by

pyworkload

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

1

What dependencies are required?

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

2

How is the server configured?

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

3

What transport does it use?

Stdio transport.

4

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

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

5

What can it not do?

The README does not specify limitations.

Comments

More Other MCP servers

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Advertise