{
  "markdown": "<div align=\"center\">\n\n<img src=\"https://raw.githubusercontent.com/Ilmar7786/marzban-sdk/main/apps/docs/src/app/icon.svg\" alt=\"MarzbanSDK\" width=\"80\">\n\n# MarzbanSDK\n\n**A TypeScript toolkit for the [Marzban](https://github.com/Gozargah/Marzban) API.**\n\n[![CI](https://github.com/Ilmar7786/marzban-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/Ilmar7786/marzban-sdk/actions/workflows/ci.yml)\n[![license](https://img.shields.io/github/license/Ilmar7786/marzban-sdk?color=8b5cf6)](./LICENSE)\n\n[**Documentation**](https://ilmar7786.github.io/marzban-sdk) · [**SDK**](./packages/sdk) · [**MCP Server**](./packages/mcp)\n\n</div>\n\n---\n\nOne TypeScript SDK for Marzban, and everything built on top of it. Fix a\nbug or add an endpoint in the SDK, and the MCP server, the CLI, and every app\nbuilt on it get it for free.\n\n## How it fits together\n\n```mermaid\nflowchart LR\n    Panel([\"Marzban Panel\"])\n    SDK[\"marzban-sdk\"]\n    MCP[\"marzban-mcp<br/>MCP server\"]\n    CLI[\"marzban-cli<br/>CLI · WIP\"]\n    App[\"Your app<br/>Node · Bun · Deno · Browser\"]\n    Agents([\"Claude · Cursor · any MCP client\"])\n\n    Panel <--> SDK\n    SDK --> MCP --> Agents\n    SDK --> CLI\n    SDK --> App\n```\n\nThe SDK talks to your Marzban panel. The MCP server and CLI are just clients\nof that same SDK — same auth, same retries, same typed errors — so they never\ndrift from each other or from your own code.\n\n## Packages\n\n| Package                          | npm                                                        | Docker                                                                    | What it is                                                                              |\n| -------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |\n| [`packages/sdk`](./packages/sdk) | [`marzban-sdk`](https://www.npmjs.com/package/marzban-sdk) | —                                                                         | The TypeScript SDK — auth, retries, resilient WebSocket reconnects, webhooks, lifecycle |\n| [`packages/mcp`](./packages/mcp) | [`marzban-mcp`](https://www.npmjs.com/package/marzban-mcp) | [`ilmar7786/marzban-mcp`](https://hub.docker.com/r/ilmar7786/marzban-mcp) | An MCP server exposing Marzban operations as tools for AI agents                        |\n| [`packages/cli`](./packages/cli) | —                                                          | —                                                                         | A CLI on top of the SDK — WIP, unpublished                                              |\n| [`apps/docs`](./apps/docs)       | —                                                          | —                                                                         | The documentation site                                                                  |\n\nEach publishable package has its own version, `README.md`, changelog and\nrelease tags (`sdk-v*`, `mcp-v*`, `cli-v*`).\n\n## Documentation\n\nFull guides, configuration reference and the complete typed API live at\n**[ilmar7786.github.io/marzban-sdk](https://ilmar7786.github.io/marzban-sdk)**.\n\nFor how the repository itself is built — architecture, conventions, testing,\nCI and releases — see **[`docs/`](./docs/README.md)**.\n\n## Contributing\n\nContributions are welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md) for how to\nsubmit a patch. Found a bug or have an idea?\n[Open an issue](https://github.com/Ilmar7786/marzban-sdk/issues).\n\n## License\n\n[MIT](./LICENSE) © [ilmar7786](https://github.com/Ilmar7786)\n\n<div align=\"center\">\n<sub>If this project saves you time, consider giving it a ⭐ on <a href=\"https://github.com/Ilmar7786/marzban-sdk\">GitHub</a>.</sub>\n</div>\n",
  "bytes": 3847,
  "sha": "444395b5da23b777a167a5a3910ee98f72d87d0958bbcc033fcbcde2af1ed36a",
  "repo_slug": "ilmar7786/marzban-sdk",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ilmar7786_marzban_mcp_4f81c0d8/readme"
}