scalingo
Manage Scalingo PaaS apps, deployments, containers, logs and env vars from your AI assistant.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"scalingo": {
"url": "https://scalingo.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://scalingo.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (21)
🟢list_apps
List all Scalingo apps you can access in the current region. Scalingo API: GET /v1/apps. Returns { apps: [...] }.
Esquema de entrada
{
"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 }.
Esquema de entrada
{
"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 }] }.
Esquema de entrada
{
"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: [...] }.
Esquema de entrada
{
"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 } }.
Esquema de entrada
{
"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 }.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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 }] }.
Esquema de entrada
{
"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: [...] }.
Esquema de entrada
{
"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: [...] }.
Esquema de entrada
{
"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: [...] }.
Esquema de entrada
{
"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: [...] }] }.
Esquema de entrada
{
"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 } }.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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: [...] }.
Esquema de entrada
{
"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 }.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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 }.
Esquema de entrada
{
"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 }.
Esquema de entrada
{
"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#"
}Prompts recomendados
get_appget_applist_appslist_appslist_appsget_appComunidad
Evidencia