scalingo
Manage Scalingo PaaS apps, deployments, containers, logs and env vars from your AI assistant.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"scalingo": {
"url": "https://scalingo.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://scalingo.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (21)
🟢list_apps
List all Scalingo apps you can access in the current region. Scalingo API: GET /v1/apps. Returns { apps: [...] }.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_app(app)
Fetch a single app's details (region, stack, status, URLs, flags). Scalingo API: GET /v1/apps/{app}. Returns { app }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_containers(app)
List an app's container formation — the running process types with their amount and size (the current scaling). Scalingo API: GET /v1/apps/{app}/containers. Returns { containers: [{ name, amount, size }] }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_app_stats(app)
Real-time per-container resource stats (CPU / memory / swap usage) for an app. Scalingo API: GET /v1/apps/{app}/stats. Returns { stats: [...] }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_deployments(app, page, per_page)
List an app's deployments (most recent first), paginated. Scalingo API: GET /v1/apps/{app}/deployments. Returns { deployments: [...], meta: { pagination } }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"page": {
"description": "Page number (1-based) for paginated lists.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Entries per page (1-100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_deployment(app, deployment_id)
Fetch a single deployment's details (status, git_ref, pusher, image size, timestamps). Scalingo API: GET /v1/apps/{app}/deployments/{deployment_id}. Returns { deployment }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"deployment_id": {
"type": "string",
"description": "The deployment id."
}
},
"required": [
"app",
"deployment_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_app_logs(app, lines)
Fetch recent application log lines. Scalingo returns an authenticated logs_url (GET /v1/apps/{app}/logs → { logs_url }); this tool then downloads the last N lines from it (dump mode) and returns them as text. Returns { logs_url, lines }. If the follow-up download fails, only logs_url is returned so you can fetch it yourself.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"lines": {
"description": "Number of recent log lines to fetch (1-1000, default 100).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_variables(app)
List an app's environment variables. WARNING: this exposes secret VALUES (API keys, database URLs, etc.). Scalingo API: GET /v1/apps/{app}/variables. Returns { variables: [{ id, name, value }] }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_collaborators(app)
List an app's collaborators (users invited to the app) and their status. Scalingo API: GET /v1/apps/{app}/collaborators. Returns { collaborators: [...] }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_domains(app)
List an app's custom domains and their TLS/canonical status. Scalingo API: GET /v1/apps/{app}/domains. Returns { domains: [...] }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_addons(app)
List the addons (databases, services) provisioned on an app. Scalingo API: GET /v1/apps/{app}/addons. Returns { addons: [...] }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_addon_providers(category_id)
List the addon providers available on Scalingo (databases, monitoring, etc.) with their plans embedded. Scalingo API: GET /v1/addon_providers. Returns { addon_providers: [{ ..., plans: [...] }] }.
Eingabe-Schema
{
"type": "object",
"properties": {
"category_id": {
"description": "Optional category id to filter providers.",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_app_events(app, page, per_page, from)
List an app's activity events (deployments, scaling, restarts, collaborator changes, etc.), paginated. Scalingo API: GET /v1/apps/{app}/events. Returns { events: [...], meta: { pagination } }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"page": {
"description": "Page number (1-based) for paginated lists.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Entries per page (1-100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"from": {
"description": "Restrict to events from the last N hours (1-72).",
"type": "integer",
"minimum": 1,
"maximum": 72
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_operation(app, operation_id)
Poll the status of an asynchronous operation (e.g. a scale or restart returns an operation to track). Scalingo API: GET /v1/apps/{app}/operations/{operation_id}. Returns { operation } with status pending|running|done|error.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"operation_id": {
"type": "string",
"description": "The operation id (returned in the Location header of a scale/restart response)."
}
},
"required": [
"app",
"operation_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_regions
List the Scalingo regions available to your account, each with its API/dashboard/database hosts. Useful to discover the right SCALINGO_REGION. Scalingo API: GET (auth host) /v1/regions. Returns { regions: [...] }.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_account
Fetch the authenticated user's account (id, email, username, fullname, company). Scalingo API: GET /v1/users/self. Returns { user }.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢scalingo_request(path, query, on_auth_host)
Power-user escape hatch: GET any Scalingo API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path is taken after /v1 (e.g. "/apps/my-app/alerts"). By default hits the regional API; set on_auth_host:true for auth-host resources (regions, scm_integrations, tokens). Scalingo API: GET {path}.
Eingabe-Schema
{
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "API path after /v1, starting with a slash, e.g. \"/apps/my-app/notifiers\"."
},
"query": {
"description": "Optional query params object.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"on_auth_host": {
"description": "If true, target the auth host (auth.scalingo.com) instead of the regional API.",
"type": "boolean"
}
},
"required": [
"path"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴restart_app(app, scope)
MUTATES Scalingo infrastructure — restarts an app's containers. Optionally restart only specific process types via scope; omit scope to restart everything. Returns 202 Accepted (track via get_operation). Scalingo API: POST /v1/apps/{app}/restart.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"scope": {
"description": "Container types to restart, e.g. [\"web\",\"worker\"]. Omit to restart all.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴scale_app(app, containers)
MUTATES Scalingo infrastructure — sets the container formation (number and/or size of each process type). Only the container types you include are changed. Returns 202 Accepted (track via get_operation). Scalingo API: POST /v1/apps/{app}/scale.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"containers": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Process type name, e.g. \"web\" or \"worker\"."
},
"amount": {
"description": "Number of containers of this type.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"size": {
"description": "Container size, e.g. \"S\", \"M\", \"L\", \"2XL\".",
"type": "string"
}
},
"required": [
"name"
]
},
"description": "Formation entries to apply. Each entry needs a name plus amount and/or size."
}
},
"required": [
"app",
"containers"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴set_variables(app, variables)
MUTATES Scalingo infrastructure — creates or updates environment variables in bulk (each { name, value } is created if new or updated if it exists). This usually triggers a restart to apply the new env. Names ≤64 chars, values ≤8192 chars. Scalingo API: PUT /v1/apps/{app}/variables. Returns { variables }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"variables": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Variable name (uppercase convention, ≤64 chars)."
},
"value": {
"type": "string",
"description": "Variable value (≤8192 chars)."
}
},
"required": [
"name",
"value"
]
},
"description": "Environment variables to create/update."
}
},
"required": [
"app",
"variables"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴trigger_deployment(app, source_url, git_ref)
MUTATES Scalingo infrastructure — triggers a new deployment from a source archive URL (a tar.gz reachable by Scalingo). To roll back, re-deploy a previous git_ref/archive — there is no separate rollback endpoint. Scalingo API: POST /v1/apps/{app}/deployments. Returns { deployment }.
Eingabe-Schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"source_url": {
"type": "string",
"description": "URL of the source archive (tar.gz) Scalingo should build and deploy."
},
"git_ref": {
"description": "Optional git reference label for the deployment (branch/tag/SHA).",
"type": "string"
}
},
"required": [
"app",
"source_url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Empfohlene Prompts
get_appget_applist_appslist_appslist_appsget_appCommunity
Nachweis