# scalingo MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-scalingo
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://scalingo.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://scalingo.usefulapi.io/mcp

## Tools
- list_apps (List apps) - List all Scalingo apps you can access in the current region. Scalingo API: GET /v1/apps. Returns { apps: [...] }. Endpoint: https://scalingo.usefulapi.io/mcp
- get_app (Get an app) - Fetch a single app's details (region, stack, status, URLs, flags). Scalingo API: GET /v1/apps/{app}. Returns { app }. Endpoint: https://scalingo.usefulapi.io/mcp
- list_containers (List containers (formation)) - 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 }] }. Endpoint: https://scalingo.usefulapi.io/mcp
- get_app_stats (Get container stats) - Real-time per-container resource stats (CPU / memory / swap usage) for an app. Scalingo API: GET /v1/apps/{app}/stats. Returns { stats: [...] }. Endpoint: https://scalingo.usefulapi.io/mcp
- list_deployments (List deployments) - List an app's deployments (most recent first), paginated. Scalingo API: GET /v1/apps/{app}/deployments. Returns { deployments: [...], meta: { pagination } }. Endpoint: https://scalingo.usefulapi.io/mcp
- get_deployment (Get a 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 }. Endpoint: https://scalingo.usefulapi.io/mcp
- get_app_logs (Get recent 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. Endpoint: https://scalingo.usefulapi.io/mcp
- list_variables (List environment 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 }] }. Endpoint: https://scalingo.usefulapi.io/mcp
- list_collaborators (List collaborators) - List an app's collaborators (users invited to the app) and their status. Scalingo API: GET /v1/apps/{app}/collaborators. Returns { collaborators: [...] }. Endpoint: https://scalingo.usefulapi.io/mcp
- list_domains (List domains) - List an app's custom domains and their TLS/canonical status. Scalingo API: GET /v1/apps/{app}/domains. Returns { domains: [...] }. Endpoint: https://scalingo.usefulapi.io/mcp
- list_addons (List addons) - List the addons (databases, services) provisioned on an app. Scalingo API: GET /v1/apps/{app}/addons. Returns { addons: [...] }. Endpoint: https://scalingo.usefulapi.io/mcp
- list_addon_providers (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: [...] }] }. Endpoint: https://scalingo.usefulapi.io/mcp
- list_app_events (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 } }. Endpoint: https://scalingo.usefulapi.io/mcp
- get_operation (Get an 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. Endpoint: https://scalingo.usefulapi.io/mcp
- list_regions (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: [...] }. Endpoint: https://scalingo.usefulapi.io/mcp
- get_account (Get current account) - Fetch the authenticated user's account (id, email, username, fullname, company). Scalingo API: GET /v1/users/self. Returns { user }. Endpoint: https://scalingo.usefulapi.io/mcp
- scalingo_request (Raw read 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}. Endpoint: https://scalingo.usefulapi.io/mcp
- restart_app (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 get_operation). Scalingo API: POST /v1/apps/{app}/restart. Endpoint: https://scalingo.usefulapi.io/mcp
- scale_app (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 get_operation). Scalingo API: POST /v1/apps/{app}/scale. Endpoint: https://scalingo.usefulapi.io/mcp
- set_variables (Set environment variables (bulk)) - 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 }. Endpoint: https://scalingo.usefulapi.io/mcp
- trigger_deployment (Trigger a 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 }. Endpoint: https://scalingo.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 17, 2026
- Source: https://registry.modelcontextprotocol.io
