AI Access (MCP)

Connect your own AI assistant — Claude, or any MCP-compatible client — to your FadeHost account and let it manage your servers for you: check status, read the console, start/stop/restart, run commands and trigger backups, all from a chat.

FadeHost exposes a standard Model Context Protocol server at:

https://api.fadehost.com/mcp

Authentication is a personal access token sent as a Authorization: Bearer header.

Creating a token

1. In the panel, open Profile → AI Access.
2. Pick a name and a scope:
   • Read — the assistant can look but not touch: server list, status, console logs, live stats, player activity, backup list.
   • Manage — everything in Read, plus start/stop/restart, console commands and creating backups.
3. Click Create token and copy it immediately — it is shown only once. If you lose it, revoke it and create a new one.

You can hold up to 10 AI tokens, and revoke any of them at any time from the same page. Revoking a token disconnects that assistant instantly.

Connecting Claude Code

The AI Access page shows this command pre-filled with your new token:

claude mcp add --transport http fadehost https://api.fadehost.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Then just ask: "Is my server up? Who's online? Restart it if the TPS looks bad."

Connecting any other MCP client

Any client that supports streamable HTTP transport with custom headers works. The generic configuration:

{
  "mcpServers": {
    "fadehost": {
      "type": "http",
      "url": "https://api.fadehost.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

What the assistant can do

Tool	Scope	What it does
list-servers	Read	List every server you can manage, with id, game, status and address
get-server	Read	Full overview of one server: status, software, RAM/disk, settings, ports, last crash
get-console-logs	Read	Read recent console output
get-live-stats	Read	Live memory and CPU usage
get-player-activity	Read	Join/leave/chat counts and recent players over a time window
list-backups	Read	List off-site backup snapshots
start-server	Manage	Start a stopped server
stop-server	Manage	Stop a running server, saving the world first
restart-server	Manage	Restart a server
send-console-command	Manage	Run one console command over RCON and return its output
create-backup	Manage	Trigger an off-site backup right now

There are deliberately no destructive tools: an assistant can never delete a server, restore a backup over your world, or touch your files. Those stay panel-only.

How permissions work

• The assistant can only do what you can do. Every action goes through exactly the same permission, subscription and quota checks as clicking the button in the panel — team roles included.
• On team servers, the token carries your team permissions: if you can't run console commands in the panel, neither can your assistant.
• Requests are rate-limited to 60 per minute per account.

Good to know

• Console output returned to the assistant is labelled as untrusted data, so a message typed by a player on your server won't be mistaken for an instruction to your AI.
• The last used column on the AI Access page shows when each token was last active — a quick way to spot tokens you can revoke.
• Treat tokens like passwords. Anyone holding a Manage token can start, stop and command your servers.

Troubleshooting

• 401 Unauthorized — the token is wrong, revoked, or the header isn't reaching the server. Re-copy the full Bearer value.
• "The server rejected the command" — console commands need the server running with RCON reachable, and a Manage-scope token.
• "No accessible server found" — the id is wrong or the server belongs to an account/team your token can't access. Ask the assistant to call list-servers first.