Skip to main content

Reference

This page covers the developer server at https://mcp.blazium.games/developer. https://mcp.blazium.games/mcp still reaches that server. The player server is on Player MCP.

uid accepts a game uid or its vanity name. "Account only" means a project-bound token is refused with 4030. "Write" means the token needs mcp:write or the narrower write scope for that tool's group (see Scopes). Buying, wallet, and library are only on the player server. A developer token that purchases or tops up gets 4034.

Tools​

ToolInputsNotes
get_profilenoneCurrent user. Account only
list_gamesnoneGames you own or administer, and pending admin invites
get_gameuidOne game's settings
get_lobbyuidLobby settings and published packs: enabled, relay or scripted, TURN, the active checksum, and pack history
set_lobbyuid (required), enabled, lobby_type (relay or scripted), ice_enabledOnly the fields you pass change. Write
create_gamename (required), tagline, description, visibility, asset_type, vanity_name, adult, indexable, parentNew store page. Tools, mods and plugins need a parent before they can go public. Needs developer mode (4105). Account only, write
update_gameuid (required), name, tagline, description, visibility, asset_type, adult, indexable, parentUpdate a page; only the fields you pass change. Setting public fails with 4225 until the listing check passes. An empty parent object clears the parent. Write
get_game_analyticsuid, optional buildVisitor analytics, the 30-day downloads block, and registered funnel events (count, unique devices, daily series). See Download analytics and Progress
get_web_playeruidBrowser player settings: enabled, full build, demo build, size, embed, Discord, Telegram, connect hosts, and share links
set_web_playeruid, optional enabled, full_build_id, demo_build_id, width, height, fullscreen, mobile, click_to_play, hide_branding, start_fullscreen, embed_enabled, embed_domains, embed_game, connect_domains, discord_enabled, application_id, public_key, telegram_enabled, telegram_bot_id, reddit_enabled, reddit_app_name, youtube_enabled, tiktok_enabled, tiktok_client_key, douyin_enabled, douyin_app_id, wechat_enabled, wechat_app_id, offer_build_id, for_sale, price_cents, is_demo, embed_supported, platforms, share_build_id, share_enabledChooses the full build, an optional demo, the player size, launches, and one build's price or designation. Upload designations, for_sale, price_cents, is_demo, embed_supported, web_pack, and export_targets with the build file. Store shelves steam, gog, epic, and itch can be priced. A launch host or an embeddable build cannot. An embedded game cannot be sold. The price is not a separate checkout. Instagram is not a launch. Covered by mcp:build.write
set_host_fetchuid, build_id, enabled, optional rotateTurns on, turns off, or rotates the file URL a host uses to download one web build. TikTok, Douyin, WeChat, YouTube, Reddit, Newgrounds, CrazyGames, Poki, Meta, and GameDistribution can have one. Discord, Telegram, Steam, GOG, Epic, and itch do not. The old address fails after it is turned off or rotated. The player server does not return this URL
get_achievementsuidAchievement definitions and their writers
set_achievementsuid, achievementsReplaces the achievement list. Covered by mcp:catalog.write
get_statsuidInteger stats, their op, and their writers
set_statsuid, statsReplaces the stat list. Covered by mcp:catalog.write
get_funnelsuidRegistered analytics events and their writers
set_funnelsuid, funnelsReplaces the funnel list. Covered by mcp:catalog.write
get_presence_writersuidWho may set the short presence status
set_presence_writersuid, writersReplaces that list. Covered by mcp:catalog.write
list_server_keysuidGame server key prefixes and roles. No secrets
request_server_keyuid, role (game_server or private_server)Returns the secret once
revoke_server_keyuid, key_idRevokes one game server key
list_itemsuid, optional cursorOne page of item definitions. next is the cursor for the following page. Covered by mcp:read
create_itemuid, itemdef_id, name, optional platform type, stats, socketsCreates a definition. unique is only set here. Covered by mcp:catalog.write
update_itemuid, itemdef_id, nameEdits a definition. unique cannot change. Covered by mcp:catalog.write
give_itemsuid, itemdef_id, quantity, request_id, recipientsGives one item to handles or emails. Covered by mcp:catalog.write
list_item_setsuid, optional cursorOne page of named sets. Bonuses are stored, not applied
upsert_item_setuid, name, optional set_uid, pieces, bonusCovered by mcp:catalog.write
sync_item_schemauid, mode (sync, overwrite, or addon)Updates Steam item definitions. Does not move player items. Covered by mcp:steam.manage
set_inventory_flagsuid, confirm, optional inventory, transferTurns a switch on. Neither switch can be turned off. Covered by mcp:steam.manage
list_mint_keysuid, optional cursorOne page of names and prefixes. Covered by mcp:keys.manage
request_mint_keyuid, nameReturns the 128-character secret once. It can mint, set stats, socket, unsocket, and use items. A player token cannot
rename_mint_keyuid, key_id, nameCovered by mcp:keys.manage
revoke_mint_keyuid, key_idCovered by mcp:keys.manage
list_game_crashesuidRecent crash reports
get_crashuid, crash_idOne crash report including stack excerpt
request_crash_downloaduid, crash_id, kindPrivate download URL for dump, log, or stack, valid for 1 hour. Covered by mcp:crash.read
get_crash_reporteruidReads crash webhooks: enabled, webhook URLs, and that game's signing key. The key is not the bug reporter key. Covered by mcp:crash.read
set_crash_reporteruid, optional enabled, webhooks, refresh_signing_keyTurns crash webhooks on, replaces up to five https URLs, or refreshes the signing key. A refresh returns only the new key. Covered by mcp:crash.write
list_mcp_keysnoneAccount key prefixes only. Account only
get_setupnoneAccount, games, public URLs, latest build_id. No secrets. Account only
get_deploy_infouidUpload, crash, and page URLs, and the build list. get_deploy_info lists the short code only. It does not include the access token or the secret
list_game_buildsuidBuilds. build_id is the build UID for CI and crash reporters (X-Build-Id), not a version string
delete_game_builduid, build_id, optional idempotency_keyDeletes one build. The owner approves this. Write
add_game_adminuid, invite, optional idempotency_keyInvites an admin. Only the owner can invite, and the owner approves this. Write
remove_game_adminuid, admin_idRemoves an admin. Only the owner can remove one. Write
delete_gameuid, optional idempotency_keyDeletes a game the caller owns. The owner approves this. Write
get_account_analyticsnoneAnalytics across the signed-in account's games. Account only
get_game_builduid, build_idOne build, its files, and crash reporter headers
request_mcp_keyidempotency_key (optional)New account key. Revokes all previous account keys. Needs the human's approval. Account only, write
request_deploy_keyuid, idempotency_key (optional)Creating a new deploy key replaces the previous one. Uploads that used the old key stop working. Returns both values once, after the project owner approves. The access token can be copied later from the Deploy keys tab. The secret cannot. Write

Releases and trust​

Every build file belongs to a channel: stable (the default), beta, dev, or your own lowercase name. Each channel points at one build. A clean upload moves beta, dev, and custom channels forward on its own. Stable waits until you call promote_build. rollback_channel moves a channel by hand. Players see the build each channel points at, plus anything uploaded after the last move. dev is only visible to the game's owner and admins, and beta only to players who joined the beta.

ToolInputsNotes
list_channelsuidEach channel's build, expiry, beta subscriber count, and the last 50 promote, rollback, and upload events
promote_builduid, channel, build_id, expires_in_hours (0-2160), idempotency_keyPoints a channel at a build whose files passed the virus scan. expires_in_hours hides the channel from players after that. Promoting to stable needs the human's approval. Write
rollback_channeluid, channelMoves the channel back to the build it pointed at before. Nothing is deleted. Write
list_crash_groupsuidUp to 100 crash groups, most recently seen first, with first_seen, last_seen, counts per build, and a sample_crash_id for get_crash
get_build_provenanceuid, file_uidUploader, how it was uploaded (deploy_key with an 8-character key_ref, or website), upload time, checksum, and scan history. Never returns a secret

Crash groups use the top stack frames once a minidump has been stackwalked, and the crash message, app version, and OS before that. A new report can take a few minutes to join a group.

Build health, symbols and bundle check​

MCP never uploads files. Symbols and builds are uploaded with the chauffeur CLI and the game's deploy key. Store images are uploaded with chauffeur or on the game's edit page on the website. These tools read and delete them.

ToolInputsNotes
get_build_healthuidThe last 50 builds with devices, boot_ok, crash_on_boot, median_session_seconds and band over the last 30 days, plus the listing's public band and what each band means. See Launch health
list_build_symbolsuid, build_idBreakpad symbol files for a build: module_name, debug_id, os, arch, size, checksum, and the chauffeur symbols command to upload more
delete_build_symbolsuid, build_id, symbol_uid (optional)Deletes one symbol file, or all of the build's symbol files when symbol_uid is empty. Write (mcp:build.write)
upload_symbols_infouid, build_idThe exact chauffeur symbols command for the build, its limits, and a link to Symbols. Uploads nothing
bundle_checkuid, build_idInformational. Compares the files inside the build's zip with asset packs sold on the store and reports each match as owned, licensed, attribution (cc-by, credit needed) or unlicensed, with sample paths
mod_compatuid (a mod), game (optional)Compares the mod's engine compatibility with the engine version of each supported game's current builds, per channel and platform: compatible, incompatible or unknown

Editions​

A game can sell up to 8 editions. When it has any active edition, its listed price is the cheapest one and set_game_price can't change it (4164). Owners upgrade by paying the difference, at least 50 cents. See Selling.

ToolInputsNotes
list_skusuidEditions with slug, name, kind, price_cents, active, sort_order and, for bundles, bundle_asset_uids
upsert_skuuid, sku_uid (to replace), slug, name, description, kind, price_cents (99-50000), bundle_asset_uids, active, sort_order (0-100)kind is standard, deluxe, beta_access (also grants the beta channel) or bundle (also grants 1 to 10 of your other listings). Without sku_uid it creates one. Write (mcp:money)
delete_skuuid, sku_uidRetires an edition. Owners keep it; nobody can buy it any more. Write (mcp:money)

Player feedback​

Players review games they own and file bug tickets from the player server or the store page.

ToolInputsNotes
list_reviewsuid, unreplied, pageReviews, newest first, with the summary: count, enjoyed, quality_avg, quality_counts (1 to 5), and would_play_with_friends. unreplied lists only reviews without a reply
get_review_reporteruidReads new-review webhooks: enabled, webhook URLs, and that game's signing key. The key is not the sale, crash, or bug reporter key. Covered by mcp:read
set_review_reporteruid, optional enabled, webhooks, refresh_signing_keyTurns new-review webhooks on, replaces up to five https URLs, or refreshes the signing key. A refresh returns only the new key. Covered by mcp:catalog.write
reply_to_reviewuid, review_uid, textPublic reply shown under the review on the store page (up to 2000 characters). Empty text removes it. Write
list_bug_ticketsuid, status (open, fixed, unidentified, closed), page50 tickets a page, newest first, with counts by status. Follow next_page until it is absent. has_screenshot and has_log say which files exist. A dump or log also has a crash_id for get_crash and request_crash_download
get_bug_ticketuid, bug_uidOne ticket, including has_screenshot and has_log
request_bug_screenshotuid, bug_uidA one-hour url for the screenshot. The tool returns the link, not the image
get_bug_loguid, bug_uid, offsetOne page of the log, at most 16 KiB. Call again with next_offset until it is absent
update_bug_ticketuid, bug_uid, status (open, fixed, unidentified, or closed)Sets status. Covered by mcp:bugs.write. Fixed and unidentified can show an in-game notice. Closed stays silent in the game.
get_bug_reporteruidReads the in-game reporter: enabled, daily cap, webhooks, and that game's signing key. Covered by mcp:bugs.read
set_bug_reporteruid, optional enabled, daily_cap, webhooks, refresh_signing_keyTurns the reporter on, sets the cap (1–10000), replaces up to five webhook URLs, or refreshes the signing key. A refresh returns only the new key. Covered by mcp:bugs.write
get_steam_authuidReads whether Steam auth is on, the app id, and whether the Web API key and ticket secret are stored, plus who set each and when. Never returns those secrets. Covered by mcp:steam.manage
set_steam_authuid, optional enabled, confirm, app_id, web_api_key, ticket_secretWrites the app id and the two secrets, and turns auth on when all three are stored. enabled: false deletes both secrets only when confirm is true. Covered by mcp:steam.manage
unlink_steamuid, confirmUnlinks the game from Steam. confirm only after the human agrees. Covered by mcp:steam.manage
rotate_steam_keyuid, confirmReplaces the Steam Web API key. The new key is returned once. confirm only after the human agrees. Covered by mcp:steam.manage
resync_steamuid, confirm, optional groups, web_api_keyImports the chosen Steam groups again. confirm only after the human agrees. Covered by mcp:steam.manage
import_steam_gameapp_id, web_api_key, confirm, optional groups, uidImports a Steam store page into a new or existing listing. confirm only after the human agrees. Needs developer mode
set_anonymous_downloadsuid, enabled, confirm_no_licenseTurns the switch on or off. When on, signed-out visitors can download the files and play the full web build and the web demo, with no license. Turning it on needs confirm_no_license after the human agrees. Needs mcp:write. A missing confirm is 4109. A paid game or an edition is 4113. A price while it is on is 4114
set_adult_contentshow, confirm_18Shows or hides adult listings for this account. Turning them on needs confirm_18 after the human confirms they are 18 or older

Only the game's owner and admins can read bug tickets and download their attachments.

Paid copyright (DMCA) notices that name the account's content. Notices appear only once the claimant has paid. See Copyright (DMCA) notices.

ToolInputsNotes
list_copyright_noticesnoneNotices about the account's content: uid, reference, status (open, accepted, rejected, resolved, closed), claimant, company, filing and decision dates, and how many of the account's links each names. open counts notices still under review
get_copyright_noticeuid (from list_copyright_notices)One notice: the claimant's name, company and email, the work described, the statements and signature, the account's links it names and whether those listings were disabled, staff messages, the decision, and reply_to. Read only; the human replies to staff by email at reply_to with the reference in the subject

Dependencies, compatibility and license​

These show on the store page as Uses / Used by, License and Works with, and players filter search_catalog by them.

ToolInputsNotes
declare_dependencyuid, target_uid, kind (uses, supports, or made_with), removeLinks your listing to another public listing: it uses that asset pack or plugin, it's a mod or plugin that supports that game or tool, or it was made with that tool. Up to 50 links. remove drops one. Write
list_dependentsuidWhat a public listing uses (uses) and which public listings declared a link to it (used_by), with its license_kind and compat
declare_engine_compatuid, compat (up to 10 of engine, min_version, max_version, renderer, platform)Replaces the list; an empty list clears it. Either version may be empty to leave that end open, and a max_version of 4.3 covers 4.3.x. Write
declare_licenseuid, license_kindcc0, cc-by, cc-by-sa, paid, source-available, or proprietary; empty clears it. Write

Tools, mods and press​

A tool, mod or plugin names the game it is for with parent on create_game or update_game: {"game": "uid-or-vanity"} for a game or application on Blazium Games, or {"external_name": "...", "external_url": "https://..."} for one that isn't. The parent's store page lists it under Tools and utilities or Mods and plugins. See Listings and search.

ToolInputsNotes
set_mod_settingsuid, install_path, loader, instructionsMods and plugins only (4234 otherwise). install_path is relative to the game folder (for example mods/my-mod), loader a lowercase slug such as bepinex, instructions markdown up to 8000 characters. Replaces all three. Write
get_press_kituidThe press kit behind the listing's /press page and press.zip
set_press_kituid, release_date, website_url, press_email, trailer_url, history, features, awards, links, quotes, creditsReplaces the whole press kit; fields you leave out are cleared, so read it with get_press_kit first. Links must be https. Up to 20 features, awards, links and quotes, 50 credits. See Press kit. Write
hide_community_taguid, tag, showHides a player-suggested tag from the store page, or shows it again with show. Without tag it lists every suggestion with its vote count. See Community tags. Write
get_store_linksuidThe listing's links to its pages on other stores, shown as Also on, and every supported store with its allowed hosts
set_store_linksuid, store_links (platform, url)Replaces every store link; stores you leave out are removed and an empty list clears them, so read them with get_store_links first. One per store: steam, gog, epic, itch, humble, microsoft, playstation, nintendo, apple, google_play, or gamejolt, each an https link on that store's own site (4238 otherwise). See Other stores. Write

Game chat​

Each game has an IRC channel on irc.blazium.online. The owner and accepted admins moderate it. See Chat for publishers.

ToolInputsNotes
get_game_chatuidThe channel name (irc_channel), whether guests may join (chat_guests), and who is banned or muted with when each mute ends
set_chat_guestsuid, guestsLets people without a license join the channel. Guests can read but can't talk until they own the game. Write
ban_chat_useruid, usernameBans a user from the channel until unbanned and removes them right away. The owner, admins, and blazium can't be banned. Write
unban_chat_useruid, usernameLifts a ban. Write
suspend_chat_useruid, username, minutes (1-43200)Mutes a user for up to 30 days; they can still read. Write
unsuspend_chat_useruid, usernameLifts a mute. Write

Game keys​

Keys give a game to someone for free, for press, bundles, or giveaways. Each code works once and adds the game to the redeemer's library (a license with source key). Players redeem at blazium.games/redeem or with redeem_key on the player server. Pools can also be managed on the Game keys tab of the project page.

ToolInputsNotes
create_key_pooluid, name, campaignA named pool, such as Press or a bundle. Up to 50 per game. Write
grant_keysuid, pool, n (1 to 5000), campaign, idempotency_keyCreates n codes. They come back once, as a csv_url that can be downloaded one time within an hour; the codes are stored hashed and can't be shown again. More than 100 at once needs the owner's approval (see below). Write
create_gift_linkuid, pool, noteA single-use https://blazium.games/redeem/... link for one person, shown once. Write
list_key_poolsuidPools with size, redeemed, unredeemed, and gift_links

Approvals for risky actions​

Over MCP, rotating an account or deploy key, deleting a deploy key, creating more than 100 game keys at once, adding a project admin, promoting to stable, and deleting a game or build wait for the account owner, even with full access. The call returns HTTP 202 with approval_required: true, code 4214, email_sent, and an approval object whose uid you pass as approval_id and whose confirm_url the owner can open. The owner also gets an email with the link and a 6-digit code. Once get_approval says approved (or after confirm_approval with the code), repeat the call with the same idempotency_key; without one, the same agent repeating the same action reuses the pending approval. Each approval works once and expires if nobody decides. Project tokens can't use get_approval or confirm_approval (4030), so approve those from the email. On the website these actions don't need an approval.

Scopes​

mcp:read and mcp:write cover every developer tool except anticheat. OAuth consent can grant narrower scopes instead:

ScopeCovers
mcp:catalog.writeGame pages, taxonomy, similar titles, lobby settings, achievements, stats, funnels, presence writers, dependencies, engine compatibility, license kind, media, review replies, new-review webhooks, mod settings, press kits, community tags
mcp:build.writeBuilds, channels, deploy info, scan status, symbols, bundle check
mcp:crash.readCrash reports, crash groups, crash analysis, and reading the crash webhook setting and signing key
mcp:crash.writeChanging crash webhooks and refreshing the signing key. Also covers the crash read routes
mcp:bugs.readListing bug tickets and reading the in-game bug reporter
mcp:bugs.writeUpdating bug tickets and changing the in-game bug reporter. Also covers the read routes
mcp:steam.manageReading and changing Steam auth settings. The Web API key and ticket secret can be set and are never returned
mcp:analytics.readVisitor analytics and events
mcp:keys.manageDeploy keys, MCP keys, game server keys, MCP access for admins, and project admins
mcp:moneyPricing, editions, sales, sale and refund webhooks, game keys and gift links, wallet, purchases, library, downloads
mcp:anticheatAnticheat for one game. Not included in mcp:read, mcp:write, or Full access. See Anticheat.

Every developer token can read the profile, account, and game pages. A write scope also reads its own group; the crash and analytics scopes also cover their actions. A call outside the token's scopes returns 4073, or 4031 if the token has no write scope at all. The consent page offers presets: Store page (mcp:read mcp:catalog.write), CI (mcp:read mcp:build.write), Crash triage (mcp:crash.read mcp:crash.write mcp:analytics.read), Bugs (mcp:bugs.read mcp:bugs.write), Steam (mcp:steam.manage), Keys (mcp:read mcp:keys.manage), Money (mcp:read mcp:money), Anticheat (mcp:anticheat), Read-only (mcp:read), and Full access. mcp:write covers the bug and Steam scopes. It does not cover anticheat.

Anticheat​

These tools are on the developer server only. Each one needs mcp:anticheat. They do nothing for a game until staff have recorded a signed NDA and a signed contract, except request_anticheat and a status read. The player server does not have them. What each profile checks is described in Anticheat, without the decision rules.

ToolInputsNotes
request_anticheatuid, contact email, confirmOwner only. confirm must be true. Sends the request. A staff member writes to that email.
get_anticheatuidBefore both signatures, the request status only. After that, the profile and its settings.
update_anticheatuid, profile (generic, platformer, or fps), and the settings for that profileA setting from the other profile is rejected. Shutting admins out is owner-only.
list_anticheat_keysuidNames and prefixes. Never the secret.
create_anticheat_keyuid, name, confirmconfirm must be true. The secret is returned once, for the dedicated server.
rotate_anticheat_keyuid, key id, confirmconfirm must be true. The new secret is returned once.
revoke_anticheat_keyuid, key id, confirmconfirm must be true.
list_anticheat_eventsuid, optional originReports for that game. Origin is the client or a server key's name.
list_anticheat_bans, ban_anticheat_player, unban_anticheat_playeruid, and a player on the ban and unban tools
list_anticheat_mutes, mute_anticheat_player, unmute_anticheat_playeruid, and a player on the mute tools
list_anticheat_notes, add_anticheat_noteuidA note the game's developers keep
enqueue_anticheat_actionuid, action, player id, confirmconfirm must be true. Asks the dedicated server to warn, mute, kick, or ban, or to take a screenshot.
list_anticheat_audituidWho changed settings, keys, or actions

Listings​

See Listings and search for the allowed values and the listing check.

ToolInputsNotes
validate_listinguidListing check: ready, errors (block going public), warnings, passes, plus the current taxonomy and allowed values
game_setup_walkthroughuidRead-only. Ordered setup steps, the validate_listing checks that still fail, field limits, and next_tool. It does not change the game and does not return secrets
update_game_taxonomyuid (required), genres, tags, tone, inputs, content_warnings, engines, session_bucket, net, players_min, players_max, authorship, authorship_credit, ai_usesOnly the fields you pass change. authorship is the made-with label (human, human_agent, agent_heavy, or empty to clear) and authorship_credit an optional credit line up to 120 characters. ai_uses is the generative AI disclosure (art, audio, code, text, voice, runtime; an empty list means none). Write
set_similar_gamesuid, games (up to 10 uids or vanity names)Replaces the similar titles; an empty list clears them. Write
set_mediauid, kind (cover, thumbnail, or gallery)Returns the matching chauffeur media commands and the image limits (PNG, JPEG, GIF, or WebP, sniffed from the file). Wide images need width/height between 1.70 and 1.85. Thumbnail 1280x720 recommended, 960x540 to 1920x1080, 5 MB. Cover 1024x576 recommended, 1024x576 to 2048x1152, 8 MB. Screenshot 1920x1080 recommended, 1280x720 to 2048x1152, 10 MB. Avatar 256x256 to 512x512, square (0.95 to 1.05), 2 MB, on the account settings page. MCP never uploads images; use chauffeur or the website. Write
scan_statusuidScan state and history of every build file, plus files removed in the last 30 days because their scan failed
list_oauth_appsuidSign-in applications, the plan, and whether another one can be created. Never returns a secret. One application is included on Free. Another one needs Premium at $29 a month on that project. Business includes that. mcp:read
create_oauth_appuid, name, redirects, emailCreates a sign-in application. The secret is shown once. Ask the human for the name, redirect URLs, and email choice. mcp:write
update_oauth_appuid, app_id, optional name, redirects, emailChanges the name, redirect URLs, or email flag. mcp:write
rotate_oauth_app_secretuid, app_idReplaces the secret. The old one stops working. The new secret is shown once. mcp:write
delete_oauth_appuid, app_idDeletes the application. Players can no longer sign in with it. mcp:write

Account and payments​

Amounts are integer US cents. See Payments for the rules behind these tools.

Buying, wallet, and library are only on the player server, where the library tool is get_library. The developer server lists 213 tools. A developer token that purchases or tops up gets 4034. Seller, payout, and patron tools stay here.

ToolInputsNotes
get_accountnoneEmail verification, timezone, balances, what the account may do, and the website sign-in steps still open: legal_acceptance_required (with legal_changes), setup_required, authenticator (on, skipped, or not_chosen), and gate (empty when none). Send the human to blazium.games/account/finish for an open step. Authenticator setup and skipping it stay on the website. Account only
create_accountemail, optional password, username, timezone, accept_legal, accept_developer_termsCreates an account. Continue or Generate only when password is omitted. Enter a timezone or Use this machine when timezone is omitted. Send accept_legal and accept_developer_terms only after the human agrees
loginemail, optional passwordThe person types the password. Generate is not offered. The connection is elevated only when sign-in succeeds. otp_required means call confirm_account
confirm_accountemail, codeExchanges the email code, elevates this connection, and returns this server's first bgames_mcp_ key once. A later call does not rotate an existing key
elevate_sessionkeySigns this connection in with a saved bgames_mcp_ key. No Authorization header
enable_developer_modeaccept_termsTurns developer mode on. Send accept_terms only after the human agrees. Turning it off stays on the website. Account only, write
request_email_codenoneEmails a verification code to the account owner. Account only, write
verify_emailcodeVerifies the email with the code the human received. Account only, write
set_timezonetimezoneReplaces the saved timezone with the human's IANA name. Call it when get_account timezone is empty or the human asks to change it. Do not send the machine's timezone. Unknown names return 4085. Account only, write
get_security_statusnoneWhether an authenticator app protects the account: state (on, skipped, or not_chosen), enabled_at, skipped_at, recovery_codes_left, and email_code_alternative. Enroll, replace, and turn-off stay on the website. Account only, read
skip_authenticatornoneRecords that the human chose not to set up an authenticator. Call it only when the human asked. Later sign-in uses confirm_account with the email code. Account only
set_game_priceuid, price_cents (0 or 99-50000), donations_enabledOwners and game admins. A new paid price, donations, a paid edition, or a paid patron tier is refused until the listing owner finishes payout setup. A price of 0 and turning donations off stay allowed. Write
list_game_salesuidSales, donations, refunds, and seller earnings
get_sale_reporteruidReads sale and refund webhooks: enabled, webhook URLs, and that game's signing key. The key is not the review, crash, or bug reporter key. Covered by mcp:money
set_sale_reporteruid, optional enabled, webhooks, refresh_signing_keyTurns sale and refund webhooks on, replaces up to five https URLs, or refreshes the signing key. A refresh returns only the new key. Covered by mcp:money
start_payout_setupnoneReturns the Balance page at blazium.games/settings/wallet. The human opens Stripe-hosted onboarding from Set up payouts with Stripe. Identity, tax, and bank details are entered on Stripe only after that. Needs a verified email. US accounts only. Account only, money write
get_payout_dashboard_linknoneReturns the same Balance page. The human opens the Express dashboard from there. Account only, money write
cash_outamount_cents (at least 2500)Cashes out available earnings to the Express account on that same account. Every agent cash-out, including a player key, returns approval_required and waits for the owner (retry with the same idempotency_key). The owner is emailed after each one. The fee is the account's rate from get_wallet (8%, 7%, or 6%, plus $0.25). Payouts are processed on weekdays from 8:00am to 5:00pm Pacific. 4095 finish payout setup, 4021 not enough available earnings, 4057 below the minimum. Account only, money write
get_patron_statusdeveloper (optional)Read-only memberships for the caller: tier, billing, status, period end, whether the 12 hour check is open, and license ids. No card data
list_patronspage (optional)Developer only. Usernames, tiers, status, and since
get_patronusernameDeveloper only. One patron's tier, status, and since
list_tiersnoneDeveloper only. Tiers and proposed game links
create_tiername, rank, price_cents, billing, optional unlock, untilDeveloper only. Rank, billing, and unlock stay fixed after create
update_tieruid, optional name, price_cents, activeDeveloper only. A new price applies to new pledges. active hides or shows the tier
delete_tieruidDeveloper only. Refused while a membership is pending or active
list_postspage (optional)Developer only. Drafts and published posts, with tier_uids
create_posttitle, body, status, visibility, tier_uidsDeveloper only. visibility is public or tiers
update_postuid plus the create fieldsDeveloper only
delete_postuidDeveloper only. The public page then 404s
get_approvalapproval_idState of a purchase approval: pending, approved, denied, expired, or used. Account only
confirm_approvalapproval_id, codeApproves with the 6-digit code the human read from their email. Account only, write

Payout setup and cash-out need mcp:write or mcp:money and an account-level token; project tokens can't use them. They stay on both servers. See Agent payouts.

Sales and review webhooks​

get_sale_reporter and set_sale_reporter use mcp:money. get_review_reporter is a catalog read, so mcp:read can read it, and set_review_reporter needs mcp:catalog.write. Each list stores up to five URLs and its own signing key. Refreshing one key does not change the others. A Discord webhook URL receives an embed and no file. Any other https URL receives JSON. http is allowed only for localhost. The signature is base64 HMAC-SHA1 of the JSON body before that field is added, using that list's key. Each URL is posted up to three times with the same signed body. A 2xx stops the retries. One URL failing does not skip the others, and a failed delivery does not fail the sale, refund, or review. The settings response includes last_delivery for each URL.

A paid purchase or donation, after it commits. purchase_uid is the idempotency key. kind is purchase or donation. buyer is the username only.

{"event":"sale","game_uid":"gme_1","game_name":"Example","purchase_uid":"pur_1","kind":"purchase","price_cents":1000,"sale_fee_cents":105,"seller_net_cents":895,"currency":"usd","buyer":"ada","signature":""}

A full refund uses the same event name with partial false. A partial Stripe refund sets partial true and refunded_cents to the amount refunded so far. Top-up refunds are not sent. The staff name is not included. reason is omitted when empty.

{"event":"refund","game_uid":"gme_1","game_name":"Example","purchase_uid":"pur_1","kind":"purchase","partial":false,"refunded_cents":1000,"currency":"usd","buyer":"ada","reason":"changed mind","signature":""}

A new review only. An edit or a delete does not send.

{"event":"review","game_uid":"gme_1","game_name":"Example","review_uid":"rv_1","enjoyed":true,"quality":4,"would_play_with_friends":true,"text":"Worth it","buyer":"ada","signature":""}

Field values:

  • visibility: draft (you and admins), owner (only you), invisible (anyone with the link), or public
  • asset_type: game, application, tool, mod, plugin, game_asset, dev_asset, or rom
  • adult: marks 18+ content. See Content rules
  • indexable: false keeps the store page out of search engines. See SEO and indexing

Prompts​

PromptArgumentsPurpose
setup_accountnoneCreate an account, confirm the email code, and save the first key. A later connection calls elevate_session. Do not set Authorization
sign_innoneSign in with a typed password and, when a code is required, confirm it. The connection is logged in only after sign-in succeeds
draft_game_pagepitchDraft a name, tagline, and description from a short pitch
improve_game_copydescriptionRewrite an existing description, keeping the facts
analytics_summaryuidSummarize recent visitors
bootstrap_gamepitch, uid (optional)Create or update the store page and rotate deploy keys so an agent can ship a build
setup_oauth_appuidCall list_oauth_apps, then create one sign-in application. If the owner must approve, the action is not done and no secret was issued. The person opens confirm_url. Call get_approval, then retry with the same idempotency_key
review_oauth_appsuidReport each sign-in application. Do not create, rotate, or delete on its own

Resources​

URIContents
blazium-games://meAuthenticated user. Account only
blazium-games://gamesGames list
blazium-games://games/{uid}One game page
blazium-games://games/{uid}/analyticsVisitor analytics
blazium-games://games/{uid}/crashesCrash reports
blazium-games://games/{uid}/deployNon-secret deploy endpoints and the short code of each deploy key
blazium-games://games/{uid}/buildsBuilds and crash reporter build_id values
ui://blazium-games/account.htmlAccount status, with links to finish sign-in on the website
ui://blazium-games/approval.htmlApproval status, confirm link, and the emailed code
ui://blazium-games/dev-game.htmlStore pages you can edit
ui://blazium-games/analytics.htmlVisitor analytics
ui://blazium-games/sales.htmlSales, and a price form that saves when you click
ui://blazium-games/crashes.htmlCrash reports and a private download link

A host that supports MCP Apps renders these ui:// resources (text/html;profile=mcp-app) beside the tool result. You confirm a price change in the sales view. Other hosts keep the text result. Key-issuing tools, payout setup, and cash-out stay text-only. Buying views are on the player server.

Template {uid} values must be a uid or vanity name made of letters, digits, - and _. Anything else, including dots or slashes, returns an error instead of calling the API.

Errors​

Tool errors return API <status>: <body>. Some low codes (4040, 4050–4056, 4090–4093) are reused by different routes, so read the message along with the code.

CodeMeaning
4010Not authenticated
4030Not allowed: the game isn't yours, or a project token called an account-level tool or another game
4031Token is read-only
4032Token mixes developer (mcp:*) and player (player:*) scopes
4033This route isn't available to this server's tokens (for example a player token on a developer route)
4006Build not found
4096The account email is not verified
4085set_timezone got a name that isn't an IANA timezone
4020Not enough balance; top up first
4221No billing address for tax; top up by card once or buy on the website
4023Buy the game before downloading it
4094The total changed since the quote; confirm again with the human
4099The file is still being scanned, or the build has no clean file to promote
4212This token can't make purchases (project token, or a player token without player:buy)
4214Waiting for the human's approval (HTTP 202, returned as a normal result)
4215The human denied the request
4216Wrong or expired approval code
4095The idempotency key belongs to a different purchase, or payout setup isn't finished (payout tools)
4097The approval was already used
4098The approval was already decided or expired
4083Website only (for example account settings, approval links, or key management). It does not apply to set_anonymous_downloads
4109Anonymous downloads were turned on without confirm_no_license
4113Anonymous downloads are only available on a free listing
4114A price or an edition was set while anonymous downloads are on
4071A taxonomy value isn't allowed; validate_listing lists the allowed values
4072A similar title isn't a public game, or is this game
4225The listing check failed, so the page can't go public (HTTP 422, report in data.lint)
4073The token's scopes don't cover this tool
4074The file isn't on a channel you can see (for example a beta build when you haven't joined the beta)
4075The channel has no earlier build to roll back to
4226Invalid channel name or expires_in_hours out of range (HTTP 422)
4034Buying and top-ups are only on the player server; a developer token gets this code
4076Reviews and bug reports need a copy of the game (bought, or downloaded if it's free)
4077You can't review your own game
4227Invalid review: enjoyed missing, quality outside 1 to 5, or text too long (HTTP 422)
4291Too many bug reports today (10 per player per day, HTTP 429)
4078Already friends, or the friend request was already sent (HTTP 409)
4228You can't send a friend request to yourself (HTTP 422)
4292Too many friend requests today (20 per day, HTTP 429)
4229Invalid dependency: unknown kind, a non-public target, a link to itself, or more than 50 links (HTTP 422)
4230Invalid engine compatibility: engine or renderer not a slug, a version without numbers, or min_version above max_version (HTTP 422)
4231Unknown license kind (HTTP 422)
4232Invalid key pool request: missing name, more than 50 pools, n outside 1 to 5000, or a pool over 100,000 keys (HTTP 422)
4233Invalid parent: not a game or application, the listing itself, a type that can't have a parent, or an external parent without a name and https link (HTTP 422)
4234Invalid mod settings: not a mod or plugin, an absolute or .. install path, a loader that isn't a slug, or instructions too long (HTTP 422)
4235Invalid press kit: a link that isn't https, a bad email or date, or too many items (HTTP 422)
4236Invalid tag, or the player already suggested 5 tags for this game (HTTP 422)
4237Play the game for at least an hour before suggesting tags (HTTP 403, play_seconds and needed_seconds in data)
4238Invalid store link: an unknown store, a link that isn't https on that store's own site, or a second link for the same store (HTTP 422)
4104Adult listing: the viewer hasn't turned on adult content (HTTP 403; signed-out viewers get 4004)
4105Developer mode is off on this account (HTTP 403)
4042That key or gift link isn't valid (HTTP 404)
4079That key was already redeemed (HTTP 409)
4084The player already has this game; the key stays unused (HTTP 409)
4103The key CSV was already downloaded or has expired (HTTP 410)
4034Also: only the project owner can add admins or remove other admins
4040Not found (game, build file, crash, crash group, bug ticket, review, approval, purchase, top-up, key, or user; the message says which)
4043Key pool or key export not found
4050price_cents must be 0 or between 99 and 50000
4051Donations are only available on free games
4052Donation amount_cents must be between 100 and 50000
4053kind must be purchase or donation
4054Only the balance can pay here; card payments go through the store page
4055idempotency_key is required (up to 100 characters)
4056Top-up amount out of range
4080The project owner turned off MCP access for admins
4081Agent spending limits and MCP access settings can only be changed on the website
4082Agents pay from the balance, not by card; or only the owner can change MCP access for admins
4090Already done: you already own the game, or the crash has no dump, log, or stackwalk to download
4091You can't buy your own game
4092The game is free
4093The game doesn't accept donations
4100The top-up expired; create a new one
4130Too many crash metadata keys (64) or analytics events in one request (HTTP 413)
4290Too many requests, crash reports for the day, analysis requests, or redeem attempts (HTTP 429)
4155Invalid edition: slug, name, kind, price, bundle listings or order (HTTP 422)
4156The game already has 8 editions (HTTP 422)
4157The player already owns this edition or a higher one (HTTP 409)
4158A standard analytics event is missing a field or has one out of range (see Crash reporting)
4164The price comes from the game's editions; change them with upsert_sku instead of set_game_price (HTTP 409)
4165This game sells beta access as an edition; buy it to join the beta (HTTP 402, editions in data.skus)
5030A download URL couldn't be signed; try again
5031Email codes aren't configured on the server
5032Payments, or a sign-in provider, aren't configured on the server
5033x402 top-ups aren't configured on the server

Live server names​

  • accept_invite
  • ack_patch_notices
  • buy_post
  • cancel_cash_out
  • cancel_membership
  • check_update
  • decline_invite
  • delete_article_comment
  • delete_web_player_poster
  • export_account
  • file_counter_notice
  • file_dmca_claim
  • get_asset_library_item
  • get_game_display_name
  • get_my_inventory
  • get_patch_notices
  • get_sign_in_providers
  • list_article_comments
  • list_asset_library
  • list_changelog
  • list_connections
  • list_market
  • list_my_bug_reports
  • list_spare_copies
  • list_standing_choices
  • open_account_finish
  • open_password_settings
  • open_web_player_poster
  • redeem_spare_copy
  • report_cheater
  • report_game
  • report_player
  • request_refund
  • revoke_gift_link
  • revoke_key_code
  • revoke_key_pool
  • revoke_standing_choice
  • send_spare_copy
  • set_game_display_name
  • set_payout_currency
  • set_presence_sharing
  • set_profile_visibility
  • set_sign_in_providers
  • set_standing_choice
  • sign_out
  • sign_out_everywhere
  • start_connection
  • start_email_change
  • unfriend
  • unlink_connection
  • write_article_comment