Tools Reference

The InstaPods MCP server exposes 12 tools that AI assistants can call. These cover pod management, file operations, command execution, and logs.

​

Pod Management

​

list_pods

List all pods for the authenticated team. Parameters: None Returns: Array of pod objects with name, status, preset, plan, region, URL, and resource details. Example prompt: “Show me all my pods”

---

​

get_pod

Get details of a specific pod by name. Returns: Full pod object including status, IP, domain, preset, plan, SSH info, and resource allocation. Example prompt: “What’s the status of my-api?“

---

​

create_pod

Create a new pod. Billing checks (payment method, subscription) are enforced automatically. Returns: Created pod object. Example prompt: “Create a Python pod called data-api on the build plan”

---

​

manage_pod

Start, stop, restart, reload, or delete a pod. Returns: Updated pod object, reload status with health check, or deletion confirmation. The reload action is the most powerful — it:

1. Auto-starts the pod if stopped
2. Installs dependencies (npm install, pip install, composer install)
3. Detects entry points and frameworks (gunicorn, Express, Laravel)
4. Restarts application services
5. Runs a health check and returns service status

Example prompts: “Restart my-api” · “Reload my-app after I changed the code” · “Delete test-pod”

---

​

File Operations

​

list_files

List files in a directory inside a pod. Returns: Array of file entries with name, permissions, size, and is_dir flag. Example prompt: “Show me the files in my-api”

---

​

read_file

Read the contents of a file inside a pod. Returns: File content as text. Example prompt: “Show me the package.json in my-api” or “Read /home/instapod/app/index.js”

---

​

write_file

Write content to a file inside a pod. Creates the file and parent directories if they don’t exist. Returns: Confirmation with saved path. Example prompt: “Create an index.js in my-api that serves a hello world Express app”

---

​

Command Execution

​

exec_command

Run a shell command inside a pod. Runs as the instapod user (same as SSH access). Returns: Command output, exit code, and any error. Example prompt: “Run ls -la ~/app in my-api” or “Install express in my-api with npm”

---

​

Logs

​

get_logs

Get application logs from a pod via journalctl. Returns: Log output as text. Example prompt: “Show me the logs for my-api” or “Get the last 50 nginx logs from my-app”

---

​

Catalog

​

list_presets

List available pod presets. Parameters: None Example prompt: “What presets are available?“

---

​

list_plans

List available pricing plans. Parameters: None Returns: Array of plans with slug, name, CPU, memory, storage, and price. Example prompt: “What plans do you have?“

---

​

list_regions

List available deployment regions. Parameters: None Returns: Array of regions with slug and server count. Example prompt: “What regions can I deploy to?”