datastore
Inspect and edit saved data for published Roblox games via Open Cloud, supporting read queries and confirmed writes for offline players only.
Instructions
Inspect/edit a PUBLISHED game's saved data via the Open Cloud DataStore API (server-side HTTP, no Studio runtime). READ actions: list_datastores, list_keys, get, list_ordered, get_ordered. WRITE actions (gated — need confirm:true and are blocked in read-only mode): set, delete, increment. ⚠ SESSION-LOCK WARNING: a live game server owns the keys of ONLINE players (ProfileStore session lock); the REST write path ignores that lock, so writing such a key either gets overwritten by the server's autosave or corrupts the live session. Only write keys for OFFLINE players. ⚠ SHARED BUDGET: since 2026-07-29 Open Cloud DataStore calls count against the SAME unified per-experience request budget as the live game's in-game DataStore calls (base 300 + CCU × multiplier per request type/minute) — heavy MCP-driven reads/writes can starve a running game; watch the quota: line when the API returns rate-limit headers. Needs an Open Cloud key with universe-datastores scopes (TUFAN_OPENCLOUD_KEY) and a published universe (auto-detected from game.GameId, or TUFAN_UNIVERSE_ID).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "datastore"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | max results per page | |
| order | No | sort for list_ordered (default asc; desc = top-first leaderboard) | |
| place | No | Target place (PlaceId or project name). Defaults to the bound/sole connected place. | |
| scope | No | DataStore scope (default "global") | |
| value | No | the JSON value to store (set) | |
| action | Yes | What to do. Reads: list_datastores, list_keys, get, list_ordered, get_ordered. Writes (need confirm true): set, delete, increment. | |
| cursor | No | pagination cursor / page token from a previous call | |
| prefix | No | name/key prefix filter (list actions) | |
| confirm | No | REQUIRED for write actions (set/delete/increment) — acknowledges the session-lock risk | |
| userIds | No | associated user ids to tag on the entry (set) | |
| entryKey | No | the entry key (required for get/set/delete/increment/get_ordered) | |
| allScopes | No | list keys across all scopes (list_keys) — mutually exclusive with scope | |
| attributes | No | entry metadata (set) | |
| incrementBy | No | amount to add (increment) | |
| matchVersion | No | only write if the current version matches (set) | |
| datastoreName | No | the DataStore name (required for standard entry actions) | |
| exclusiveCreate | No | only create if the key doesn't exist yet (set) | |
| orderedDataStore | No | ordered datastore name (list_ordered / get_ordered) |