andyciggy/heroku-mcp-server
If you are the rightful owner of heroku-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Heroku Platform MCP Server works on Common Runtime, Cedar Private and Shield Spaces, and Fir Private Spaces.
Tools
Functions exposed to the LLM to take actions
list_apps
List Heroku apps: owned, collaborator access, team/space filtering
get_app_info
Get app details: config, dynos, addons, access, domains
create_app
Create app: custom name, region (US/EU), team, private space
rename_app
Rename app: validate and update app name
transfer_app
Transfer app ownership to user/team
maintenance_on
Enable maintenance mode and redirect traffic for a Heroku app
maintenance_off
Disable maintenance mode and restore normal app operations
get_app_logs
App logs: monitor/debug/filter by dyno/process/source
list_private_spaces
Lists Heroku Private Spaces with CIDR blocks, regions, compliance and capacity details. JSON output supported.
list_teams
Lists accessible Heroku Teams. Use for: viewing teams, checking membership, getting team metadata, and verifying access. JSON output available.
list_addons
List add-ons: all apps or specific app, detailed metadata
get_addon_info
Get add-on details: plan, state, billing
create_addon
Create add-on: specify service, plan, custom names
list_addon_services
List available add-on services and features
list_addon_plans
List service plans: features, pricing, availability
pg_psql
Execute SQL queries: analyze, debug, modify schema, manage data
pg_info
View database status: config, metrics, resources, health
pg_ps
Monitor active queries: progress, resources, performance
pg_locks
Analyze locks: blocked queries, deadlocks, concurrency
pg_outliers
Find resource-heavy queries: performance, patterns, optimization
pg_credentials
Manage access: credentials, permissions, security, monitoring
pg_kill
Stop processes: stuck queries, blocking transactions, runaway operations
pg_maintenance
Track maintenance: windows, schedules, progress, planning
pg_backups
Manage backups: schedules, status, verification, recovery
pg_upgrade
Upgrade PostgreSQL: version migration, compatibility, safety
ps_list
List and monitor Heroku app dynos. View running dynos, check status/health, monitor process states, verify configurations.
ps_scale
Scale Heroku app dynos. Adjust quantities, change sizes, view formation details, manage resources.
ps_restart
Restart Heroku app processes. Restart specific dynos, process types, or all dynos. Reset dyno states selectively.
pipelines_create
Creates new Heroku deployment pipeline with configurable stages, apps, and team settings
pipelines_promote
Promotes apps between pipeline stages with configurable target applications
pipelines_list
Lists accessible Heroku pipelines with ownership and configuration details
pipelines_info
Displays detailed pipeline configuration, stages, and connected applications
deploy_to_heroku
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.
deploy_one_off_dyno
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:
- Use Heroku runtime
- Proper syntax/imports
- Organized code structure
- Package management:
- Define dependencies
- Minimize external deps
- Prefer native modules
Example package.json:
{
"type": "module",
"dependencies": {
"axios": "^1.6.0"
}
}
list_ai_available_models
List available AI inference models
provision_ai_model
Provision AI model access for app
make_ai_inference
Make inference request to Heroku AI API
Prompts
Interactive templates invoked by user choice
No prompts
Resources
Contextual data attached and managed by the client
