@heroku/mcp-server

Execute SQL queries: analyze, debug, modify schema, manage data

Disable maintenance mode and restore normal app operations

Stop processes: stuck queries, blocking transactions, runaway operations

Track maintenance: windows, schedules, progress, planning

Analyze locks: blocked queries, deadlocks, concurrency

Enable maintenance mode and redirect traffic for a Heroku app

Displays detailed pipeline configuration, stages, and connected applications

List service plans: features, pricing, availability

Rename app: validate and update app name

Restart Heroku app processes. Restart specific dynos, process types, or all dynos. Reset dyno states selectively.

Create app: custom name, region (US/EU), team, private space

Create add-on: specify service, plan, custom names

Lists accessible Heroku pipelines with ownership and configuration details

List available add-on services and features

Run code/commands in Heroku one-off dyno with network and filesystem access. Requirements: - Show command output - Use app_info for buildpack detection - Support shell setup commands - Use stdout/stderr Features: - Network/filesystem access - Environment variables - File operations - Temp directory handling Usage: 1. Use Heroku runtime 2. Proper syntax/imports 3. Organized code structure 4. Package management: - Define dependencies - Minimize external deps - Prefer native modules Example package.json: ```json { "type": "module", "dependencies": { "axios": "^1.6.0" } } ```

Use for all deployments. Deploys new/existing apps, with or without teams/spaces, and env vars to Heroku. Ask for app name if missing. Requires valid app.json via appJson param.

Lists Heroku Private Spaces with CIDR blocks, regions, compliance and capacity details. JSON output supported.

Manage access: credentials, permissions, security, monitoring

List and monitor Heroku app dynos. View running dynos, check status/health, monitor process states, verify configurations.

Upgrade PostgreSQL: version migration, compatibility, safety

Manage backups: schedules, status, verification, recovery

View database status: config, metrics, resources, health

Find resource-heavy queries: performance, patterns, optimization

Promotes apps between pipeline stages with configurable target applications

List Heroku apps: owned, collaborator access, team/space filtering

Get add-on details: plan, state, billing

Monitor active queries: progress, resources, performance

Scale Heroku app dynos. Adjust quantities, change sizes, view formation details, manage resources.

Get app details: config, dynos, addons, access, domains

App logs: monitor/debug/filter by dyno/process/source

List add-ons: all apps or specific app, detailed metadata

Creates new Heroku deployment pipeline with configurable stages, apps, and team settings

Lists accessible Heroku Teams. Use for: viewing teams, checking membership, getting team metadata, and verifying access. JSON output available.