game-servers（游戏服务器）

You can manage dedicated game servers through the Supercraft Agentic API. This is a REST API — no additional binaries or MCP servers are needed, just HTTP requests with a Bearer JWT token.

API Base

https://claws.supercraft.host

Authentication

All /servers/* endpoints require a Bearer JWT token in the Authorization header.

To get a token, use the login-link flow:

1. POST /auth/login-link with {"email": "user@example.com"} — sends a magic link email
2. User clicks the link, which contains a magic token
3. GET /auth/claim?magic=<token> — poll this until it returns a JWT

# After obtaining the JWT:
curl -H "Authorization: Bearer <JWT>" https://claws.supercraft.host/servers

Available Endpoints

Server Management (requires auth)

Catalog (no auth needed)

Purchasing (no auth needed)

Purchase & Login Flow — CRITICAL

When generating a checkout_url (via POST /orders/purchase) or login_url (via POST /auth/login-link), you MUST send the link to the user as a message BEFORE calling any tools (curl, exec, cron). If you call a tool first, the message with the link gets blocked and the user never sees it.

Correct sequence:

1. Reply to the user with the checkout_url or login_url
2. After the reply, set up a cron (every 30s) to poll GET /auth/claim?magic=...
3. When claim returns status: "ready", save the JWT token securely

Do NOT use while/sleep loops — use a cron job or poll on the user's next message.

Supported Games

ARK: Survival Ascended, Counter-Strike 2, Enshrouded, Factorio, HumanitZ, Hytale, Necesse, Palworld, Project Zomboid, Rust, Satisfactory, Sons of the Forest, Terraria, Unturned, V Rising, Valheim, and Vintage Story.

Example Usage

When the user asks about their game server, follow this pattern:

1. List servers (GET /servers) to find the right deployment
2. Check status (GET /servers/{id}) before taking action
3. Confirm destructive operations (restart, config changes) before executing

Check server status:

curl -H "Authorization: Bearer $TOKEN" https://claws.supercraft.host/servers

Start a server:

curl -X POST -H "Authorization: Bearer $TOKEN" https://claws.supercraft.host/servers/42/start

Update config:

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"max_players": 20}' \
  https://claws.supercraft.host/servers/42/config

Send console command:

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command": "say Hello everyone!"}' \
  https://claws.supercraft.host/servers/42/console

Browse available games:

curl https://claws.supercraft.host/catalog/games

Documentation

• Getting Started Guide
• OpenAPI Reference
• Machine-readable discovery
• Per-game API guides: https://claws.supercraft.host/{game-slug}-server-api