MarzbanSDK
MCP serverAI & modelsOnce this app is added, your AI can manage Marzban panels for you. You describe what you need in everyday language, and your AI carries out the panel management work instead of you clicking through the panel yourself. It is based on the Marzban SDK.
Unavailable. This server has no hosted endpoint yet, so ahel can't serve it.
Add the app, then tell your AI which Marzban panel to work with and what you would like done. The underlying code is available at github.com/ilmar7786/marzban-sdk.
What your AI can do with it
- Manage your Marzban panels by asking in plain language
- Carry out panel administration tasks on your behalf
- Make changes to your panels without opening the panel interface yourself
- Handle routine panel management whenever you ask
From the project's README
As published by ilmar7786/marzban-sdk in README.md.
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 --> App
The 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
| Package | npm | Docker | What it is |
|---|---|---|---|
packages/sdk | marzban-sdk | — | The TypeScript SDK — auth, retries, resilient WebSocket reconnects, webhooks, lifecycle |
packages/mcp | marzban-mcp | ilmar7786/marzban-mcp | An MCP server exposing Marzban operations as tools for AI agents |
packages/cli | — | — | A CLI on top of the SDK — WIP, unpublished |
apps/docs | — | — | The documentation site |
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
Signals
- GitHub stars
- 25
- Forks
- 3
- Last commit
- Sep 2026
- Weekly downloads
- 488
Advanced
- Delivery
- marzban-mcp MCP server → your ahel gateway (mcp.ahel.ai) → every connected AI client.
- Catalog kind
- mcp-server
- Gateway key
io-github-ilmar7786-marzban-mcp- Source
- github.com/ilmar7786/marzban-sdk