MCP servercom.neblla/neblla

Archive an app nobody uses: its data is bundled onto the CDN and cleared from Neblla's database. It stays in the gallery and is restored automatically the next time anyone opens it

Read the message banned players see in this app, or change it by passing `defaultMessage`.

Bring-your-own-database: move where this app stores its players' data (saves, rooms, community) from Neblla's default store to the developer's own database. Actions: "status" (curr

Consume units of a player's purchased product from the backoffice (e.g. refund-by-hand, support fixes). Atomic: fails with insufficient_amount if the player has fewer units. The pl

Copy the behavioural settings (features, rooms policy, matchmaking, inbox, p2p, serverMode, permissions, theme, connections, ai…) from one of your apps onto another. Name, files, d

Create a new Neblla app. Returns the app ID (appId) to use in subsequent file upload operations. Recommended flow for a NEW app: 1) Call neblla_validate_requirements with the dec

Create a purchasable product for a Neblla app. type must be "one_time" (single purchase, fixed price) or "consumable" (quantity selector, price per unit). name should be a multi-la

Create a predefined room (it exists before anyone joins). Name: A-Z 0-9 _ - (stored uppercase); LOBBY is reserved. `permanent: true` keeps it (and its data) when it empties.

For safety the MCP never deletes accounts directly. Returns a URL for the user to visit and confirm deletion from the Neblla dashboard.

Permanently delete an app and all its files.

Permanently remove a communication from a user's thread. The end user is notified via a `communicationDeleted` socket event so their UI updates in real time.

Delete a single file from an app.

Permanently delete a product from a Neblla app.

Delete a persistent room and its stored data. If people are inside it right now the session continues and the room disappears when it empties. LOBBY cannot be deleted. Irreversible

Delete (soft) one chat message from a room, as the developer. Players see it removed.

Add an email to the developer's account (it stays pending until its inbox owner clicks the confirmation link), or resend that confirmation. Removing emails and changing the primary

Read the developer's profile (name shown as app owner, dashboard language, whether a Claude API key is saved, emails on the account) or change `name` / `lang`. Changing the name al

Drafts: a private copy of an app (id "_<appId>") to change files and settings without touching the live app. "info" says whether one exists; "create" makes it (edit it by passing i

Everything about ONE app: its full config and state (features, rooms, quota and credits today, subscription, gallery, community, ai…), every URL it answers at (by id and slug on ea

Returns the canonical public URL for a Neblla app in the gallery. ALWAYS call this after neblla_create_app — never construct the URL yourself. Apps are published and browsed at pla

The app's resolved community configuration (mode, who publishes, limits, categories, content types, report threshold) plus how much of its community storage cap is used.

Fetch one community entry WITH its payload (the dev-defined JSON), whatever its status, plus its user reports (open count, count by reason, and each report with an opaque reporter

Get the content of a specific file. Text files (HTML, CSS, JS, JSON, SVG, plain text) are ALWAYS returned as UTF-8 strings — never base64. Binary files (images, fonts, audio) are r

Fetch the Neblla developer guide (llms.txt), split by topic so you read only what the app uses. Call this BEFORE designing or writing any code for a Neblla app — at minimum the `co

Read a room's chat history (newest first, paginated) for moderation. Returns the players' messages in clear: only use it when the developer asks to review a room.

Fetch the full record of a single end user — their saved data, public info, purchases, and communications thread. Use the `_id` from neblla_list_users / neblla_search_users_by_emai

Keep an app files in sync with a GitHub repo. The repo becomes the source of truth: editing the app files in Neblla is blocked while linked (edit in the repo and push). Actions: "r

List all apps owned by the authenticated developer.

List communications across ALL users of an app, filtered and sorted. The most useful tool for triaging an inbox: show only unread, only messages from users (not the dev), only flag

List the community entries (user-published content, neblla.community) of an app from the backoffice, any status. Use it to triage the moderation queue: status "pending" is what awa

List all files staged for an app. Returns path, mimeType, size, and timestamps for each file.

List the app-level moderators (per-app user ids). App moderators manage rooms of any type and moderate the community.

List all products for a Neblla app.

List the gallery reviews of an app (rating 1–5, text, language, author display name, the developer's reply) plus the average, count and 1–5 distribution. Newest first.

List the persistent / predefined rooms of an app with their type, owners, whitelist, moderators, data, message count, last activity and how many users are in each one right now.

List end users of an app — the people who connected through the SDK, NOT the developer's own account. Use this as the entry point for the backoffice flow: it returns a paginated li

Moderate a community entry as the app owner: approve or reject a pending entry, remove a published one, or restore a rejected/removed one. `reject` and `remove` require a `reason`

Rename or move a file within an app. oldPath is the current path, newPath is the destination.

The developer's payout account (Stripe Connect), needed to sell products inside their apps. "status": none | pending | active | restricted, with chargesEnabled / payoutsEnabled. "o

Publish a Neblla app to the public gallery. BEFORE calling this tool you MUST follow these steps with the user: 1) Ask for the app title and a short description (1-3 sentences) in

Publish a community entry AS YOURSELF — owned by your own user in the app (the app user whose email is your developer email; log into the app once first). Use it to seed a communit

Publish (or replace) the developer's public reply to a review; pass `text: ""` to delete the reply. The reply is shown in the gallery, translated into the reviewer's language when

Find users of an app by a partial email match (min 2 characters). Returns the matching user docs with email, communications, data, stats, and language. Use neblla_list_users for fu

Send a message from the developer to a specific end user. The user receives it live via the SDK's `communicationUpdated` event if connected, and on next reconnect otherwise. Option

Set a player's ban state in this app: "none" (lift), "banned" (the app shows the ban message and blocks play), "terminated" (wipes the player's local data in the browser and discon

Toggle the "important" flag on a communication. This is dev-only metadata and is NOT broadcast to the end user — use it to bubble messages to the top of your own triage view.

Mark a specific communication as read or unread (from the developer's side). The end user is notified live via a `communicationRead` socket event if connected.

Make a player an app moderator (`moderator: true`) or remove them (`false`). `userId` is the per-app user id (from neblla_list_users), not an email.

Check, set or clear the app's public slug (the readable name in play.neblla.com/<slug>). `checkOnly: true` only tells whether it is valid and free. `slug: null` removes it (old slu

Local backup of an app's files before risky edits. action "create" copies every file to <path>_copy (replacing any previous snapshot); "rollback" restores the copies over the curre

Remove an app from the public gallery. The app keeps its files and URL — only its public listing is hidden. Use neblla_publish_app to re-publish.

Update an app's configuration. Pass only the fields you want to change. Use addDomain/removeDomain to mutate the allowed-origins list atomically without overwriting other entries.

Update an existing product. Pass only the fields to change. Use this to adjust price, rename, or republish a product without losing its productId — changing the id would break chec

Change a room: replace its shared `data` (players in the room receive it live) and/or its `moderators` list. Replacing data overwrites the live game state of that room — confirm wi

Replace the `data` object for a specific end user (the same object the SDK's neblla.save() reads/writes). Use sparingly: this overwrites the user's saved state and the change is br

Upload or update a file for an app. Pass text files (HTML, CSS, JS, TS, JSON, SVG) as raw UTF-8 text with encoding="utf8" (the default) — do NOT base64-encode them, even if they co

Walk the SAME decision map the Neblla dashboard wizard uses, before creating an app. STRONGLY RECOMMENDED before neblla_create_app on any new-app request (skip it only for edits/fi