How do I install Marzban MCP?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Marzban MCP need an API key?

The publisher lists these environment variables: MARZBAN_BASE_URL, MARZBAN_USERNAME, MARZBAN_PASSWORD.

What transport does Marzban MCP use?

Marzban MCP runs locally over stdio.

When was Marzban MCP last checked?

Last checked 2026-11-09. Manage Marzban panels through the Model Context Protocol.

Marzban MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

MARZBAN_BASE_URL — URL of the Marzban panel.
MARZBAN_USERNAME — Marzban administrator username.
MARZBAN_PASSWORD — Marzban administrator password.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1MARZBAN_BASE_URL=<value> MARZBAN_USERNAME=<value> MARZBAN_PASSWORD=<secret> claude mcp add io.github.ilmar7786-marzban-mcp -- npx -y marzban-mcp@0.4.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.ilmar7786-marzban-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "MARZBAN_BASE_URL": "<value>",11        "MARZBAN_USERNAME": "<value>",12        "MARZBAN_PASSWORD": "<secret>"13      }14    }15  }16}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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 --> 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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Marzban MCP?

Does Marzban MCP need an API key?

What transport does Marzban MCP use?

When was Marzban MCP last checked?

Documentation

MarzbanSDK

How it fits together

Packages

Documentation

Contributing

License