Which integrations are available for this server?

Provides tools for managing Pterodactyl game panel servers via both Client API (power actions, files, databases, backups, schedules, allocations, subusers) and Application API (admin operations: users, servers, nodes, locations, nests/eggs).

How do I use Pterodactyl MCP Server?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

Pterodactyl MCP Server

by Ethereal-Jay

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Pterodactyl MCP Server

A Model Context Protocol server for managing Pterodactyl Game Panel servers via both the Client API and Application API.

Features

Client API — manage your own servers: power actions, files, databases, backups, schedules, allocations, subusers
Application API — admin operations: users, servers, nodes, locations, nests/eggs (auto-detected from ptla_ key prefix)
Markdown (default) and JSON output formats on all read tools
Each tool is fully documented with descriptions, input schemas, and annotations (readOnly, destructive, idempotent hints)

Related MCP server: Minecraft MCP Server

Prerequisites

Node.js 18+
A Pterodactyl panel URL
A Pterodactyl API key (Client: ptlc_... or Application: ptla_...)

Setup

npm install
npm run build

Usage

Set environment variables and start the server:

export PTERODACTYL_URL=https://panel.yourdomain.com
export PTERODACTYL_API_KEY=ptlc_your_api_key_here
npm start

For development with hot reload:

npm run dev

MCP Client Configuration

Add to your MCP client config (e.g. ~/.config/opencode/mcp.json):

{
  "mcpServers": {
    "pterodactyl": {
      "command": "node",
      "args": ["/path/to/pterodactyl-mcp-server/dist/index.js"],
      "env": {
        "PTERODACTYL_URL": "https://panel.yourdomain.com",
        "PTERODACTYL_API_KEY": "ptlc_your_api_key_here"
      }
    }
  }
}

Tools

Client API (Server Management)

Tool	Description
`pterodactyl_list_servers`	List all servers on your account
`pterodactyl_get_server`	Get detailed server info
`pterodactyl_get_server_resources`	Get real-time CPU, memory, disk usage
`pterodactyl_send_power_action`	Start, stop, restart, or kill a server
`pterodactyl_send_console_command`	Send a command to the server console
`pterodactyl_rename_server`	Rename a server and update its description
`pterodactyl_reinstall_server`	Trigger a reinstall of the server
`pterodactyl_get_websocket`	Get WebSocket token/socket URL for console access
`pterodactyl_get_console`	Retrieve recent console output via WebSocket
`pterodactyl_get_account`	Get authenticated account details

Files:

Tool	Description
`pterodactyl_list_files`	List files and directories
`pterodactyl_read_file`	Read a file's contents
`pterodactyl_write_file`	Write content to a file
`pterodactyl_upload_file`	Upload a file (base64 or local path)
`pterodactyl_pull_file`	Download a file from a URL directly to the server
`pterodactyl_create_folder`	Create a new directory
`pterodactyl_delete_files`	Delete files or directories
`pterodactyl_copy_file`	Copy a file or directory
`pterodactyl_compress_files`	Create a tar.gz archive
`pterodactyl_decompress_file`	Extract a tar.gz or zip archive

Databases:

Tool	Description
`pterodactyl_list_databases`	List server databases
`pterodactyl_create_database`	Create a new database
`pterodactyl_rotate_database_password`	Rotate a database password
`pterodactyl_delete_database`	Delete a database

Backups:

Tool	Description
`pterodactyl_list_backups`	List server backups
`pterodactyl_create_backup`	Create a new backup
`pterodactyl_get_backup`	Get backup details
`pterodactyl_download_backup`	Get a backup download URL
`pterodactyl_restore_backup`	Restore a backup
`pterodactyl_lock_backup`	Lock/unlock a backup
`pterodactyl_delete_backup`	Delete a backup

Schedules:

Tool	Description
`pterodactyl_list_schedules`	List schedules with cron details
`pterodactyl_get_schedule`	Get schedule details including tasks
`pterodactyl_create_schedule`	Create a schedule
`pterodactyl_update_schedule`	Update schedule config
`pterodactyl_delete_schedule`	Delete a schedule
`pterodactyl_create_schedule_task`	Add a task to a schedule
`pterodactyl_delete_schedule_task`	Remove a task from a schedule

Allocations:

Tool	Description
`pterodactyl_list_allocations`	List server allocations
`pterodactyl_create_allocation`	Assign a new allocation
`pterodactyl_set_primary_allocation`	Set the primary allocation
`pterodactyl_delete_allocation`	Remove an allocation

Subusers:

Tool	Description
`pterodactyl_list_subusers`	List subusers with permissions
`pterodactyl_create_subuser`	Invite a subuser
`pterodactyl_update_subuser`	Update subuser permissions
`pterodactyl_delete_subuser`	Remove a subuser

Application API (Admin)

Requires an Application API key (ptla_...).

Users:

Tool	Description
`pterodactyl_admin_list_users`	List all panel users (with filters)
`pterodactyl_admin_get_user`	Get user details
`pterodactyl_admin_create_user`	Create a new user
`pterodactyl_admin_update_user`	Update a user
`pterodactyl_admin_delete_user`	Delete a user

Servers:

Tool	Description
`pterodactyl_admin_list_servers`	List all servers (with filters)
`pterodactyl_admin_get_server`	Get server details
`pterodactyl_admin_create_server`	Create a server
`pterodactyl_admin_update_server_details`	Update server name, owner, description
`pterodactyl_admin_update_server_build`	Update server resources and allocations
`pterodactyl_admin_update_server_startup`	Update startup config, egg, image
`pterodactyl_admin_suspend_server`	Suspend a server
`pterodactyl_admin_unsuspend_server`	Unsuspend a server
`pterodactyl_admin_reinstall_server`	Trigger a reinstall of the server
`pterodactyl_admin_delete_server`	Delete a server

Nodes:

Tool	Description
`pterodactyl_admin_list_nodes`	List all nodes (with filters)
`pterodactyl_admin_get_node`	Get node details
`pterodactyl_admin_create_node`	Create a new node
`pterodactyl_admin_update_node`	Update a node
`pterodactyl_admin_delete_node`	Delete a node
`pterodactyl_admin_get_node_configuration`	Get node wings configuration
`pterodactyl_admin_list_allocations`	List node allocations
`pterodactyl_admin_create_allocations`	Create allocations on a node
`pterodactyl_admin_delete_allocation`	Delete an allocation

Locations:

Tool	Description
`pterodactyl_admin_list_locations`	List all locations
`pterodactyl_admin_get_location`	Get location details
`pterodactyl_admin_create_location`	Create a location
`pterodactyl_admin_update_location`	Update a location
`pterodactyl_admin_delete_location`	Delete a location

Nests & Eggs:

Tool	Description
`pterodactyl_admin_list_nests`	List all nests
`pterodactyl_admin_get_nest`	Get nest details (with eggs)
`pterodactyl_admin_list_eggs`	List eggs in a nest
`pterodactyl_admin_get_egg`	Get egg details (with variables)

Output Formats

All read tools accept an optional response_format parameter:

markdown (default) — human-readable tables and lists
json — raw JSON for programmatic use

API Key Types

Prefix	Type	Available Tools
`ptlc_`	Client API	Server management, files, databases, backups, schedules, allocations, subusers
`ptla_`	Application API	Everything above + admin tools (users, servers, nodes, locations, nests)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

mcpA
com.fadehost
Manage FadeHost game servers, Discord bots and VPS: console, stats, backups, logs, lifecycle.
Games & Gamification Virtualization
391
https://api.fadehost.com/mcp
Tacyon MC
io.tacyon
Create, configure, manage Minecraft servers — plugins, files, console, modpacks, backups, metrics.
Games & Gamification Shell Access File Systems
2
https://portal.tacyon.io/api/mcp
ZapX by ZAP-HostingDeprecated
com.zap-hosting
Manage ZAP-Hosting game servers, VPS, dedicated servers, TeamSpeak and domains from your AI client.
Cloud Platforms Virtualization Networking & Infrastructure
1
https://zap-hosting.com/api/mcp
NodecraftA
com.nodecraft
Manage your Nodecraft game servers: start, stop, files, backups, console, players and settings
Games & Gamification Cloud Platforms
691
https://mcp.nodecraft.com/mcp

Related MCP Servers

pterodactyl-mcp
Games & Gamification Monitoring File Systems
N1jada
A
license
A
quality
B
maintenance
Enables AI assistants to safely manage Pterodactyl game servers, covering status, console, files, backups, and power operations with built-in guardrails.
Updated 2 months ago (2026-09-26 19:45 UTC)
20
1
MIT
Minecraft MCP Server
Games & Gamification App Automation
avinash893
A
license
Not graded
quality
C
maintenance
Enables AI agents to manage, configure, and operate game servers hosted on Pterodactyl panels, including power actions, console commands, file operations, plugin installation, and backups. It also supports Cloudflare challenge bypass and automatic request pacing for reliable panel automation.
Updated a month ago (2026-10-06 14:41 UTC)
1
MIT
Model Access Panel (MAP)official
Games & Gamification Virtualization Developer Tools
RealmsNetwork
A
license
Not graded
quality
B
maintenance
Enables administering one or many Pterodactyl panels from MCP-compatible clients through a configurable gateway, including server lifecycle control, console commands, file and backup management, and broad Client, Application, and Admin API requests.
Updated a day ago (2026-11-13 04:38 UTC)
MIT
pterodactyl-mcp
Games & Gamification Virtualization Cloud Platforms
Bippy-s-AI-Helpers
A
license
Not graded
quality
C
maintenance
Enables MCP clients to drive a Pterodactyl game panel over both its client and application API trees, covering servers, files, backups, schedules, databases, subusers, nodes, nests, and an eight-tool wings websocket console suite. Exposes 105 typed tools with a default-deny gate that blocks deletes, reinstalls, suspensions, and kill actions until explicitly allowlisted.
Updated 25 days ago (2026-10-20 16:52 UTC)
MIT

Pterodactyl MCP Server

Features

Prerequisites

Setup

Usage

MCP Client Configuration

Tools

Client API (Server Management)

Application API (Admin)

Output Formats

API Key Types

Tool Schema Changelog

Resources

Related MCP Connectors

Related MCP Servers

pterodactyl-mcp

Minecraft MCP Server

Model Access Panel (MAP)official

pterodactyl-mcp