Skip to content
MCP ThesaurusMCP Thesaurus

Marzban MCP

CommunityIncomplete39/100Claim

npm marzban-mcpstdioMITupdated 7d ago

A TypeScript toolkit for the Marzban API.

SourceWebsite25

What can you do with Marzban MCP?

MarzbanSDK

A TypeScript toolkit for the Marzban API.

CI license

Documentation Ā· SDK Ā· MCP Server

One typed API client 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 typed API client ā€” auth, retries, WebSocket log streams, webhooks
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