Marzban MCP server
io.github.Ilmar7786/marzban-mcp·v0.4.0·26 starsManage Marzban panels through the Model Context Protocol.
not scanned yet
26 stars23 downloads/wk
Reviews
Write oneNobody has reviewed Marzban MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Marzban MCP tools
No tool declarations could be read from the package source. They show once the server is installed.
How Marzban MCP compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 68% of 4,461 AI and agents servers
- GitHub stars
- 26
- more than 90% of 2,713 AI and agents servers
- Downloads a week
- 23
- more than 9% of 1,554 AI and agents servers with a package
Release history: 2 versions in the registry since 2026-09-06, latest 2026-10-21, typically one every 45 days.
Install Marzban MCP in Claude Code, Cursor or VS Code
Runs npx -y marzban-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add marzban-mcp -- npx -y marzban-mcp
What the publisher says
From the Marzban MCP repository's README, as published. We do not edit it. Read it on GitHub
MarzbanSDK
A TypeScript toolkit for the Marzban API.
Documentation · SDK · MCP Server
One TypeScript SDK for Marzban, and everything built on top of it. Fix a bug or add an endpoint in the SDK, and the MCP server, the CLI, and every app built on it get it for free.
How it fits together
flowchart LR
Panel(["Marzban Panel"])
SDK["marzban-sdk"]
MCP["marzban-mcp<br/>MCP server"]
CLI["marzban-cli<br/>CLI · WIP"]
App["Your app<br/>Node · Bun · Deno · Browser"]
Agents(["Claude · Cursor · any MCP client"])
Panel <--> SDK
SDK --> MCP --> Agents
SDK --> CLI
SDK --> AppThe SDK talks to your Marzban panel. The MCP server and CLI are just clients of that same SDK — same auth, same retries, same typed errors — so they never drift from each other or from your own code.
Packages
Each publishable package has its own version, README.md, changelog and release tags (sdk-v, mcp-v, cli-v*).
Documentation
Full guides, configuration reference and the complete typed API live at ilmar7786.github.io/marzban-sdk.
For how the repository itself is built — architecture, conventions, testing, CI and releases — see docs/.
Contributing
Contributions are welcome — see CONTRIBUTING.md for how to submit a patch. Found a bug or have an idea? Open an issue.
License
MIT © ilmar7786
If this project saves you time, consider giving it a ⭐ on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Marzban MCP: common questions
- Is Marzban MCP server safe?
- Mostly: it is graded B (83/100). Read the Marzban MCP safety report
- How do I install Marzban MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Marzban MCP need an API key?
- Yes. The registry entry asks for
MARZBAN_PASSWORD. - Is Marzban MCP maintained?
- The last commit was 34 days ago (2026-10-02). The latest release is v0.4.0.
- How does Marzban MCP compare with other AI and agents MCP servers?
- safety score 83/100 (higher than 68% of 4,461 AI and agents servers); github stars 26 (more than 90% of 2,713 AI and agents servers); downloads a week 23 (more than 9% of 1,554 AI and agents servers with a package). Full comparison.