dvcrn 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:
POST /auth/login-linkwith{"email": "user@example.com"}— sends a magic link email- User clicks the link, which contains a magic token
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)
| Method | Endpoint | Description |
|---|---|---|
| GET | /servers |
List all user's servers with status |
| GET | /servers/{id} |
Detailed server info with live status |
| POST | /servers/{id}/start |
Start the server |
| POST | /servers/{id}/stop |
Stop the server |
| POST | /servers/{id}/restart |
Restart the server |
| GET | /servers/{id}/config |
Get current server configuration |
| PUT | /servers/{id}/config |
Update server configuration |
| GET | /servers/{id}/config/schema |
Get config field definitions (types, ranges) |
| GET | /servers/{id}/connection |
Get connection details (IP, port, password) |
| POST | /servers/{id}/console |
Send RCON/console command |
| GET | /servers/{id}/logs |
Get recent server log lines |
Catalog (no auth needed)
| Method | Endpoint | Description |
|---|---|---|
| GET | /catalog/games |
List all available games |
| GET | /catalog/games/{code} |
Game details with plans and pricing |
| GET | /catalog/regions |
Available server regions |
Purchasing (no auth needed)
| Method | Endpoint | Description |
|---|---|---|
| POST | /orders/purchase |
Purchase a new server plan (returns checkout URL) |
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:
- Reply to the user with the
checkout_urlorlogin_url - After the reply, set up a cron (every 30s) to poll
GET /auth/claim?magic=... - 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:
- List servers (
GET /servers) to find the right deployment - Check status (
GET /servers/{id}) before taking action - 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