Ilmar7786/marzban-sdk

**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
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
MIT © ilmar7786
If this project saves you time, consider giving it a ⭐ on GitHub .