Kastell

Official

Overview Schema Related Servers Score Discussions

server_info

Read-onlyIdempotent

Retrieve server info: list all servers, check cloud and Coolify status, verify reachability, and view available server types with prices for supported providers.

Instructions

Get information about Kastell-managed servers. Actions: 'list' all servers, 'status' check cloud provider + Coolify/bare status, 'health' check Coolify reachability or SSH access for bare servers, 'sizes' list available server types with prices for a provider+region. Requires provider API tokens as environment variables (HETZNER_TOKEN, DIGITALOCEAN_TOKEN, VULTR_TOKEN, LINODE_TOKEN) for status/sizes checks. Avoid calling repeatedly in short intervals to prevent provider API rate limiting. For fleet-wide health and audit scores across all servers, use server_fleet instead.

Input Schema

TableJSON Schema

Name	Required	Description
`mode`	No	Server mode filter for 'sizes' action. Coolify requires min 2GB RAM. Default: coolify
`action`	Yes	Action to perform: 'list' all servers, 'status' check server/cloud status, 'health' check Coolify reachability (or SSH reachability for bare servers), 'sizes' list available server types with prices for a provider+region
`region`	No	Region/location ID (required for 'sizes' action, e.g. 'nbg1' for Hetzner, 'fra1' for DigitalOcean)
`server`	No	Server name or IP. Required for single-server status/health. Omit for all servers.
`provider`	No	Cloud provider (required for 'sizes' action)

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

Changed1 schema field changedv2.3.0Jun 15, 2026

changedOutput schema / properties / result / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "list",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "servers": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "createdAt": {
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "ip": {
-              "type": "string"
-            },
-            "mode": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "provider": {
-              "type": "string"
-            },
-            "region": {
-              "type": "string"
-            },
-            "size": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "ip",
-            "provider",
-            "region",
-            "size",
-            "id",
-            "mode",
-            "createdAt"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggested_actions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "command": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "command",
-            "reason"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "total": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "action",
-      "servers",
-      "total",
-      "suggested_actions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "status",
-        "type": "string"
-      },
-      "results": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "error": {
-              "type": "string"
-            },
-            "ip": {
-              "type": "string"
-            },
-            "mode": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "platformStatus": {
-              "type": "string"
-            },
-            "provider": {
-              "type": "string"
-            },
-            "region": {
-              "type": "string"
-            },
-            "serverStatus": {
-              "type": "string"
-            },
-            "size": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "ip",
-            "provider",
-            "region",
-            "size",
-            "mode",
-            "serverStatus",
-            "platformStatus"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggested_actions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "command": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "command",
-            "reason"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "errors": {
-            "type": "number"
-          },
-          "notReachable": {
-            "type": "number"
-          },
-          "running": {
-            "type": "number"
-          },
-          "total": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total",
-          "running",
-          "notReachable",
-          "errors"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "action",
-      "results",
-      "summary",
-      "suggested_actions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "health",
-        "type": "string"
-      },
-      "results": {
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggested_actions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "command": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "command",
-            "reason"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "bare": {
-            "type": "number"
-          },
-          "notReachable": {
-            "type": "number"
-          },
-          "running": {
-            "type": "number"
-          },
-          "total": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total",
-          "running",
-          "notReachable",
-          "bare"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "action",
-      "results",
-      "summary",
-      "suggested_actions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "sizes",
-        "type": "string"
-      },
-      "mode": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "region": {
-        "type": "string"
-      },
-      "sizes": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "disk": {
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "price": {
-              "type": "string"
-            },
-            "ram": {
-              "type": "string"
-            },
-            "vcpu": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "id",
-            "name",
-            "vcpu",
-            "ram",
-            "disk",
-            "price"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggested_actions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "command": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "command",
-            "reason"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "total": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "action",
-      "provider",
-      "region",
-      "mode",
-      "sizes",
-      "total",
-      "suggested_actions"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "list",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "servers": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "createdAt": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "ip": {
+              "type": "string"
+            },
+            "mode": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "provider": {
+              "type": "string"
+            },
+            "region": {
+              "type": "string"
+            },
+            "size": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "ip",
+            "provider",
+            "region",
+            "size",
+            "id",
+            "mode",
+            "createdAt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggested_actions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "command": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "command",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "total": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "action",
+      "servers",
+      "total",
+      "suggested_actions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "status",
+        "type": "string"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "error": {
+              "type": "string"
+            },
+            "ip": {
+              "type": "string"
+            },
+            "mode": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "platformStatus": {
+              "type": "string"
+            },
+            "provider": {
+              "type": "string"
+            },
+            "region": {
+              "type": "string"
+            },
+            "serverStatus": {
+              "type": "string"
+            },
+            "size": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "ip",
+            "provider",
+            "region",
+            "size",
+            "mode",
+            "serverStatus",
+            "platformStatus"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggested_actions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "command": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "command",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "errors": {
+            "type": "number"
+          },
+          "notReachable": {
+            "type": "number"
+          },
+          "running": {
+            "type": "number"
+          },
+          "total": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total",
+          "running",
+          "notReachable",
+          "errors"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "action",
+      "results",
+      "summary",
+      "suggested_actions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "health",
+        "type": "string"
+      },
+      "coolifyUrl": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "dokployUrl": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "hostKeyMismatch": {
+        "type": "boolean"
+      },
+      "ip": {
+        "type": "string"
+      },
+      "mode": {
+        "type": "string"
+      },
+      "platformStatus": {
+        "type": "string"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "server": {
+        "type": "string"
+      },
+      "sshReachable": {
+        "type": "boolean"
+      },
+      "suggested_actions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "command": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "command",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "bare": {
+            "type": "number"
+          },
+          "notReachable": {
+            "type": "number"
+          },
+          "running": {
+            "type": "number"
+          },
+          "total": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total",
+          "running",
+          "notReachable",
+          "bare"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "action",
+      "suggested_actions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "sizes",
+        "type": "string"
+      },
+      "mode": {
+        "type": "string"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "region": {
+        "type": "string"
+      },
+      "sizes": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "disk": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "price": {
+              "type": "string"
+            },
+            "ram": {
+              "type": "string"
+            },
+            "vcpu": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "id",
+            "name",
+            "vcpu",
+            "ram",
+            "disk",
+            "price"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggested_actions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "command": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "command",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "total": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "action",
+      "provider",
+      "region",
+      "mode",
+      "sizes",
+      "total",
+      "suggested_actions"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedv2.2.5May 8, 2026

changedOutput schema / properties / result / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "list",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "servers": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "createdAt": {
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "ip": {
-              "type": "string"
-            },
-            "mode": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "provider": {
-              "type": "string"
-            },
-            "region": {
-              "type": "string"
-            },
-            "size": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "ip",
-            "provider",
-            "region",
-            "size",
-            "id",
-            "mode",
-            "createdAt"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggested_actions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "command": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "command",
-            "reason"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "total": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "action",
-      "servers",
-      "total",
-      "suggested_actions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "status",
-        "type": "string"
-      },
-      "results": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "error": {
-              "type": "string"
-            },
-            "ip": {
-              "type": "string"
-            },
-            "mode": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "platformStatus": {
-              "type": "string"
-            },
-            "provider": {
-              "type": "string"
-            },
-            "region": {
-              "type": "string"
-            },
-            "serverStatus": {
-              "type": "string"
-            },
-            "size": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "ip",
-            "provider",
-            "region",
-            "size",
-            "mode",
-            "serverStatus",
-            "platformStatus"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggested_actions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "command": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "command",
-            "reason"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "errors": {
-            "type": "number"
-          },
-          "notReachable": {
-            "type": "number"
-          },
-          "running": {
-            "type": "number"
-          },
-          "total": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total",
-          "running",
-          "notReachable",
-          "errors"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "action",
-      "results",
-      "summary",
-      "suggested_actions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "health",
-        "type": "string"
-      },
-      "results": {
-        "items": {
-          "additionalProperties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggested_actions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "command": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "command",
-            "reason"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "bare": {
-            "type": "number"
-          },
-          "notReachable": {
-            "type": "number"
-          },
-          "running": {
-            "type": "number"
-          },
-          "total": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total",
-          "running",
-          "notReachable",
-          "bare"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "action",
-      "results",
-      "summary",
-      "suggested_actions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "sizes",
-        "type": "string"
-      },
-      "mode": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "region": {
-        "type": "string"
-      },
-      "sizes": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "disk": {
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "price": {
-              "type": "number"
-            },
-            "ram": {
-              "type": "string"
-            },
-            "vcpu": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "id",
-            "name",
-            "vcpu",
-            "ram",
-            "disk",
-            "price"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggested_actions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "command": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "command",
-            "reason"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "total": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "action",
-      "provider",
-      "region",
-      "mode",
-      "sizes",
-      "total",
-      "suggested_actions"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "list",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "servers": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "createdAt": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "ip": {
+              "type": "string"
+            },
+            "mode": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "provider": {
+              "type": "string"
+            },
+            "region": {
+              "type": "string"
+            },
+            "size": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "ip",
+            "provider",
+            "region",
+            "size",
+            "id",
+            "mode",
+            "createdAt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggested_actions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "command": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "command",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "total": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "action",
+      "servers",
+      "total",
+      "suggested_actions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "status",
+        "type": "string"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "error": {
+              "type": "string"
+            },
+            "ip": {
+              "type": "string"
+            },
+            "mode": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "platformStatus": {
+              "type": "string"
+            },
+            "provider": {
+              "type": "string"
+            },
+            "region": {
+              "type": "string"
+            },
+            "serverStatus": {
+              "type": "string"
+            },
+            "size": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "ip",
+            "provider",
+            "region",
+            "size",
+            "mode",
+            "serverStatus",
+            "platformStatus"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggested_actions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "command": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "command",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "errors": {
+            "type": "number"
+          },
+          "notReachable": {
+            "type": "number"
+          },
+          "running": {
+            "type": "number"
+          },
+          "total": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total",
+          "running",
+          "notReachable",
+          "errors"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "action",
+      "results",
+      "summary",
+      "suggested_actions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "health",
+        "type": "string"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggested_actions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "command": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "command",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "bare": {
+            "type": "number"
+          },
+          "notReachable": {
+            "type": "number"
+          },
+          "running": {
+            "type": "number"
+          },
+          "total": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total",
+          "running",
+          "notReachable",
+          "bare"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "action",
+      "results",
+      "summary",
+      "suggested_actions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "sizes",
+        "type": "string"
+      },
+      "mode": {
+        "type": "string"
+      },
+      "provider": {
+        "type": "string"
+      },
+      "region": {
+        "type": "string"
+      },
+      "sizes": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "disk": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "price": {
+              "type": "string"
+            },
+            "ram": {
+              "type": "string"
+            },
+            "vcpu": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "id",
+            "name",
+            "vcpu",
+            "ram",
+            "disk",
+            "price"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggested_actions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "command": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "command",
+            "reason"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "total": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "action",
+      "provider",
+      "region",
+      "mode",
+      "sizes",
+      "total",
+      "suggested_actions"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedv2.2.4May 7, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "result": {
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "action": {
+              "const": "list",
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "servers": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "ip": {
+                    "type": "string"
+                  },
+                  "mode": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "provider": {
+                    "type": "string"
+                  },
+                  "region": {
+                    "type": "string"
+                  },
+                  "size": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "ip",
+                  "provider",
+                  "region",
+                  "size",
+                  "id",
+                  "mode",
+                  "createdAt"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "suggested_actions": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "command": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "command",
+                  "reason"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "total": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "action",
+            "servers",
+            "total",
+            "suggested_actions"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "action": {
+              "const": "status",
+              "type": "string"
+            },
+            "results": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "error": {
+                    "type": "string"
+                  },
+                  "ip": {
+                    "type": "string"
+                  },
+                  "mode": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "platformStatus": {
+                    "type": "string"
+                  },
+                  "provider": {
+                    "type": "string"
+                  },
+                  "region": {
+                    "type": "string"
+                  },
+                  "serverStatus": {
+                    "type": "string"
+                  },
+                  "size": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name",
+                  "ip",
+                  "provider",
+                  "region",
+                  "size",
+                  "mode",
+                  "serverStatus",
+                  "platformStatus"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "suggested_actions": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "command": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "command",
+                  "reason"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "summary": {
+              "additionalProperties": false,
+              "properties": {
+                "errors": {
+                  "type": "number"
+                },
+                "notReachable": {
+                  "type": "number"
+                },
+                "running": {
+                  "type": "number"
+                },
+                "total": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "total",
+                "running",
+                "notReachable",
+                "errors"
+              ],
+              "type": "object"
+            }
+          },
+          "required": [
+            "action",
+            "results",
+            "summary",
+            "suggested_actions"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "action": {
+              "const": "health",
+              "type": "string"
+            },
+            "results": {
+              "items": {
+                "additionalProperties": {},
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "suggested_actions": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "command": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "command",
+                  "reason"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "summary": {
+              "additionalProperties": false,
+              "properties": {
+                "bare": {
+                  "type": "number"
+                },
+                "notReachable": {
+                  "type": "number"
+                },
+                "running": {
+                  "type": "number"
+                },
+                "total": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "total",
+                "running",
+                "notReachable",
+                "bare"
+              ],
+              "type": "object"
+            }
+          },
+          "required": [
+            "action",
+            "results",
+            "summary",
+            "suggested_actions"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "action": {
+              "const": "sizes",
+              "type": "string"
+            },
+            "mode": {
+              "type": "string"
+            },
+            "provider": {
+              "type": "string"
+            },
+            "region": {
+              "type": "string"
+            },
+            "sizes": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "disk": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "price": {
+                    "type": "number"
+                  },
+                  "ram": {
+                    "type": "string"
+                  },
+                  "vcpu": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "id",
+                  "name",
+                  "vcpu",
+                  "ram",
+                  "disk",
+                  "price"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "suggested_actions": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "command": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "command",
+                  "reason"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "total": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "action",
+            "provider",
+            "region",
+            "mode",
+            "sizes",
+            "total",
+            "suggested_actions"
+          ],
+          "type": "object"
+        }
+      ]
+    }
+  },
+  "required": [
+    "result"
+  ],
+  "type": "object"
+}

First observedv1.14.0Mar 25, 2026

TDQS

A4.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, so the description adds value by specifying required provider tokens and rate limit warnings. Could be more explicit about error behavior if tokens are missing.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences: overview, action details, prerequisites/limits, alternative tool. No redundancy, front-loaded with key info.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers all necessary aspects: actions, parameters, prerequisites, rate limiting, and alternative tool. Output schema exists, so return values need not be described.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema has 100% coverage, but description adds context: action summary, server required for single-server, provider+region for sizes, mode default. Baseline 3 with added value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it provides server information with specific actions (list, status, health, sizes) and distinguishes from sibling tool server_fleet which offers fleet-wide health and audit scores.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly describes when to use each action, mentions required environment variables, warns against frequent calls for rate limiting, and directs to server_fleet for fleet-wide health.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/kastelldev/kastell'

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