create_addon
Provision a new Heroku add-on for your app by specifying the service, plan, and custom naming. Automates add-on setup and returns configuration details for easy integration.
Instructions
Create a new Heroku add-on for an application. Use this tool when you need to: 1) Provision a new add-on for your app, 2) Specify a particular service and plan, 3) Set a custom name for the add-on or attachment. The tool handles the provisioning process and returns the new add-on's details.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
app | Yes | Specifies the target Heroku app for add-on provisioning. Requirements and behaviors: 1) App must exist and be accessible to you with write permissions, 2) App region may affect which add-on services are available, 3) If app is in a Private Space, only add-ons compliant with the space requirements can be provisioned. The add-on will be provisioned directly to this app and config vars will be set automatically. | |
as | No | Sets a custom local name for the add-on attachment in the app. Important details: 1) Must be unique within the app (no other attachment can use the same name), 2) Used as a prefix for config vars (e.g., "CUSTOM_NAME_URL" instead of "HEROKU_POSTGRESQL_URL"), 3) Makes the add-on easier to identify in app context (e.g., "as: DATABASE" is clearer than "postgresql-curved-12345"), 4) When omitted, Heroku generates a default name based on the add-on service. Best practice: Use meaningful names that indicate the add-on's purpose (e.g., "PRIMARY_DB", "CACHE"). | |
name | No | Assigns a custom global identifier for the add-on instance. Key characteristics: 1) Must be unique across all add-ons in Heroku (not just your apps), 2) Can be used to reference the add-on from any app or context, 3) Useful for identifying the add-on in cross-app scenarios or automation, 4) When omitted, Heroku generates a unique name (e.g., "postgresql-curved-12345"). Best practice: Include app name or environment if using custom names (e.g., "myapp-prod-db"). | |
serviceAndPlan | Yes | Specifies which add-on service and plan to provision. Format and behavior: 1) Required format: "service_slug:plan_slug" (e.g., "heroku-postgresql:essential-0"), 2) If only service slug provided, the default (usually the cheapest or free) plan will be selected, 3) Some plans may have prerequisites (e.g., inside a private space, specific regions). Use list_addon_services and list_addon_plans tools to discover available options. |
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