list_addons
List and filter Heroku add-ons across apps, retrieve detailed metadata in JSON, and view add-ons for specific apps using flexible filtering options.
Instructions
List Heroku add-ons with flexible filtering options. Use this tool when you need to: 1) View all add-ons across your apps, 2) List add-ons for a specific app, 3) Get detailed add-on metadata in JSON format.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
all | No | Forces the tool to list all add-ons across all apps accessible to the user. When true, this flag: 1) Overrides any default app setting from Git remote configuration, 2) Ignores the app flag if provided, 3) Shows a comprehensive list including: app name, add-on name, service plan, billing status, and provisioning status for each add-on. When false or omitted, respects the default app setting and the app flag. | |
app | No | Specifies a single Heroku app whose add-ons you want to list. Important behaviors: 1) When provided, shows add-ons and attachments only for this specific app, 2) When omitted, falls back to the default app from Git remote if configured, 3) If no default app exists, lists add-ons for all accessible apps, 4) This flag is completely ignored when all=true. The response includes both provisioned add-ons and add-on attachments from other apps. | |
json | No | Controls the response format and detail level. When true, returns a structured JSON response containing: 1) Complete add-on metadata including ID, name, and creation timestamp, 2) Detailed plan information including tier and cost, 3) Configuration variables set by the add-on, 4) Attachment details if the add-on is shared with other apps, 5) Billing and compliance status information. When false or omitted, returns a human-readable text format with basic information. |
Input Schema (JSON Schema)
You must be authenticated.
Other Tools from Heroku MCP server
- create_addon
- create_app
- deploy_to_heroku
- get_addon_info
- get_app_info
- get_app_logs
- list_addon_plans
- list_addons
- list_addon_services
- list_apps
- list_private_spaces
- list_teams
- maintenance_off
- maintenance_on
- pg_backups
- pg_credentials
- pg_info
- pg_kill
- pg_locks
- pg_maintenance
- pg_outliers
- pg_ps
- pg_psql
- pg_upgrade
- pipelines_create
- pipelines_info
- pipelines_list
- pipelines_promote
- ps_list
- ps_restart
- ps_scale
- rename_app
- transfer_app
Related Tools
- @heroku/heroku-mcp-server
- @heroku/heroku-mcp-server
- @heroku/heroku-mcp-server
- @heroku/heroku-mcp-server
- @heroku/heroku-mcp-server