blazium-games-get-started

Files (5)

• SKILL.md
• auth.md · references/
• prompts.md · references/
• resources.md · references/
• tools.md · references/

SKILL.md (first lines)

# Blazium Games: Get Started

Blazium Games is a game publishing platform, with an infrastructure focus. A token belongs to one server:

- 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.
- Player server `https://mcp.blazium.games/player` (`blazium-games-player`, keys `bgames_play_`): find, review, install, and buy. Works for every account.

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.

## Read this first

Use these instead of browsing the website. Signed-in pages do not have facts the tools already return.

- Docs map: https://docs.blazium.games/llms.txt
- Platform map: https://blazium.games/llms.txt
- One project's public facts: `https://<username>.blazium.games/<vanity_name>/llms.txt`
- Developer server card: https://mcp.blazium.games/.well-known/mcp/server-card.json
- Player server card: https://mcp.blazium.games/.well-known/mcp/player-server-card.json
- Which files exist, and which do not: https://docs.blazium.games/docs/discovery

## Invoke This Skill When

- The user says "set up Blazium Games", "connect Blazium Games", or "what can the Blazium Games MCP do?"
- A Blazium Games tool call fails with an authentication error
- The user wants to publish, deploy, or monitor a game on https://blazium.games but has not said which part

## Prerequisites

- A Blazium Games account. Sign up at https://blazium.games/signup, or call `initialize` with no token and follow `setup_account` or `sign_in`. A new person uses `create_account`, then `confirm_account` with the email code. An existing person uses `login`, then `confirm_account` when a code is required. Save the first key from `confirm_account` and send it as a bearer. The developer server turns developer mode on. The player server leaves the account a player. A later confirm does not rotate a key that already exists.
- The `blazium-games` MCP server enabled in Cursor (this plugin ships it in `mcp.json`)

## 1. Connect

The plugin registers the server as:

```json
{
  "mcpServers": {
    "blazium-games": {
      "type": "http",
      "url": "https://mcp.blazium.games/developer"
    }
  }
}
```

On first use Cursor opens a browser for OAuth. On the consent page the user chooses:

- **Account**: every game they own or admin, plus account tools such as `create_game` and `request_mcp_key`.
- **A single project**: only that game. Account-only tools return `403` with code `4030`.
- **A preset**: **Store page**, **CI**, **Crash triage**, **Keys**, **Money**, **Read-only**, or **Full access**. A tool outside the preset returns `4073`; a write with a read-only token returns `4031`.

For playing and buying as a player, the plugin also ships `blazium-games-player` at `https://mcp.blazium.games/player`, which has its own consent. See the `blazium-games-player` skill.

If OAuth is not possible (headless CI, remote agents), use an API key instead. See [references/auth.md](references/auth.md).

## 2. Verify

1. Call `get_profile`. A username confirms the connection.
2. Call `get_setup` to see the account, games, public URLs, and key prefixes. It never returns secrets.
3. If `get_setup` fails with `4030`, the token is bound to one project. Use `list_games` instead.

| Symptom | Cause | Fix |
|---------|-------|-----|
| `401` / auth prompt loops | Token expired or revoked | Reconnect the server in Cursor Settings > MCP |
| `403` code `4031` | Read-only token | Reconnect without "Read-only access" |
| `403` code `4030` | Project-bound token calling an account-level tool or another game | Reconnect choosing "Account" |
| `403` code `4073` | The preset doesn't cover this tool | Reconnect with a wider preset |
| `approval_required` (`4214`) | The action waits for the account owner | Ask the human to open the emailed link, then retry with the same `idempotency_key` |
| `API 404` on a game | Wrong uid or vanity name | Call `list_games` and use the `uid` |

## 3. Route

| Goal | Skill |
|------|-------|
| Create or edit a store page | `blazium-games-store-page` |
| Ship builds from CI or the CLI | `blazium-games-deploy` |
| Add crash reporting to a game | `blazium-games-crash-reporting` |
| Investigate a crash | `blazium-games-debug-crash` |
| Read visitor analytics | `blazium-games-analytics` |
| Set achievements, stats, funnels, or presence writers | `get_achievements`, `set_achievements`, `get_stats`, `set_stats`, `get_funnels`, `set_funnels`, `get_presence_writers`, `set_presence_writers` ([tools](./references/tools.md)). A game reads unlocks and stats with `progress()` and sets a client status with `set_presence` when `client` is a writer. A game or private server key reads one owner with `GET /api/v1/server/progress?user_uid=`. |
| Rotate MCP or deploy keys | `blazium-games-keys` |
| Moderate a game's chat channel (guests, bans, mutes) | `get_game_chat`, then `set_chat_guests`, `ban_chat_user`, or `suspend_chat_user` only when the human asks ([tools](./references/tools.md)) |
| Find, review, or play games as a player, or get a chat token | `blazium-games-player` |
| Buy a game or donate | `blazium-games-purchases` |

## References

- [references/tools.md](references/tools.md): every tool, its inputs, the access it needs, and what it does
- [references/resources.md](references/resources.md): `blazium-games://` resources and templates
- [references/prompts.md](references/prompts.md): server prompts
- [references/auth.md](references/auth.md): OAuth, API keys, scopes, and project binding
- Full docs: https://docs.blazium.games/docs/mcp

From blazium-games/games_docs, MIT.

More from blazium-games/games_docs