Skip to main content

Player MCP

The player server acts for you as a player. It can recommend games and say why, search the catalog, review games you own and report bugs, see your account, wallet, and library, top up your balance, buy games and donate within the spending limit you set, set up payouts and cash out your earnings, fetch download links, and hand installs and launches to the Blazium launcher. It cannot touch game pages, builds, crash reports, analytics, or keys; those are on the developer server.

No token is required to connect. Call initialize, then prompts/get for setup_account or sign_in. The prompt list, tool list, and resource list are readable with no token. A call that needs an account names that prompt, or elevate_session when a key already exists. Do not set Authorization and do not call the server with Python. accept_legal is sent only after the person agrees. The account stays a player. Developer mode is turned on only when the account is created on the developer server, or later with enable_developer_mode there. Builds, images, and symbol files are uploaded with the chauffeur CLI, not from either MCP server.

Developer serverPlayer server
URLhttps://mcp.blazium.games/developer (/mcp still reaches it)https://mcp.blazium.games/player
Scopesmcp:read, mcp:writeplayer:read, player:write, player:buy
API key prefixbgames_mcp_bgames_play_
Server card/.well-known/mcp/server-card.json/.well-known/mcp/player-server-card.json

A token belongs to exactly one server. A developer key or token is refused by /player, and a player key or token is refused by /mcp. A token can't hold both mcp:* and player:* scopes (4032).

Sign up and sign in​

Call initialize with no token. tools/list, prompts/list, prompts/get, resources/list, and resources/templates/list are readable with no token. Then follow one prompt:

  • setup_account for a new person. Call create_account, then confirm_account with the email code.
  • sign_in for a person who already has an account. Call login, then confirm_account when the answer is otp_required.

create_account shows Continue or Generate only when the call has no password. Generate shows a 20-character password. login never offers Generate. A password already on either call skips the form. The checkbox "Do not return this password. I will copy it." keeps it out of the agent result. When create_account or set_timezone has no timezone, the person gets Enter a timezone or Use this machine. Use this machine is the only time the agent may send the machine's IANA zone.

Send accept_legal only after the person agrees. The account stays a player. An existing address gets the same answer and is not revealed. The connection becomes logged in only after sign-in succeeds. confirm_account returns this server's first bgames_play_ key once and does not return the website session. A later call does not rotate a key that already exists. A later connection calls elevate_session. Do not set Authorization and do not call the server with Python. Developer mode is turned on only on the developer server. An authenticator challenge, and choosing or skipping an authenticator, stay on the website.

Website signup at blazium.games/signup still works. OAuth consent, below, still works when the client opens the website.

Add the server to your client with no token:

{
"mcpServers": {
"blazium-games-player": {
"url": "https://mcp.blazium.games/player"
}
}
}

Your client discovers OAuth from https://mcp.blazium.games/.well-known/oauth-protected-resource/player (authorization server metadata at /.well-known/oauth-authorization-server/player) and opens the Blazium Games consent page, which lists what the player tools can do. There is no project picker. Tick Allow purchases only if the agent should buy for you; without it the token has player:read player:write and every purchase call returns 4212. Tick Read-only access to grant player:read only.

Connect with a player key​

Create a player key at blazium.games/settings/mcp under Player MCP. Untick Allow purchases to create a key without player:buy. The key is shown once. A pasted client config may contain Authorization: Bearer bgames_play_.... The agent does not set that header. It calls elevate_session. Rotating revokes all your player keys and leaves your developer keys alone.

Scopes​

ScopeAllows
player:readAccount, wallet, ledger, payment options, top-up status, quotes, purchase status, library, download links, approvals, agent policy, the files you can see for a game, recommendations, your review, friends and what they're playing, chat token status
player:writeEmail verification, play time, confirming an approval with the emailed code, joining or leaving a beta, reviews, tag suggestions, taste feedback, bug reports, friend requests, presence and activity sharing, chat sign-in and chat tokens
player:buyCard and x402 top-ups, purchase_game, donate_to_game, payout setup and cash_out

A route outside this list returns 4033. A missing player:buy returns 4212; any other missing scope returns 4031.

Spending limits and approval​

Purchases always come from your stored balance. Set a limit per agent at blazium.games/settings/mcp: ask every time, unlimited, monthly, yearly, or a one-time budget. Anything beyond the limit waits for you to approve it by email link or code. See Agent purchases.

Payouts and cash-out​

With player:buy an agent can send you to Balance and ask to cash out. start_payout_setup and get_payout_dashboard_link return that page. You open Stripe from Set up payouts with Stripe, and identity, tax, and bank details are entered on Stripe only after that. A cash-out waits for you, including a player key. The fee is the account's rate from get_wallet (8%, 7%, or 6%, plus $0.25). Money only goes to the Express account on that same account, we email you after each agent cash-out, and payouts are processed on weekdays from 8:00am to 5:00pm Pacific. See Agent payouts.

Tools​

ToolInputsScopeNotes
get_accountnonereadEmail verification, timezone, balances, what the account may do, and the website sign-in steps still open (legal_acceptance_required, legal_changes, setup_required, authenticator, gate)
create_accountemail, optional password, username, timezone, accept_legalnoneCreates an account. Continue or Generate only when password is omitted. Enter a timezone or Use this machine when timezone is omitted
loginemail, optional passwordnoneThe 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, codenoneExchanges the email code, elevates this connection, and returns this server's first bgames_play_ key once. A later call does not rotate an existing key
elevate_sessionkeynoneSigns this connection in with a saved bgames_play_ key. No Authorization header
request_email_codenonewriteEmails a verification code to you
verify_emailcodewriteVerifies your email with the code
set_timezonetimezonewriteSets your IANA timezone, replacing the saved one. The agent uses your zone, not the machine it is running on
get_security_statusnonereadWhether an authenticator app protects your account, and how many recovery codes are left
skip_authenticatornonewriteRecords that you chose not to set up an authenticator. An agent calls this only when you asked. Later sign-in uses confirm_account with the email code
get_walletnonereadCredit, pending, and available balances, fee and refund rules, payout status, and recent cash-outs
list_wallet_transactionslimit (1-200), beforereadLedger entries, newest first
get_payment_optionsnonereadCard top-up and x402 USDC networks with fees
create_top_up_linkamount_centsbuyCard Checkout link for you to add balance
create_x402_top_upamount_cents, networkbuyx402 payment requirements for a USDC top-up
pay_with_x402top_up_id, payment_payloadbuySubmits the signed x402 payment
quote_purchaseuid, kind, amount_cents, skureadPrice, tax, and total. The agent shows you the total first. sku is an edition uid or slug from get_game_details; empty quotes the cheapest edition, and owners of a cheaper edition are quoted the upgrade price
purchase_gameuid, confirm_total_cents, idempotency_key, skubuyBuys a license (or an edition upgrade) from your balance, with the same sku as the quote. Beyond the limit it returns approval_required
donate_to_gameuid, amount_cents, confirm_total_cents, idempotency_keybuyDonates to a free game from your balance
get_approvalapproval_idreadpending, approved, denied, expired, or used
confirm_approvalapproval_id, codewriteApproves with the 6-digit code you read to the agent. accepted and already_approved mean retry once. already_completed means it finished. Do not request another code.
get_librarynonereadGames you own, with refund windows and play time
get_download_linkfile_idread5-minute signed URL for a Windows, Linux, or content-pack file. A web build is hosted and is not downloaded.
get_agent_policynonereadThis agent's limit mode, limit, and spend in the period
start_payout_setupnonebuyReturns the Balance page. You open Stripe from Set up payouts with Stripe
get_payout_dashboard_linknonebuyReturns the Balance page, where you open the Express dashboard
cash_outamount_centsbuyCashes out available earnings ($25 minimum) to your own Express account and waits for your approval; you're emailed after each one
get_patron_statusdeveloper (optional)readYour patron memberships. No card data
search_catalogq, asset_type, genres, tags, tone, ai_uses, exclude_types, exclude_genres, exclude_tone, exclude_tags, exclude_warnings, exclude_ai_uses, session_bucket, net, players, os, arch, engine, engine_version, renderer, license, authorship, sort, page, page_sizereadPublic games, tools, mods, and assets with a score, scan state, platforms, made-with label, content warnings, AI disclosure, launch-health band, and a short reason for each match. Several values in one filter match any of them (comma-separate asset_type, session_bucket, net, os, and authorship); the exclude_ filters leave out listings with any of their values. sort is relevance (default, best match), newest, or updated. Adult listings appear only if you turned on adult content. See Listings and search
list_articleslimit (1-50, default 20), queryreadNewest published blog posts. query matches the title or description. Returns slug, title, description, date, and URL. Does not post or delete comments
get_articleslugreadOne published blog post, including the markdown body
list_game_addonsuid, kind (mods, tools, or empty for both), limit (1-100)readMods and plugins, or tools and applications, made for a game. same_creator marks the ones from the game's own developer
suggest_taguid, tag, removewriteSuggests a tag for a game you own and have played for at least an hour (4237 before that); remove withdraws it. Up to 5 per game. Without tag it returns your suggestions and whether you may suggest. See Community tags
get_shelfkind, os, limit (1-24, default 12)readA home page shelf of listings with a clean download for os: featured, new, recently_updated, made_with_blazium, in_development, browser_playable, community, tools_and_assets, tonight (short sessions with a healthy build), or unheard_of (recent listings few people have found). Each listing says whether it plays in the browser (has_browser_build) or downloads (has_downloads). Shelves without their own order rotate daily. See Shelves
get_game_detailsuidreadDescription, taxonomy, price, editions (skus), made-with label, launch health, license kind, engine compatibility, what it uses and what uses it, files with scan state and checksum, similar titles, store_links to its pages on other stores, and whether you own it
install_builduid, build_id, os, arch, channelreadChecks your license and the virus scan, then returns the file checksum, a 5-minute download_url, and a blazium://install/<uid> link for the launcher. Uses the channel you follow unless you pass stable or beta. Refuses any file that isn't clean
launch_gameuidreadReturns the blazium://game/<uid> link that opens the game in the launcher, and whether you own it and a clean build exists
set_channeluid, channel (stable or beta)writeJoins or leaves a game's beta. Beta builds then show up in get_game_details and install_build
why_should_i_trust_thisuidreadThe developer, how each current file was uploaded, its scan history and checksum, and anything worth a second look (a file that isn't clean, no scan history, a beta build). It never calls a file safe; a clean scan only means no known malware was found
recommendintent, minutes, party_size, like_uid, os, arch, asset_type, include_owned, limit (1-10)readGames for right now, each with the reasons it was picked and any cautions. See Recommendations
why_thisuid, intent, minutes, party_size, like_uid, os, archreadOne game scored against the same inputs: reasons, cautions, and the blockers that keep it out of recommend
write_reviewuid, enjoyed, quality (1-5), would_play_with_friends, text, deletewriteCreates or updates your review of a game you own. One review per game; delete removes it
taste_feedbackuid, more_like, clearwriteMore (true) or less (false) like this game in recommend. clear removes it
report_buguid, message, build_id, os, arch, include_dump, include_logwriteFiles a bug ticket with the developers. include_dump and include_log return one-time upload URLs (PUT, 24 hours)
games_friends_playlive_onlyreadWhat your friends are playing now, then what they played in the last 14 days, with store links. See Friends
list_friendsnonereadFriends with their presence (playing, online, offline) and pending requests with their request_uid
remove_friendusernamewriteRemoves a friend
get_presencenonereadWhat you are playing, and whether that is shared
set_presence_sharingsharewriteShows or hides what you are playing
get_inventoryoptional cursorreadItems you hold. Page with cursor from the previous next
list_listingsnonereadYour marketplace listings
create_listinguid, price_cents, and item_ids or itemdef_id with countwriteLists items for sale
cancel_listinglisting_idwriteCancels one of your listings
send_friend_requestusernamewriteSends a friend request. If that person already asked you, it accepts theirs
respond_friend_requestrequest_uid, acceptwriteAccepts or declines an incoming request
get_chat_connectionnonewriteChat host, TLS port 6697, the browser websocket, and a SASL PLAIN sign-in token that works for 10 minutes, so the agent can join chat itself. See Chat
get_chat_token_statusnonereadWhether you have a chat token for IRC clients (prefix and created and last used times, never the token), whether your account is locked out of chat, and the settings for a client
request_chat_tokenconfirmwriteCreates or replaces your IRC client chat token and returns it once. Replacing it disconnects every client signed in with the old one
revoke_chat_tokenconfirmwriteRevokes your chat token and disconnects every client signed in with it
redeem_keycodewriteRedeems a game key (XXXXX-XXXXX-XXXXX-XXXXX) or a gift link (the whole link or the code at its end) and adds the game to your library. If you already own it, the key stays unused (4084)

Games list the channels you can join in get_game_details (channels). A beta download link for a game whose beta you haven't joined returns 4074.

install_build and launch_game never install or run anything on the server or your machine; the agent gives you the blazium:// link, or your client opens it, and BlaziumLauncher does the rest. blazium://install/<uid> and blazium://game/<uid> go to BlaziumLauncher on port 39220. blazium://buy/<uid> opens the store page and does not install. blazium://hub and blazium://install?version= stay with BlaziumHub. Chat links (blazium://chat and blazium://friends) open BlaziumLauncher too. Game chat itself is IRC on irc.blazium.online port 6697; see Chat.

Recommendations​

recommend gives the same answer for the same inputs; no model picks the games. It only considers public listings of one asset_type (game unless you pass another) with a clean build for your platform (when you pass os), leaves out adult listings unless you turned on adult content at blazium.games/settings, and skips games you own or already liked unless you pass include_owned. Each game is scored in this order:

  1. Session fit: its session length (15m, 1h, 3h, or endless) against the minutes you have.
  2. Friends: a friend playing it right now, or else friends who own it. Only friends who share their activity count.
  3. Intent: words from intent matched against the listing's genres, tags, tone, name, tagline, and description. When you give an intent, a game that matches none of its words is left out.
  4. Taste: tags and genres shared with games you liked (taste_feedback more like, a review where you enjoyed it, an hour or more of play time, or like_uid), and titles the developer lists as similar to them.
  5. Reviews: enough reviews, with most reviewers saying they enjoyed it.
  6. Crashes: games with many recent crash reports rank lower and get a caution.
  7. Freshness: a small, capped boost for recently updated listings. It never counts as a reason on its own.

Every result lists reasons, each naming the listing field it matched. A game with nothing to cite is left out rather than padded in. party_size keeps only games that support that many players. Games you marked less like this never appear. why_this explains any one game, including why it was left out.

Reviews and bug reports​

You can review and report bugs for games you own: games you bought, and free games you've downloaded (a free game counts once you download it, and stops counting if it later gets a price). You need a verified email, and developers can't review their own games (4077). Enjoyed and quality are separate: a well-made game you didn't enjoy can be quality 5 and enjoyed "no". Reviews appear on the store page, where the developer can reply. Review text is never used for ranking; recommend only counts whether reviewers enjoyed the game.

A bug report goes to the game's developers, up to 10 per day (4291). Attached dumps and logs can only be downloaded by the game's developers and our staff.

Friends​

Add friends by username from the agent or at blazium.games/friends. You need a verified email to send requests, and you can send up to 20 a day (4292). Sending a request to someone who already asked you makes you friends right away. Adding yourself returns 4228, and asking someone you're already friends with or already asked returns 4078.

Friends see whether you're online and which game you're playing, plus a status of at most 40 characters beside the game name when the game sets one, and the public games you played in the last 14 days. "Playing" comes from the play-time heartbeat your launcher or game sends, and lasts 10 minutes after the last one. The player MCP has no tool that sets that status. Unlisted and draft games are never shown. Turn off Activity sharing on the friends page to hide all of it; you then also drop out of your friends' recommendations.

Chat​

Game chat is IRC on irc.blazium.online and follows the Chat Rules. get_chat_connection signs the agent in as you for 10 minutes. For your own IRC client, request_chat_token creates a long-lived token: it is returned once, so the agent should hand it straight to you, and only when you ask. Up to 10 token changes an hour (4290). A locked account can't sign in to chat with either token. See IRC clients for client setup and For client developers for what an agent sees once it's connected.

Interactive views​

A host that supports MCP Apps shows an interactive view beside the tool result. You confirm a purchase, donation, key redeem, or friend request in that view. A card top-up opens a Checkout link for you to pay. Payout setup and cash-out stay text-only tools. A host without MCP Apps keeps the text result. Each view is a ui:// resource served as text/html;profile=mcp-app.

Resources​

URIContents
blazium-games://meAccount status, verification, and what the account may do
blazium-games://walletStored balance and payment rules
blazium-games://libraryOwned games and licenses
ui://blazium-games/checkout.htmlQuote, buy, and donate. The purchase runs when you click
ui://blazium-games/game.htmlGame information and trust checks
ui://blazium-games/results.htmlSearch, recommendations, shelves, add-ons, and what friends are playing
ui://blazium-games/wallet.htmlBalance, ledger, spending limit, and a card top-up link
ui://blazium-games/approval.htmlApproval status, confirm link, and the emailed code
ui://blazium-games/library.htmlOwned games, redeem, and download links
ui://blazium-games/handoff.htmlblazium:// hand-off for BlaziumLauncher
ui://blazium-games/account.htmlVerification, timezone, and links to finish sign-in on the website
ui://blazium-games/feedback.htmlReviews, bug reports, taste, and tag suggestions
ui://blazium-games/friends.htmlFriends and requests

Moving from the developer server​

Buying, wallet, and library are only on this server. get_library is the library tool here. A developer token that purchases or tops up gets 4034.

Live server names​

  • accept_invite
  • ack_patch_notices
  • buy_post
  • cancel_cash_out
  • cancel_membership
  • check_update
  • decline_invite
  • delete_article_comment
  • export_account
  • file_counter_notice
  • file_dmca_claim
  • get_asset_library_item
  • get_game_display_name
  • get_my_inventory
  • get_patch_notices
  • 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
  • pledge
  • redeem_spare_copy
  • report_cheater
  • report_game
  • report_player
  • request_refund
  • revoke_standing_choice
  • send_spare_copy
  • set_game_display_name
  • set_payout_currency
  • set_profile_visibility
  • set_standing_choice
  • sign_out
  • sign_out_everywhere
  • start_connection
  • start_email_change
  • unfriend
  • unlink_connection
  • write_article_comment