Servers Playground How we check Add a server Log in

Scalingo MCP by usefulapi

Working · 575 ms

io.usefulapi/scalingov1.22.0 Domain verified

Manage Scalingo PaaS apps, deployments, containers, logs and env vars from your AI assistant.

Cloud & DevOps

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://scalingo.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

scalingo_get_account Read-only

Fetch the authenticated user's account (id, email, username, fullname, company). Scalingo API: GET /v1/users/self. Returns { user }.

This tool takes no arguments.

Scalingo MCP by usefulapi MCP server | mcptry

Tools (21)

scalingo_get_account

Fetch the authenticated user's account (id, email, username, fullname, company). Scalingo API: GET /v1/users/self. Returns { user }.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

scalingo_get_app

Fetch a single app's details (region, stack, status, URLs, flags). Scalingo API: GET /v1/apps/{app}. Returns { app }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    }
  }
}

scalingo_get_app_logs

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.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
lines	integer	Number of recent log lines to fetch (1-1000, default 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    },
    "lines": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of recent log lines to fetch (1-1000, default 100)."
    }
  }
}

scalingo_get_app_stats

Real-time per-container resource stats (CPU / memory / swap usage) for an app. Scalingo API: GET /v1/apps/{app}/stats. Returns { stats: [...] }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    }
  }
}

scalingo_get_deployment

Fetch a single deployment's details (status, git_ref, pusher, image size, timestamps). Scalingo API: GET /v1/apps/{app}/deployments/{deployment_id}. Returns { deployment }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
deployment_id*	string	The deployment id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app",
    "deployment_id"
  ],
  "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."
    }
  }
}

scalingo_get_operation

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.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
operation_id*	string	The operation id (returned in the Location header of a scale/restart response).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app",
    "operation_id"
  ],
  "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)."
    }
  }
}

scalingo_list_addon_providers

List the addon providers available on Scalingo (databases, monitoring, etc.) with their plans embedded. Scalingo API: GET /v1/addon_providers. Returns { addon_providers: [{ ..., plans: [...] }] }.

read-only

Argument	Type	Description
category_id	string	Optional category id to filter providers.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category_id": {
      "type": "string",
      "description": "Optional category id to filter providers."
    }
  }
}

scalingo_list_addons

List the addons (databases, services) provisioned on an app. Scalingo API: GET /v1/apps/{app}/addons. Returns { addons: [...] }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    }
  }
}

scalingo_list_app_events

List an app's activity events (deployments, scaling, restarts, collaborator changes, etc.), paginated. Scalingo API: GET /v1/apps/{app}/events. Returns { events: [...], meta: { pagination } }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
from	integer	Restrict to events from the last N hours (1-72).
page	integer	Page number (1-based) for paginated lists.
per_page	integer	Entries per page (1-100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    },
    "from": {
      "type": "integer",
      "maximum": 72,
      "minimum": 1,
      "description": "Restrict to events from the last N hours (1-72)."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based) for paginated lists."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page (1-100)."
    }
  }
}

scalingo_list_apps

List all Scalingo apps you can access in the current region. Scalingo API: GET /v1/apps. Returns { apps: [...] }.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

scalingo_list_collaborators

List an app's collaborators (users invited to the app) and their status. Scalingo API: GET /v1/apps/{app}/collaborators. Returns { collaborators: [...] }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    }
  }
}

scalingo_list_containers

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 }] }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    }
  }
}

scalingo_list_deployments

List an app's deployments (most recent first), paginated. Scalingo API: GET /v1/apps/{app}/deployments. Returns { deployments: [...], meta: { pagination } }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
page	integer	Page number (1-based) for paginated lists.
per_page	integer	Entries per page (1-100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based) for paginated lists."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page (1-100)."
    }
  }
}

scalingo_list_domains

List an app's custom domains and their TLS/canonical status. Scalingo API: GET /v1/apps/{app}/domains. Returns { domains: [...] }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    }
  }
}

scalingo_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: [...] }.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

scalingo_list_variables

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 }] }.

read-only

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    }
  }
}

scalingo_request

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}.

read-only

Argument	Type	Description
path*	string	API path after /v1, starting with a slash, e.g. "/apps/my-app/notifiers".
query	object	Optional query params object.
on_auth_host	boolean	If true, target the auth host (auth.scalingo.com) instead of the regional API.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "API path after /v1, starting with a slash, e.g. \"/apps/my-app/notifiers\"."
    },
    "query": {
      "type": "object",
      "description": "Optional query params object.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "on_auth_host": {
      "type": "boolean",
      "description": "If true, target the auth host (auth.scalingo.com) instead of the regional API."
    }
  }
}

scalingo_restart_app

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 scalingo_get_operation). Scalingo API: POST /v1/apps/{app}/restart.

destructive

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
scope	array	Container types to restart, e.g. ["web","worker"]. Omit to restart all.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    },
    "scope": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Container types to restart, e.g. [\"web\",\"worker\"]. Omit to restart all."
    }
  }
}

scalingo_scale_app

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 scalingo_get_operation). Scalingo API: POST /v1/apps/{app}/scale.

destructive

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
containers*	array	Formation entries to apply. Each entry needs a name plus amount and/or size.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app",
    "containers"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    },
    "containers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Process type name, e.g. \"web\" or \"worker\"."
          },
          "size": {
            "type": "string",
            "description": "Container size, e.g. \"S\", \"M\", \"L\", \"2XL\"."
          },
          "amount": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Number of containers of this type."
          }
        }
      },
      "minItems": 1,
      "description": "Formation entries to apply. Each entry needs a name plus amount and/or size."
    }
  }
}

scalingo_set_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 }.

destructive

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
variables*	array	Environment variables to create/update.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app",
    "variables"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    },
    "variables": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "value"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Variable name (uppercase convention, ≤64 chars)."
          },
          "value": {
            "type": "string",
            "description": "Variable value (≤8192 chars)."
          }
        }
      },
      "minItems": 1,
      "description": "Environment variables to create/update."
    }
  }
}

scalingo_trigger_deployment

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 }.

destructive

Argument	Type	Description
app*	string	The app name (e.g. my-production-app) or app id (app-…).
git_ref	string	Optional git reference label for the deployment (branch/tag/SHA).
source_url*	string	URL of the source archive (tar.gz) Scalingo should build and deploy.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "app",
    "source_url"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "The app name (e.g. my-production-app) or app id (app-…)."
    },
    "git_ref": {
      "type": "string",
      "description": "Optional git reference label for the deployment (branch/tag/SHA)."
    },
    "source_url": {
      "type": "string",
      "description": "URL of the source archive (tar.gz) Scalingo should build and deploy."
    }
  }
}