@blazium-games/skills 0.1.16 → 0.1.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/SKILL_TREE.md +1 -1
- package/package.json +1 -1
- package/skills/blazium-games-get-started/SKILL.md +4 -4
- package/skills/blazium-games-get-started/references/auth.md +2 -2
- package/skills/blazium-games-get-started/references/tools.md +14 -0
- package/skills/blazium-games-player/references/tools.md +9 -0
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@ Cursor: add `blazium-games/games_skill` from **Cursor Settings > Plugins**, then
|
|
|
14
14
|
|
|
15
15
|
- Docs: [docs.blazium.games](https://docs.blazium.games) and the map [llms.txt](https://docs.blazium.games/llms.txt)
|
|
16
16
|
- Skills: `npm install @blazium-games/skills`, or Cursor Settings > Plugins > `blazium-games/games_skill`. Index: [SKILL_TREE.md](https://github.com/blazium-games/games_skill/blob/master/SKILL_TREE.md)
|
|
17
|
-
- MCP: [developer server](https://docs.blazium.games/docs/mcp) at `https://mcp.blazium.games/mcp
|
|
17
|
+
- MCP: [developer server](https://docs.blazium.games/docs/mcp) at `https://mcp.blazium.games/developer` (`/mcp` still reaches it), and [player server](https://docs.blazium.games/docs/mcp/player) at `https://mcp.blazium.games/player`
|
|
18
18
|
- CLI: `npm install -g @blazium-games/cli` (`chauffeur`), guide at [docs.blazium.games/docs/cli](https://docs.blazium.games/docs/cli)
|
|
19
19
|
- Launcher: BlaziumLauncher at `{autopf}\Blazium\Games` on Windows. Shared tools are in `{autopf}\Blazium`. Setup from [Releases](https://github.com/blazium-games/games_launcher/releases), guide at [desktop app](https://docs.blazium.games/docs/storefront/desktop-app)
|
|
20
20
|
- Support: [blazium-games/support](https://github.com/blazium-games/support/issues). Status: [status.blazium.games](https://status.blazium.games)
|
|
@@ -46,7 +46,7 @@ A game on Blazium Games does not have to be made with the Blazium engine. The up
|
|
|
46
46
|
| `blazium-games-player` | Get started, player, purchases |
|
|
47
47
|
| `blazium-games` | Every skill, plus `mcp.json` |
|
|
48
48
|
|
|
49
|
-
`mcp.json` points at `https://mcp.blazium.games/
|
|
49
|
+
`mcp.json` points at `https://mcp.blazium.games/developer` and `https://mcp.blazium.games/player`. `https://mcp.blazium.games/mcp` still reaches the developer server. A token belongs to one server.
|
|
50
50
|
|
|
51
51
|
- Claude Code reads `.claude-plugin/marketplace.json`.
|
|
52
52
|
- Cursor reads `.cursor-plugin/marketplace.json`.
|
package/SKILL_TREE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Blazium Games skill tree
|
|
2
2
|
|
|
3
|
-
Blazium Games is a game publishing platform, with an infrastructure focus. A token belongs to one server: `blazium-games` (developer, `https://mcp.blazium.games/
|
|
3
|
+
Blazium Games is a game publishing platform, with an infrastructure focus. A token belongs to one server: `blazium-games` (developer, `https://mcp.blazium.games/developer`, `/mcp` still reaches it, keys `bgames_mcp_`) publishes pages, builds, crashes, analytics, and keys. `blazium-games-player` (player, `https://mcp.blazium.games/player`, keys `bgames_play_`) finds, reviews, installs, and buys.
|
|
4
4
|
|
|
5
5
|
The guide is [docs.blazium.games](https://docs.blazium.games). This file is the skill index. The docs site remains the source for how the platform works.
|
|
6
6
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: blazium-games-get-started
|
|
3
|
-
description: Connect Cursor to Blazium Games and route to the right skill. Blazium Games is a game publishing platform, with an infrastructure focus. The developer server (mcp.blazium.games/
|
|
3
|
+
description: Connect Cursor to Blazium Games and route to the right skill. Blazium Games is a game publishing platform, with an infrastructure focus. The developer server (mcp.blazium.games/developer) publishes pages, builds, crashes, analytics, and keys. The player server (mcp.blazium.games/player) finds, reviews, installs, and buys. Use when the user mentions Blazium Games for the first time, asks how to connect, or is unsure whether they want to play or publish.
|
|
4
4
|
license: MIT
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@ license: MIT
|
|
|
8
8
|
|
|
9
9
|
Blazium Games is a game publishing platform, with an infrastructure focus. A token belongs to one server:
|
|
10
10
|
|
|
11
|
-
- Developer server `https://mcp.blazium.games/
|
|
11
|
+
- Developer server `https://mcp.blazium.games/developer` (`/mcp` still reaches it; `blazium-games`, keys `bgames_mcp_`): pages, builds, crashes, analytics, and keys. Needs developer mode.
|
|
12
12
|
- Player server `https://mcp.blazium.games/player` (`blazium-games-player`, keys `bgames_play_`): find, review, install, and buy. Works for every account.
|
|
13
13
|
|
|
14
14
|
Never send a player token to the developer server, or a developer token to the player server. Verify the account, then hand off to the skill that matches the user's goal.
|
|
@@ -32,7 +32,7 @@ Use these instead of browsing the website. Signed-in pages do not have facts the
|
|
|
32
32
|
|
|
33
33
|
## Prerequisites
|
|
34
34
|
|
|
35
|
-
- A Blazium Games account
|
|
35
|
+
- A Blazium Games account. Sign up at https://blazium.games/signup, or call `create_account` on the server you are connected to and `confirm_account` with the email code. The developer server turns developer mode on. The player server leaves the account a player.
|
|
36
36
|
- The `blazium-games` MCP server enabled in Cursor (this plugin ships it in `mcp.json`)
|
|
37
37
|
|
|
38
38
|
## 1. Connect
|
|
@@ -44,7 +44,7 @@ The plugin registers the server as:
|
|
|
44
44
|
"mcpServers": {
|
|
45
45
|
"blazium-games": {
|
|
46
46
|
"type": "http",
|
|
47
|
-
"url": "https://mcp.blazium.games/
|
|
47
|
+
"url": "https://mcp.blazium.games/developer"
|
|
48
48
|
}
|
|
49
49
|
}
|
|
50
50
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Authentication
|
|
2
2
|
|
|
3
|
-
The server at `https://mcp.blazium.games/
|
|
3
|
+
The server at `https://mcp.blazium.games/developer` accepts OAuth 2.1 access tokens or MCP API keys, both sent as `Authorization: Bearer <token>`. `https://mcp.blazium.games/mcp` still reaches this server.
|
|
4
4
|
|
|
5
5
|
## OAuth (recommended)
|
|
6
6
|
|
|
@@ -34,7 +34,7 @@ For headless agents and CI:
|
|
|
34
34
|
"mcpServers": {
|
|
35
35
|
"blazium-games": {
|
|
36
36
|
"type": "http",
|
|
37
|
-
"url": "https://mcp.blazium.games/
|
|
37
|
+
"url": "https://mcp.blazium.games/developer",
|
|
38
38
|
"headers": { "Authorization": "Bearer bgames_mcp_YOUR_KEY" }
|
|
39
39
|
}
|
|
40
40
|
}
|
|
@@ -31,6 +31,11 @@ All tools call the Blazium Games API on behalf of the connected user. `uid` acce
|
|
|
31
31
|
| `request_crash_download` | `uid`, `crash_id`, `kind` (`dump`, `log`, or `stack`; default `dump`) | | Private download URL valid for 1 hour |
|
|
32
32
|
| `get_deploy_info` | `uid` | | Upload, crash, and events URLs, recent builds, env var names, deploy key prefixes. No secrets |
|
|
33
33
|
| `list_game_builds` | `uid` | | Up to 50 builds. Each `build_id` is the `X-Build-Id` for crash reporters |
|
|
34
|
+
| `delete_game_build` | `uid`, `build_id` | write | Deletes one build after the owner approves |
|
|
35
|
+
| `add_game_admin` | `uid`, `invite` | write | Invites an admin. Owner only, and the owner approves |
|
|
36
|
+
| `remove_game_admin` | `uid`, `admin_id` | write | Removes an admin. Owner only |
|
|
37
|
+
| `delete_game` | `uid` | write | Deletes a game the caller owns, after the owner approves |
|
|
38
|
+
| `get_account_analytics` | none | account | Analytics across the account's games |
|
|
34
39
|
| `get_game_build` | `uid`, `build_id` | | One build with its files and crash reporter headers |
|
|
35
40
|
| `list_mcp_keys` | none | account | MCP API key prefixes. Secrets are never returned |
|
|
36
41
|
| `request_mcp_key` | `idempotency_key` | account, write | Issue a new MCP API key and invalidate every previous one. Waits for the human's approval, then returns the secret once |
|
|
@@ -51,6 +56,12 @@ All tools call the Blazium Games API on behalf of the connected user. `uid` acce
|
|
|
51
56
|
| `get_sale_reporter` | `uid` | `mcp:money` | Sale and refund webhooks: enabled, webhook URLs, and that game's signing key. The key is not the review, crash, or bug reporter key |
|
|
52
57
|
| `set_sale_reporter` | `uid`, optional `enabled`, `webhooks`, `refresh_signing_key` | `mcp:money` | Turns sale and refund webhooks on, replaces up to five https URLs, or refreshes the signing key |
|
|
53
58
|
| `get_steam_auth` / `set_steam_auth` | `uid`, and for set: `app_id`, `web_api_key`, `ticket_secret`, `enabled`, `confirm` | `mcp:steam.manage` | Write-only Web API key and ticket secret. Disable deletes both only when `confirm` is true |
|
|
59
|
+
| `unlink_steam` | `uid`, `confirm` | `mcp:steam.manage` | Unlinks Steam. `confirm` only after the human agrees |
|
|
60
|
+
| `rotate_steam_key` | `uid`, `confirm` | `mcp:steam.manage` | Replaces the Web API key. The new key is returned once |
|
|
61
|
+
| `resync_steam` | `uid`, `confirm`, optional `groups`, `web_api_key` | `mcp:steam.manage` | Imports the chosen groups again |
|
|
62
|
+
| `import_steam_game` | `app_id`, `web_api_key`, `confirm`, optional `groups`, `uid` | developer | Imports a Steam page. `confirm` only after the human agrees |
|
|
63
|
+
| `set_anonymous_downloads` | `uid`, `enabled`, `confirm_no_license` | write | Anonymous downloads. Turning them on needs the human's confirm, and a free game |
|
|
64
|
+
| `set_adult_content` | `show`, `confirm_18` | account, write | Adult listings. Turning them on needs the human to confirm they are 18 or older |
|
|
54
65
|
| `list_copyright_notices` | none | | Paid copyright (DMCA) notices about the account's content, with status and how many of its links each names |
|
|
55
66
|
| `get_copyright_notice` | `uid` | | One notice: claimant, work, statements, the account's named links, staff messages, decision, and `reply_to`. Read only; the human replies by email with the reference in the subject |
|
|
56
67
|
| `get_game_chat` | `uid` | | The game's IRC channel (`irc_channel`), whether guests may join (`chat_guests`), and who is banned or muted with when each mute ends |
|
|
@@ -109,6 +120,9 @@ Amounts are integer US cents. Agents pay only from the stored balance, and only
|
|
|
109
120
|
| Tool | Inputs | Access | What it does |
|
|
110
121
|
|------|--------|--------|--------------|
|
|
111
122
|
| `get_account` | none | account | Email verification, timezone, balances, what the account may do (publish, upload, download, buy), and open website sign-in steps (`gate`, `legal_acceptance_required`, `legal_changes`, `setup_required`, `authenticator`) |
|
|
123
|
+
| `create_account` | `email`, `password`, optional `username`, `accept_legal`, `accept_developer_terms` | none | Creates an account. No bearer. On this server, `accept_legal` and `accept_developer_terms` (only after the human agrees) turn developer mode on |
|
|
124
|
+
| `confirm_account` | `email`, `code` | none | Finishes signup with the email code and returns the first `bgames_mcp_` key once. No bearer |
|
|
125
|
+
| `enable_developer_mode` | `accept_terms` | account, write | Turns developer mode on after the human agrees. Turning it off stays on the website |
|
|
112
126
|
| `request_email_code` | none | account, write | Email a verification code to the human |
|
|
113
127
|
| `verify_email` | `code` | account, write | Verify the email with the code the human read from their inbox |
|
|
114
128
|
| `set_timezone` | `timezone` | account, write | Replace the saved timezone with the human's IANA name, when it is empty or the human asks. Do not send the timezone of the machine running the agent. Unknown names: `4085` |
|
|
@@ -7,6 +7,8 @@ Server: `https://mcp.blazium.games/player`. Scopes: `player:read`, `player:write
|
|
|
7
7
|
| Tool | Scope | Purpose |
|
|
8
8
|
|------|-------|---------|
|
|
9
9
|
| `get_account` | read | Email verification, timezone, balances, what the account may do, and open website sign-in steps (`gate`, `legal_acceptance_required`, `setup_required`, `authenticator`) |
|
|
10
|
+
| `create_account` | none | Creates an account. No bearer. Send `accept_legal` only after the person agrees. The account stays a player |
|
|
11
|
+
| `confirm_account` | none | Finishes signup with the email code and returns the first `bgames_play_` key once. No bearer |
|
|
10
12
|
| `request_email_code` | write | Email a verification code to the human |
|
|
11
13
|
| `verify_email` | write | Verify the email with the human's code |
|
|
12
14
|
| `set_timezone` | write | Replace the saved timezone with the human's IANA name, when `get_account` timezone is empty or the human asks. Do not use the agent's machine timezone. Unknown names: `4085` |
|
|
@@ -44,6 +46,13 @@ Server: `https://mcp.blazium.games/player`. Scopes: `player:read`, `player:write
|
|
|
44
46
|
| `report_bug` | write | File a bug ticket with the developers (10 per day); `include_dump` / `include_log` return one-time upload URLs |
|
|
45
47
|
| `games_friends_play` | read | What friends are playing now, then what they played in the last 14 days; `live_only` skips the recent list |
|
|
46
48
|
| `list_friends` | read | Friends with presence, plus incoming and sent requests with their `request_uid` |
|
|
49
|
+
| `remove_friend` | write | Removes a friend by username |
|
|
50
|
+
| `get_presence` | read | What you are playing, and whether that is shared |
|
|
51
|
+
| `set_presence_sharing` | write | `share` true shows friends what you are playing |
|
|
52
|
+
| `get_inventory` | read | Items you hold. Page with `cursor` |
|
|
53
|
+
| `list_listings` | read | Your marketplace listings |
|
|
54
|
+
| `create_listing` | write | Lists items for sale: `uid`, `price_cents`, and `item_ids` or `itemdef_id` with `count` |
|
|
55
|
+
| `cancel_listing` | write | Cancels a listing by `listing_id` |
|
|
47
56
|
| `send_friend_request` | write | Send a request by username (20 per day, verified email). Accepts theirs if they already asked |
|
|
48
57
|
| `respond_friend_request` | write | Accept or decline an incoming request |
|
|
49
58
|
| `redeem_key` | write | Redeem a game key or gift link the human gave you; a game they already own leaves the key unused |
|