{
  "markdown": "# vibie-mcp\n\nMCP server for [Vibie](https://vibie.io) — deploy static folders to permanent `*.vibie.page` URLs from Claude Desktop / Cursor / any MCP-compatible client.\n\n## Install\n\n### One-line auto setup (recommended)\n\n```sh\nnpx vibie-mcp setup\n```\n\nAuto-detects Claude Desktop (Windows Store + APPDATA / macOS / Linux) and Cursor (`~/.cursor/mcp.json`) configs, then adds the `vibie` entry. Restart the client and you're done.\n\n### Manual config\n\nIf auto setup doesn't fit your client, add this to your MCP config (`claude_desktop_config.json`, `~/.cursor/mcp.json`, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"vibie\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"vibie-mcp\"]\n    }\n  }\n}\n```\n\nAfter saving, fully quit and restart your client.\n\n## First-time auth\n\nOn first tool call, the server initiates an [OAuth 2.0 Device Authorization Grant](https://datatracker.ietf.org/doc/html/rfc8628). Your AI will receive instructions like:\n\n> Please open https://vibie.io/device?code=XXXX-YYYY in a browser, sign in with Google, and click **Authorize**. Then ask me to try again.\n\nAfter authorizing in the browser, ask your AI to retry the same request. The server stores a token in `~/.vibie/credentials.json` (chmod 0600) and reuses it for future calls.\n\nYou can revoke the token anytime at https://vibie.io/settings/api.\n\n## Tools\n\n- **`vibie_create_site`** — Upload a folder and create a new Vibie site. Auto-writes `.vibie/site.json` in the folder so future updates use the same site.\n- **`vibie_update_site`** — Re-deploy to an existing site. Reads slug from `.vibie/site.json` if not specified.\n- **`vibie_list_sites`** — List sites under your account.\n- **`vibie_get_site`** — Metadata for one site by slug.\n\n## How AI typically uses it\n\n```\nYou: \"Deploy this folder to vibie\"\nAI: → vibie_create_site({ folder: \".\" })\n    → Returns: https://my-folder-x7f2.vibie.page\n\nYou: \"Push my changes\"\nAI: Detects .vibie/site.json\n    → vibie_update_site({ folder: \".\" })\n    → Same URL, new content\n```\n\n## Folder structure\n\nWhat gets uploaded from a folder:\n\n- `index.html` + `style.css` + `js/`, `assets/`, etc — all included\n- Hidden files (`.git`, `.vibie`, `.DS_Store`) — automatically skipped\n- `node_modules/` — skipped\n- Limits: 100 MB per site, 500 files per upload, 25 MB per file (Vibie's server validates)\n\nA single HTML file (any name) also works — it gets auto-renamed to `index.html` on upload.\n\n## Env\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `VIBIE_API_BASE` | `https://vibie.io` | Override for local dev (`http://localhost:3000`) |\n\n## License\n\nMIT\n",
  "bytes": 2572,
  "sha": "8ab778b0af93f122dba9921dff37ef4d7623eef6318d7e0eda19e199de868bcb",
  "repo_slug": "shdomi8599/vibie-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_shdomi8599_vibie_mcp_43bfd242/readme"
}