mcpbeat Sign in

Marzban MCP Server

by ilmar7786 Your server? Claim it
local only

Marzban MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 72 installs a week from npm. Last commit 21 Oct 2026.

Manage Marzban panels through the Model Context Protocol.

Installs per day peak 168 · avg 14 · +32% w/w
a month agotoday
72
Installs / week
npm · marzban-mcp
26
Stars
7 open issues
21 Oct 2026
Last commit
7 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 7 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command packages/mcp/src/shared/duration.ts:17
  const match = DURATION_PATTERN.exec(input.trim())

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add marzban-mcp -e 'MARZBAN_BASE_URL=<MARZBAN_BASE_URL>' -e 'MARZBAN_USERNAME=<MARZBAN_USERNAME>' -e 'MARZBAN_PASSWORD=<MARZBAN_PASSWORD>' -- npx -y marzban-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "marzban-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "marzban-mcp"
      ],
      "env": {
        "MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
        "MARZBAN_PASSWORD": "<MARZBAN_PASSWORD>",
        "MARZBAN_USERNAME": "<MARZBAN_USERNAME>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.marzban-mcp]
command = "npx"
args = ["-y", "marzban-mcp"]
env = { MARZBAN_BASE_URL = "<MARZBAN_BASE_URL>", MARZBAN_USERNAME = "<MARZBAN_USERNAME>", MARZBAN_PASSWORD = "<MARZBAN_PASSWORD>" }
.cursor/mcp.json
{
  "mcpServers": {
    "marzban-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "marzban-mcp"
      ],
      "env": {
        "MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
        "MARZBAN_PASSWORD": "<MARZBAN_PASSWORD>",
        "MARZBAN_USERNAME": "<MARZBAN_USERNAME>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "marzban-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "marzban-mcp"
      ],
      "env": {
        "MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
        "MARZBAN_PASSWORD": "<MARZBAN_PASSWORD>",
        "MARZBAN_USERNAME": "<MARZBAN_USERNAME>"
      }
    }
  }
}

Put your own values in place of <MARZBAN_BASE_URL> (URL of the Marzban panel), <MARZBAN_USERNAME> (Marzban administrator username), <MARZBAN_PASSWORD> (Marzban administrator password). The author’s registry entry marks them as required.

Alternatives to Marzban MCP

same job, measured the same way
ComfyUI MCP
by entityadam

Generate and manage ComfyUI media through the Model Context Protocol.

local only
Procm
by coder-ka

A Model Context Protocol (MCP) server for process management.

71 installs/wk local only
Machship MCP
by devkindhq

Model Context Protocol server for the Machship freight management platform

655 installs/wk local only
MCP Alertmanager
by jeanlopezxyz

A Model Context Protocol (MCP) server for Prometheus Alertmanager

79 installs/wk local only
MCP All
by antonytm

A Model Context Protocol server to run other MCP servers

87 installs/wk local only
Fiori MCP Server
by sap

SAP Fiori - Model Context Protocol (MCP) server

118 233 installs/wk local only
Admin MCP
by hellocoop

Model Context Protocol (MCP) for Hellō Admin API.

52 installs/wk local only
Trello MCP Server
by billnobill

Trello Model Context Protocol (MCP) Server for AI Agents

44 installs/wk local only

Marzban MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Marzban MCP?
Marzban MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package marzban-mcp was installed 72 times last week.
How do I connect Marzban MCP?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls marzban-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Marzban MCP?
The npm package marzban-mcp was installed 72 times in the last week. Week over week that is +32%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Marzban MCP open source?
Yes — it is published under the MIT licence, written in TypeScript, 26 stars on GitHub and 7 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.