Pterodactyl MCP 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).
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Pterodactyl MCP Serverlist my servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: pterodactyl-mcp
Prerequisites
Node.js 18+
A Pterodactyl panel URL
A Pterodactyl API key (Client:
ptlc_...or Application:ptla_...)
Setup
npm install
npm run buildUsage
Set environment variables and start the server:
export PTERODACTYL_URL=https://panel.yourdomain.com
export PTERODACTYL_API_KEY=ptlc_your_api_key_here
npm startFor development with hot reload:
npm run devMCP 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 |
| List all servers on your account |
| Get detailed server info |
| Get real-time CPU, memory, disk usage |
| Start, stop, restart, or kill a server |
| Send a command to the server console |
| Rename a server and update its description |
| Trigger a reinstall of the server |
| Get WebSocket token/socket URL for console access |
| Retrieve recent console output via WebSocket |
| Get authenticated account details |
Files:
Tool | Description |
| List files and directories |
| Read a file's contents |
| Write content to a file |
| Upload a file (base64 or local path) |
| Download a file from a URL directly to the server |
| Create a new directory |
| Delete files or directories |
| Copy a file or directory |
| Create a tar.gz archive |
| Extract a tar.gz or zip archive |
Databases:
Tool | Description |
| List server databases |
| Create a new database |
| Rotate a database password |
| Delete a database |
Backups:
Tool | Description |
| List server backups |
| Create a new backup |
| Get backup details |
| Get a backup download URL |
| Restore a backup |
| Lock/unlock a backup |
| Delete a backup |
Schedules:
Tool | Description |
| List schedules with cron details |
| Get schedule details including tasks |
| Create a schedule |
| Update schedule config |
| Delete a schedule |
| Add a task to a schedule |
| Remove a task from a schedule |
Allocations:
Tool | Description |
| List server allocations |
| Assign a new allocation |
| Set the primary allocation |
| Remove an allocation |
Subusers:
Tool | Description |
| List subusers with permissions |
| Invite a subuser |
| Update subuser permissions |
| Remove a subuser |
Application API (Admin)
Requires an Application API key (ptla_...).
Users:
Tool | Description |
| List all panel users (with filters) |
| Get user details |
| Create a new user |
| Update a user |
| Delete a user |
Servers:
Tool | Description |
| List all servers (with filters) |
| Get server details |
| Create a server |
| Update server name, owner, description |
| Update server resources and allocations |
| Update startup config, egg, image |
| Suspend a server |
| Unsuspend a server |
| Trigger a reinstall of the server |
| Delete a server |
Nodes:
Tool | Description |
| List all nodes (with filters) |
| Get node details |
| Create a new node |
| Update a node |
| Delete a node |
| Get node wings configuration |
| List node allocations |
| Create allocations on a node |
| Delete an allocation |
Locations:
Tool | Description |
| List all locations |
| Get location details |
| Create a location |
| Update a location |
| Delete a location |
Nests & Eggs:
Tool | Description |
| List all nests |
| Get nest details (with eggs) |
| List eggs in a nest |
| Get egg details (with variables) |
Output Formats
All read tools accept an optional response_format parameter:
markdown(default) — human-readable tables and listsjson— raw JSON for programmatic use
API Key Types
Prefix | Type | Available Tools |
| Client API | Server management, files, databases, backups, schedules, allocations, subusers |
| Application API | Everything above + admin tools (users, servers, nodes, locations, nests) |
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceEnables AI agents to manage Minecraft servers through MCSManager, including instance control (start/stop/restart), file management, scheduled tasks, user management, and backup operations.Last updated5
- AlicenseAquality-maintenanceMCP server for Pterodactyl and Pelican game server panels. 73 tools for server management, power control, file operations, backups, schedules, databases, users, nodes, and eggs.Last updated23414
- AlicenseCqualityDmaintenanceEnables AI agents to manage server infrastructure through the 1Panel API, including Docker containers, databases, and system monitoring. It provides tools for website management, file operations, and application deployment via natural language commands.Last updated1529MIT
- AlicenseDqualityCmaintenanceMCP server for managing Pterodactyl game panel resources (users, servers, nodes, locations, etc.) via the Application API.Last updated503MIT
Related MCP Connectors
A basic MCP server to operate on the Postman API.
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
A MCP server built for developers enabling Git based project management with project and personal…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/Ethereal-Jay/pterodactyl-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server