Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CALAGOPUS_URLYesPanel base URL. A trailing /api or / is trimmed for you.
CALAGOPUS_API_KEYYesAPI key, c7sp_ + 43 characters.
CALAGOPUS_TIMEOUT_MSNoPer-request timeout.30000
CALAGOPUS_ALLOW_POWERNoRegister the server power tool.false
CALAGOPUS_ALLOW_CREATENoRegister the create tools.false
CALAGOPUS_INSECURE_TLSNoAccept self-signed certificates. Process-wide — use only against a lab panel.false
CALAGOPUS_ALLOW_SECRETSNoStop redacting secret-looking fields.false
CALAGOPUS_ONFIRM_TTL_MSNoHow long a confirmation token stays valid.300000
CALAGOPUS_MAX_RESPONSE_CHARSNoCap on a single tool result.60000

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
calagopus_panel_infoA

Start here. Returns the panel version and host, the record counts (users, servers, nodes, eggs, database hosts, ...), and — unless you turn them off — CPU/memory/disk figures and clock/migration health. One call to orient yourself before drilling in.

calagopus_get_system_healthA

Health detail: clock offsets against NTP, applied vs pending database migrations, and per-node reachability. Use nodes: true for the node-by-node view.

calagopus_list_backup_configurationsA

List backup configurations — the S3 / Restic / PBS / Kopia targets that locations, nodes and servers back up to. Credentials inside them are redacted unless CALAGOPUS_ALLOW_SECRETS is set.

calagopus_list_system_backup_policiesB

List scheduled panel-wide backup policies and what each one targets (locations, nodes, servers).

calagopus_list_extensionsA

List the backend extensions installed on the panel, with their version and enabled state.

calagopus_list_oauth_providersA

List configured SSO/OAuth providers and their role mappings. Client secrets are redacted unless CALAGOPUS_ALLOW_SECRETS is set.

calagopus_list_usersA

List user accounts on the Calagopus panel, newest page first. Use search to match a username, email or name. Requires the users.read admin permission.

calagopus_get_userA

Fetch one user by UUID, or by the external ID carried over from a billing system or a Pterodactyl/Pelican migration.

calagopus_get_user_serversA

List the servers owned by one user. Answers 'what does this customer actually have' without paging the whole server list.

calagopus_get_user_activityA

Audit trail for one user: logins, server actions, API key use. Requires users.activity.

calagopus_list_rolesA

List roles and the admin/server permission sets they grant. Useful for working out why a user can or cannot do something.

calagopus_get_activityA

Panel-wide admin audit log, most recent first. Optionally scope to one user with user. Requires activity.read.

calagopus_list_serversA

List game servers across the whole panel. search matches the server name, UUID and owner. Each record names its node, owner, egg and primary allocation. Requires servers.read.

calagopus_get_serverA

Fetch one server by UUID (full or short), or by external ID. detail: "full" adds the complete egg, node and owner records plus the startup command and every limit.

calagopus_get_server_resourceA

Fetch one facet of a server: its allocations, egg variables, backups, databases, database instances, mounts, or its console and install logs.

calagopus_list_nodesA

List the wings nodes attached to the panel, with their location, public URL, SFTP endpoint and memory/disk allocation limits. Requires nodes.read.

calagopus_get_nodeA

Fetch one node by UUID, including its location and backup configuration.

calagopus_get_node_resourceA

Fetch one facet of a node: the servers on it, its allocations (all, free, or just the IPs), backups, mounts, capacity headroom, attached database hosts, in-flight transfers, or live system overview/stats/logs from the wings daemon. The system_* facets require the node to be online.

calagopus_list_locationsA

List the locations nodes are grouped into, with the backup configuration each one inherits.

calagopus_list_mountsA

List host-path mounts that can be attached to eggs, nodes and servers.

calagopus_list_nestsA

List nests — the groups eggs are organised into (Minecraft, Source, Rust, ...). Requires nests.read.

calagopus_list_eggsA

List eggs (server templates). Omit nest to get every egg on the panel grouped by nest; pass a nest UUID to page through just that nest's eggs. The summary drops the install script and the upstream repository copy — ask for a single egg with detail 'full' when you need those. Requires eggs.read.

calagopus_get_eggA

Fetch one egg. detail: "full" includes the install script, config files, startup parsing rules and the upstream repository copy — that is ~13 KB, so prefer the summary unless you need the scripts.

calagopus_get_egg_variablesA

List the environment variables an egg declares: name, env var, default value, validation rules, and whether the user may see or edit each one.

calagopus_get_egg_serversA

List every server created from one egg. Use this before changing an egg to see the blast radius.

calagopus_list_egg_repositoriesA

List the git repositories eggs are synced from, and when each last synced. Pass repository to list the eggs available in one of them.

calagopus_list_egg_configurationsA

List reusable egg configuration presets (shared startup/stop/script blocks eggs can inherit).

calagopus_list_database_hostsA

List the external database servers the panel hands out user databases on, with their type, public host/port and deployment state. Connection credentials are redacted unless CALAGOPUS_ALLOW_SECRETS is set. Requires database-hosts.read.

calagopus_get_database_hostA

Fetch one database host by UUID. Set databases: true to list the databases currently provisioned on it instead.

calagopus_list_database_agent_hostsA

List database agent hosts — machines running the Calagopus database agent, which provisions containerised database instances from templates. Shows the agent URL and its memory/disk budget. Requires database-agent-hosts.read.

calagopus_get_database_agent_hostA

Fetch one database agent host by UUID.

calagopus_get_database_agent_host_resourceA

Fetch one facet of a database agent host: the database instances running on it, its remaining capacity, its agent config, or live system overview/stats. The instances, capacity and system_* facets need the agent to be reachable.

calagopus_list_database_agent_templatesA

List the templates the database agent provisions instances from: engine type, docker images, and the CPU/memory/disk each instance gets. Requires database-agent-templates.read.

calagopus_searchA

Search users, servers, nodes and eggs in one call and get the matches side by side. Use this when you have a name, email, IP or partial UUID and do not yet know what kind of thing it is.

calagopus_list_endpointsA

Search this panel's live OpenAPI spec for endpoints. Use it when no dedicated tool covers what you need, then call calagopus_get with the path you find. Reflects the panel's actual version, including routes added by extensions.

calagopus_getA

Escape hatch: issue a raw authenticated GET against any path on the configured panel and return the JSON verbatim. Use it for endpoints the dedicated tools do not cover — find paths with calagopus_list_endpoints first. Only GET is possible; this server cannot create, modify or delete anything.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/BerdiiNN/calagopus-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server