Heroku

Heroku MCP Server for Cloudflare Workers

Available Tools

95 tools available in the Heroku MCP server. Each tool can be called by AI assistants to perform specific actions.

heroku_delete_addon_attachment

Remove an add-on attachment.

Args:

attachmentId: Attachment ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "attachmentId"
  ],
  "properties": {
    "attachmentId": {
      "type": "string",
      "description": "Attachment ID"
    }
  }
}

heroku_list_addon_services

List all available add-on services.

Args:

format: Response format ('json' or 'markdown')

Returns: List of available add-on services.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

heroku_delete_pipeline

Delete a pipeline.

Args:

pipelineIdOrName: Pipeline ID or name

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "pipelineIdOrName"
  ],
  "properties": {
    "pipelineIdOrName": {
      "type": "string",
      "description": "Pipeline ID or name"
    }
  }
}

heroku_get_addon_service

Get information about a specific add-on service.

Args:

serviceIdOrName: Service ID or name (e.g., 'heroku-postgresql')
format: Response format ('json' or 'markdown')

Returns: Add-on service details.

{
  "type": "object",
  "required": [
    "serviceIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "serviceIdOrName": {
      "type": "string",
      "description": "Service ID or name"
    }
  }
}

heroku_create_addon_attachment

Attach an existing add-on to another app.

Args:

addon: Add-on ID or name to attach
app: App ID or name to attach to
name: Name for the attachment (optional)
namespace: Namespace for the attachment (optional)

Returns: The created attachment details.

{
  "type": "object",
  "required": [
    "addon",
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "App ID or name to attach to"
    },
    "name": {
      "type": "string",
      "description": "Attachment name"
    },
    "addon": {
      "type": "string",
      "description": "Add-on ID or name"
    },
    "namespace": {
      "type": "string",
      "description": "Attachment namespace"
    }
  }
}

heroku_list_addons

List all add-ons accessible to the authenticated user.

Args:

format: Response format ('json' or 'markdown')

Returns: List of all add-ons.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

heroku_list_app_addons

List all add-ons attached to a specific app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of add-ons for the app.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_addon

Get detailed information about a specific add-on.

Args:

addonIdOrName: Add-on ID or name
format: Response format ('json' or 'markdown')

Returns: Add-on details including plan, state, and config vars.

{
  "type": "object",
  "required": [
    "addonIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "addonIdOrName": {
      "type": "string",
      "description": "Add-on ID or name"
    }
  }
}

heroku_create_addon

Create a new add-on for an app.

Args:

appIdOrName: App ID or name
plan: Add-on plan (e.g., 'heroku-postgresql:essential-0')
name: Custom name for the add-on (optional)
attachmentName: Name for the attachment (optional)
config: Add-on configuration options (optional)

Returns: The created add-on details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "plan"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Custom add-on name"
    },
    "plan": {
      "type": "string",
      "description": "Add-on plan (e.g., heroku-postgresql:essential-0)"
    },
    "config": {
      "type": "object",
      "description": "Add-on config options"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "attachmentName": {
      "type": "string",
      "description": "Attachment name"
    }
  }
}

heroku_update_addon

Update an add-on (typically to change plan).

Args:

appIdOrName: App ID or name
addonIdOrName: Add-on ID or name
plan: New add-on plan
name: New name for the add-on (optional)

Returns: Updated add-on details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "addonIdOrName",
    "plan"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New add-on name"
    },
    "plan": {
      "type": "string",
      "description": "New add-on plan"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "addonIdOrName": {
      "type": "string",
      "description": "Add-on ID or name"
    }
  }
}

heroku_delete_addon

Delete an add-on from an app.

Args:

appIdOrName: App ID or name
addonIdOrName: Add-on ID or name to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "addonIdOrName"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "addonIdOrName": {
      "type": "string",
      "description": "Add-on ID or name to delete"
    }
  }
}

heroku_list_addon_attachments

List all add-on attachments for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of add-on attachments.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_list_apps

List all Heroku apps accessible to the authenticated user.

Returns a paginated list of apps with their details including name, region, stack, and URLs.

Args:

format: Response format ('json' or 'markdown')

Returns: List of apps with their configurations.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

heroku_get_app

Get detailed information about a specific Heroku app.

Args:

appIdOrName: The app ID or name
format: Response format ('json' or 'markdown')

Returns: Detailed app information including configuration, URLs, and metadata.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_create_app

Create a new Heroku app.

Args:

name: Unique name for the app (optional, Heroku generates one if not provided)
region: Region to create the app in (e.g., 'us', 'eu')
stack: Stack to use (e.g., 'heroku-22', 'heroku-24')
team: Team to create the app in (optional)

Returns: The created app details.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Unique app name (auto-generated if not provided)"
    },
    "team": {
      "type": "string",
      "description": "Team name or ID"
    },
    "stack": {
      "type": "string",
      "description": "Stack (e.g., heroku-22, heroku-24)"
    },
    "region": {
      "type": "string",
      "description": "Region (e.g., us, eu)"
    }
  }
}

heroku_update_app

Update an existing Heroku app.

Args:

appIdOrName: App ID or name to update
name: New name for the app
maintenance: Enable/disable maintenance mode
build_stack: Change the build stack

Returns: The updated app details.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New app name"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "build_stack": {
      "type": "string",
      "description": "Build stack"
    },
    "maintenance": {
      "type": "boolean",
      "description": "Enable maintenance mode"
    }
  }
}

heroku_delete_app

Delete a Heroku app. This action is irreversible.

Args:

appIdOrName: App ID or name to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name to delete"
    }
  }
}

heroku_list_team_apps

List all apps belonging to a specific team.

Args:

teamNameOrId: Team name or ID
format: Response format ('json' or 'markdown')

Returns: List of apps in the team.

{
  "type": "object",
  "required": [
    "teamNameOrId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    }
  }
}

heroku_list_app_features

List all features (labs) available for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of app features with their enabled status.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_app_feature

Get information about a specific app feature.

Args:

appIdOrName: App ID or name
featureIdOrName: Feature ID or name
format: Response format ('json' or 'markdown')

Returns: Feature details including enabled status.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "featureIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "featureIdOrName": {
      "type": "string",
      "description": "Feature ID or name"
    }
  }
}

heroku_update_app_feature

Enable or disable an app feature.

Args:

appIdOrName: App ID or name
featureIdOrName: Feature ID or name
enabled: Whether to enable or disable the feature

Returns: Updated feature details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "featureIdOrName",
    "enabled"
  ],
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "Enable or disable the feature"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "featureIdOrName": {
      "type": "string",
      "description": "Feature ID or name"
    }
  }
}

heroku_list_collaborators

List all collaborators on an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of collaborators with their details.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_collaborator

Get information about a specific collaborator.

Args:

appIdOrName: App ID or name
collaboratorEmailOrId: Collaborator email or ID
format: Response format ('json' or 'markdown')

Returns: Collaborator details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "collaboratorEmailOrId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "collaboratorEmailOrId": {
      "type": "string",
      "description": "Collaborator email or ID"
    }
  }
}

heroku_add_collaborator

Add a collaborator to an app.

Args:

appIdOrName: App ID or name
user: Email address of the user to add
silent: Skip sending invitation email (optional)

Returns: The added collaborator details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "user"
  ],
  "properties": {
    "user": {
      "type": "string",
      "description": "Email address of user to add"
    },
    "silent": {
      "type": "boolean",
      "description": "Skip sending invitation email"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_remove_collaborator

Remove a collaborator from an app.

Args:

appIdOrName: App ID or name
collaboratorEmailOrId: Collaborator email or ID

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "collaboratorEmailOrId"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "collaboratorEmailOrId": {
      "type": "string",
      "description": "Collaborator email or ID"
    }
  }
}

heroku_get_config_vars

Get all config vars (environment variables) for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: Object containing all config vars as key-value pairs.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_update_config_vars

Update config vars for an app. Set a value to null to delete a config var.

Args:

appIdOrName: App ID or name
vars: Object containing config vars to set or delete (null to delete)

Returns: Updated config vars object.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "vars": {
      "type": "object",
      "description": "Config vars to set (null to delete)"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_set_config_var

Set a single config var for an app.

Args:

appIdOrName: App ID or name
key: Config var key
value: Config var value

Returns: Updated config vars object.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Config var key"
    },
    "value": {
      "type": "string",
      "description": "Config var value"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_delete_config_var

Delete a config var from an app.

Args:

appIdOrName: App ID or name
key: Config var key to delete

Returns: Updated config vars object.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Config var key to delete"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_list_domains

List all domains for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of domains with their status and DNS targets.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_domain

Get information about a specific domain.

Args:

appIdOrName: App ID or name
domainIdOrHostname: Domain ID or hostname
format: Response format ('json' or 'markdown')

Returns: Domain details including status and DNS configuration.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "domainIdOrHostname"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "domainIdOrHostname": {
      "type": "string",
      "description": "Domain ID or hostname"
    }
  }
}

heroku_create_domain

Add a custom domain to an app.

Args:

appIdOrName: App ID or name
hostname: The hostname to add (e.g., 'www.example.com')
sniEndpoint: SNI endpoint ID or name (optional, for SSL)

Returns: The created domain details including DNS target.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "hostname"
  ],
  "properties": {
    "hostname": {
      "type": "string",
      "description": "Hostname to add"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "sniEndpoint": {
      "type": "string",
      "description": "SNI endpoint for SSL"
    }
  }
}

heroku_delete_domain

Remove a custom domain from an app.

Args:

appIdOrName: App ID or name
domainIdOrHostname: Domain ID or hostname to remove

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "domainIdOrHostname"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "domainIdOrHostname": {
      "type": "string",
      "description": "Domain ID or hostname to delete"
    }
  }
}

heroku_list_dynos

List all dynos running for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of dynos with their state, type, size, and command.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_dyno

Get information about a specific dyno.

Args:

appIdOrName: App ID or name
dynoIdOrName: Dyno ID or name (e.g., 'web.1')
format: Response format ('json' or 'markdown')

Returns: Detailed dyno information.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "dynoIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "dynoIdOrName": {
      "type": "string",
      "description": "Dyno ID or name (e.g., web.1)"
    }
  }
}

heroku_run_command

Run a one-off command on a new dyno.

Args:

appIdOrName: App ID or name
command: Command to execute
size: Dyno size (e.g., 'basic', 'standard-1x', 'standard-2x')
timeToLive: Seconds before dyno is killed (max 86400)

Returns: The created dyno details including attach URL for streaming output.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "command"
  ],
  "properties": {
    "size": {
      "type": "string",
      "description": "Dyno size"
    },
    "command": {
      "type": "string",
      "description": "Command to execute"
    },
    "timeToLive": {
      "type": "number",
      "description": "Seconds before dyno is killed (max 86400)"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_restart_dyno

Restart a specific dyno.

Args:

appIdOrName: App ID or name
dynoIdOrName: Dyno ID or name to restart (e.g., 'web.1')

Returns: Confirmation of restart.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "dynoIdOrName"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "dynoIdOrName": {
      "type": "string",
      "description": "Dyno ID or name to restart"
    }
  }
}

heroku_restart_all_dynos

Restart all dynos for an app.

Args:

appIdOrName: App ID or name

Returns: Confirmation of restart.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_stop_dyno

Stop a specific dyno.

Args:

appIdOrName: App ID or name
dynoIdOrName: Dyno ID or name to stop

Returns: Confirmation of stop.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "dynoIdOrName"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "dynoIdOrName": {
      "type": "string",
      "description": "Dyno ID or name to stop"
    }
  }
}

heroku_list_formation

List formation info (process types and their scaling) for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of process types with quantity and size.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_formation

Get formation info for a specific process type.

Args:

appIdOrName: App ID or name
processType: Process type (e.g., 'web', 'worker')
format: Response format ('json' or 'markdown')

Returns: Formation details for the process type.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "processType"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "processType": {
      "type": "string",
      "description": "Process type (e.g., web, worker)"
    }
  }
}

heroku_scale_dynos

Scale dynos for a specific process type.

Args:

appIdOrName: App ID or name
processType: Process type to scale (e.g., 'web', 'worker')
quantity: Number of dynos to run
size: Dyno size (e.g., 'basic', 'standard-1x', 'standard-2x')

Returns: Updated formation details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "processType"
  ],
  "properties": {
    "size": {
      "type": "string",
      "description": "Dyno size"
    },
    "quantity": {
      "type": "number",
      "description": "Number of dynos"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "processType": {
      "type": "string",
      "description": "Process type (e.g., web, worker)"
    }
  }
}

heroku_batch_scale_dynos

Scale multiple process types at once.

Args:

appIdOrName: App ID or name
updates: Array of scaling updates, each with type, quantity, and/or size

Returns: Updated formation details for all process types.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_logs

Get a URL for streaming app logs.

Args:

appIdOrName: App ID or name
dyno: Filter logs by dyno name (e.g., 'web.1')
lines: Number of historical log lines to include (default: 100)
source: Filter by log source (e.g., 'app', 'heroku')
tail: Whether to stream new logs (default: false)

Returns: A log session with a URL for streaming logs via HTTP.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "dyno": {
      "type": "string",
      "description": "Filter by dyno name"
    },
    "tail": {
      "type": "boolean",
      "description": "Stream new logs"
    },
    "lines": {
      "type": "number",
      "description": "Number of historical lines"
    },
    "source": {
      "type": "string",
      "description": "Filter by source"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_list_log_drains

List all log drains for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of log drains with their URLs and tokens.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_log_drain

Get information about a specific log drain.

Args:

appIdOrName: App ID or name
logDrainIdOrUrl: Log drain ID or URL
format: Response format ('json' or 'markdown')

Returns: Log drain details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "logDrainIdOrUrl"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "logDrainIdOrUrl": {
      "type": "string",
      "description": "Log drain ID or URL"
    }
  }
}

heroku_create_log_drain

Add a log drain to an app.

Args:

appIdOrName: App ID or name
url: Syslog URL for the drain (e.g., 'syslog://logs.example.com:514')

Returns: The created log drain details including token.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Syslog URL"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_delete_log_drain

Remove a log drain from an app.

Args:

appIdOrName: App ID or name
logDrainIdOrUrl: Log drain ID or URL to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "logDrainIdOrUrl"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "logDrainIdOrUrl": {
      "type": "string",
      "description": "Log drain ID or URL"
    }
  }
}

heroku_list_pipelines

List all pipelines.

Args:

format: Response format ('json' or 'markdown')

Returns: List of pipelines with their details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

heroku_get_pipeline

Get information about a specific pipeline.

Args:

pipelineIdOrName: Pipeline ID or name
format: Response format ('json' or 'markdown')

Returns: Pipeline details.

{
  "type": "object",
  "required": [
    "pipelineIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pipelineIdOrName": {
      "type": "string",
      "description": "Pipeline ID or name"
    }
  }
}

heroku_create_pipeline

Create a new pipeline.

Args:

name: Pipeline name
ownerId: Owner ID (user or team)
ownerType: Owner type ('user' or 'team')

Returns: The created pipeline details.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Pipeline name"
    },
    "ownerId": {
      "type": "string",
      "description": "Owner ID"
    },
    "ownerType": {
      "enum": [
        "user",
        "team"
      ],
      "type": "string",
      "description": "Owner type"
    }
  }
}

heroku_update_pipeline

Update a pipeline.

Args:

pipelineIdOrName: Pipeline ID or name
name: New pipeline name

Returns: Updated pipeline details.

{
  "type": "object",
  "required": [
    "pipelineIdOrName",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New pipeline name"
    },
    "pipelineIdOrName": {
      "type": "string",
      "description": "Pipeline ID or name"
    }
  }
}

heroku_list_pipeline_couplings

List all apps coupled to a pipeline.

Args:

pipelineId: Pipeline ID
format: Response format ('json' or 'markdown')

Returns: List of pipeline couplings (apps and their stages).

{
  "type": "object",
  "required": [
    "pipelineId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pipelineId": {
      "type": "string",
      "description": "Pipeline ID"
    }
  }
}

heroku_couple_app_to_pipeline

Couple an app to a pipeline stage.

Args:

pipelineId: Pipeline ID
app: App ID or name
stage: Pipeline stage ('review', 'development', 'staging', 'production')

Returns: The created coupling details.

{
  "type": "object",
  "required": [
    "pipelineId",
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "App ID or name"
    },
    "pipelineId": {
      "type": "string",
      "description": "Pipeline ID"
    }
  }
}

heroku_decouple_app_from_pipeline

Remove an app from a pipeline.

Args:

couplingId: Coupling ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "couplingId"
  ],
  "properties": {
    "couplingId": {
      "type": "string",
      "description": "Coupling ID"
    }
  }
}

heroku_promote_pipeline

Promote an app to the next stage in a pipeline.

Args:

pipelineId: Pipeline ID
sourceAppId: Source app ID to promote from
targetAppIds: Array of target app IDs to promote to

Returns: The promotion details.

{
  "type": "object",
  "required": [
    "pipelineId",
    "sourceAppId",
    "targetAppIds"
  ],
  "properties": {
    "pipelineId": {
      "type": "string",
      "description": "Pipeline ID"
    },
    "sourceAppId": {
      "type": "string",
      "description": "Source app ID"
    },
    "targetAppIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Target app IDs"
    }
  }
}

heroku_list_releases

List all releases for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of releases with version, status, and description.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_release

Get information about a specific release.

Args:

appIdOrName: App ID or name
releaseIdOrVersion: Release ID or version number
format: Response format ('json' or 'markdown')

Returns: Release details including slug, user, and add-on plans.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "releaseIdOrVersion"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "releaseIdOrVersion": {
      "type": "string",
      "description": "Release ID or version number"
    }
  }
}

heroku_rollback

Rollback an app to a previous release.

Args:

appIdOrName: App ID or name
releaseId: Release ID to rollback to

Returns: The new release created by the rollback.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "releaseId"
  ],
  "properties": {
    "releaseId": {
      "type": "string",
      "description": "Release ID to rollback to"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_list_builds

List all builds for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of builds with status and metadata.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_build

Get information about a specific build.

Args:

appIdOrName: App ID or name
buildId: Build ID
format: Response format ('json' or 'markdown')

Returns: Build details including status, source blob, and buildpacks.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "buildId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "buildId": {
      "type": "string",
      "description": "Build ID"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_create_build

Create a new build from source code.

Args:

appIdOrName: App ID or name
sourceUrl: URL of the source code tarball
sourceVersion: Version identifier (optional)
sourceChecksum: SHA256 checksum of the tarball (optional)
buildpacks: Array of buildpack URLs (optional)

Returns: The created build details including output stream URL.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "sourceUrl"
  ],
  "properties": {
    "sourceUrl": {
      "type": "string",
      "description": "URL of source code tarball"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "sourceVersion": {
      "type": "string",
      "description": "Version identifier"
    },
    "sourceChecksum": {
      "type": "string",
      "description": "SHA256 checksum"
    }
  }
}

heroku_list_buildpacks

List buildpacks installed on an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of buildpacks in order of execution.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_set_buildpacks

Set the buildpacks for an app.

Args:

appIdOrName: App ID or name
buildpacks: Array of buildpack URLs in order of execution

Returns: Updated list of buildpack installations.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "buildpacks"
  ],
  "properties": {
    "buildpacks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Buildpack URLs in order"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_list_spaces

List all Private Spaces.

Args:

format: Response format ('json' or 'markdown')

Returns: List of Private Spaces.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

heroku_get_space

Get information about a Private Space.

Args:

spaceIdOrName: Space ID or name
format: Response format ('json' or 'markdown')

Returns: Space details.

{
  "type": "object",
  "required": [
    "spaceIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceIdOrName": {
      "type": "string",
      "description": "Space ID or name"
    }
  }
}

heroku_create_space

Create a new Private Space.

Args:

name: Space name
team: Team to create the space in
region: Region for the space
cidr: CIDR block for the space (optional)
dataCidr: CIDR block for data services (optional)
shield: Enable Shield (optional)

Returns: The created space details.

{
  "type": "object",
  "required": [
    "name",
    "team"
  ],
  "properties": {
    "cidr": {
      "type": "string",
      "description": "CIDR block"
    },
    "name": {
      "type": "string",
      "description": "Space name"
    },
    "team": {
      "type": "string",
      "description": "Team name or ID"
    },
    "region": {
      "type": "string",
      "description": "Region"
    },
    "shield": {
      "type": "boolean",
      "description": "Enable Shield"
    },
    "dataCidr": {
      "type": "string",
      "description": "Data services CIDR"
    }
  }
}

heroku_update_space

Update a Private Space.

Args:

spaceIdOrName: Space ID or name
name: New space name

Returns: Updated space details.

{
  "type": "object",
  "required": [
    "spaceIdOrName",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New space name"
    },
    "spaceIdOrName": {
      "type": "string",
      "description": "Space ID or name"
    }
  }
}

heroku_delete_space

Delete a Private Space.

Args:

spaceIdOrName: Space ID or name

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "spaceIdOrName"
  ],
  "properties": {
    "spaceIdOrName": {
      "type": "string",
      "description": "Space ID or name"
    }
  }
}

heroku_list_regions

List all available regions.

Args:

format: Response format ('json' or 'markdown')

Returns: List of regions.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

heroku_get_region

Get information about a specific region.

Args:

regionIdOrName: Region ID or name
format: Response format ('json' or 'markdown')

Returns: Region details.

{
  "type": "object",
  "required": [
    "regionIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "regionIdOrName": {
      "type": "string",
      "description": "Region ID or name"
    }
  }
}

heroku_list_stacks

List all available stacks.

Args:

format: Response format ('json' or 'markdown')

Returns: List of stacks.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

heroku_get_stack

Get information about a specific stack.

Args:

stackIdOrName: Stack ID or name
format: Response format ('json' or 'markdown')

Returns: Stack details.

{
  "type": "object",
  "required": [
    "stackIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "stackIdOrName": {
      "type": "string",
      "description": "Stack ID or name"
    }
  }
}

heroku_list_dyno_sizes

List all available dyno sizes.

Args:

format: Response format ('json' or 'markdown')

Returns: List of dyno sizes with their specs and pricing.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

heroku_get_dyno_size

Get information about a specific dyno size.

Args:

dynoSizeIdOrName: Dyno size ID or name
format: Response format ('json' or 'markdown')

Returns: Dyno size details.

{
  "type": "object",
  "required": [
    "dynoSizeIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "dynoSizeIdOrName": {
      "type": "string",
      "description": "Dyno size ID or name"
    }
  }
}

heroku_list_sni_endpoints

List all SNI endpoints for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of SNI endpoints.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_sni_endpoint

Get information about a specific SNI endpoint.

Args:

appIdOrName: App ID or name
sniEndpointIdOrName: SNI endpoint ID or name
format: Response format ('json' or 'markdown')

Returns: SNI endpoint details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "sniEndpointIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "sniEndpointIdOrName": {
      "type": "string",
      "description": "SNI endpoint ID or name"
    }
  }
}

heroku_create_sni_endpoint

Add an SSL certificate to an app.

Args:

appIdOrName: App ID or name
certificateChain: The certificate chain (PEM format)
privateKey: The private key (PEM format)

Returns: The created SNI endpoint details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "certificateChain",
    "privateKey"
  ],
  "properties": {
    "privateKey": {
      "type": "string",
      "description": "Private key (PEM)"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "certificateChain": {
      "type": "string",
      "description": "Certificate chain (PEM)"
    }
  }
}

heroku_update_sni_endpoint

Update an SNI endpoint with a new certificate.

Args:

appIdOrName: App ID or name
sniEndpointIdOrName: SNI endpoint ID or name
certificateChain: The new certificate chain (PEM format)
privateKey: The new private key (PEM format)

Returns: Updated SNI endpoint details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "sniEndpointIdOrName",
    "certificateChain",
    "privateKey"
  ],
  "properties": {
    "privateKey": {
      "type": "string",
      "description": "Private key (PEM)"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "certificateChain": {
      "type": "string",
      "description": "Certificate chain (PEM)"
    },
    "sniEndpointIdOrName": {
      "type": "string",
      "description": "SNI endpoint ID or name"
    }
  }
}

heroku_delete_sni_endpoint

Remove an SNI endpoint from an app.

Args:

appIdOrName: App ID or name
sniEndpointIdOrName: SNI endpoint ID or name

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "sniEndpointIdOrName"
  ],
  "properties": {
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    },
    "sniEndpointIdOrName": {
      "type": "string",
      "description": "SNI endpoint ID or name"
    }
  }
}

heroku_list_webhooks

List all webhooks for an app.

Args:

appIdOrName: App ID or name
format: Response format ('json' or 'markdown')

Returns: List of webhooks.

{
  "type": "object",
  "required": [
    "appIdOrName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_get_webhook

Get information about a specific webhook.

Args:

appIdOrName: App ID or name
webhookId: Webhook ID
format: Response format ('json' or 'markdown')

Returns: Webhook details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "webhookId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "webhookId": {
      "type": "string",
      "description": "Webhook ID"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_create_webhook

Create a webhook for an app.

Args:

appIdOrName: App ID or name
url: Webhook URL
include: Events to subscribe to (e.g., ['api:release', 'dyno'])
level: Notification level ('notify' or 'sync')
secret: Secret for webhook signature (optional)

Returns: The created webhook details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "url",
    "include",
    "level"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Webhook URL"
    },
    "level": {
      "enum": [
        "notify",
        "sync"
      ],
      "type": "string",
      "description": "Notification level"
    },
    "secret": {
      "type": "string",
      "description": "Webhook secret"
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Events to subscribe to"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_update_webhook

Update a webhook.

Args:

appIdOrName: App ID or name
webhookId: Webhook ID
url: New webhook URL (optional)
include: New events to subscribe to (optional)
level: New notification level (optional)
secret: New webhook secret (optional)

Returns: Updated webhook details.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "webhookId"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Webhook URL"
    },
    "level": {
      "enum": [
        "notify",
        "sync"
      ],
      "type": "string",
      "description": "Notification level"
    },
    "secret": {
      "type": "string",
      "description": "Webhook secret"
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Events to subscribe to"
    },
    "webhookId": {
      "type": "string",
      "description": "Webhook ID"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_delete_webhook

Delete a webhook.

Args:

appIdOrName: App ID or name
webhookId: Webhook ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "appIdOrName",
    "webhookId"
  ],
  "properties": {
    "webhookId": {
      "type": "string",
      "description": "Webhook ID"
    },
    "appIdOrName": {
      "type": "string",
      "description": "App ID or name"
    }
  }
}

heroku_list_teams

List all teams the user belongs to.

Args:

format: Response format ('json' or 'markdown')

Returns: List of teams with their details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

heroku_get_team

Get information about a specific team.

Args:

teamNameOrId: Team name or ID
format: Response format ('json' or 'markdown')

Returns: Team details.

{
  "type": "object",
  "required": [
    "teamNameOrId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    }
  }
}

heroku_create_team

Create a new team.

Args:

name: Team name

Returns: The created team details.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Team name"
    }
  }
}

heroku_update_team

Update a team.

Args:

teamNameOrId: Team name or ID
name: New team name
default: Set as default team

Returns: Updated team details.

{
  "type": "object",
  "required": [
    "teamNameOrId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New team name"
    },
    "default": {
      "type": "boolean",
      "description": "Set as default team"
    },
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    }
  }
}

heroku_delete_team

Delete a team.

Args:

teamNameOrId: Team name or ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "teamNameOrId"
  ],
  "properties": {
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    }
  }
}

heroku_list_team_members

List all members of a team.

Args:

teamNameOrId: Team name or ID
format: Response format ('json' or 'markdown')

Returns: List of team members with their roles.

{
  "type": "object",
  "required": [
    "teamNameOrId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    }
  }
}

heroku_add_team_member

Add a member to a team.

Args:

teamNameOrId: Team name or ID
email: Email address of the user to add
role: Role for the new member ('admin', 'member', 'viewer')

Returns: The added team member details.

{
  "type": "object",
  "required": [
    "teamNameOrId",
    "email",
    "role"
  ],
  "properties": {
    "role": {
      "enum": [
        "admin",
        "member",
        "viewer"
      ],
      "type": "string",
      "description": "Member role"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    }
  }
}

heroku_update_team_member

Update a team member's role.

Args:

teamNameOrId: Team name or ID
memberEmailOrId: Member email or ID
role: New role ('admin', 'member', 'viewer')

Returns: Updated team member details.

{
  "type": "object",
  "required": [
    "teamNameOrId",
    "memberEmailOrId",
    "role"
  ],
  "properties": {
    "role": {
      "enum": [
        "admin",
        "member",
        "viewer"
      ],
      "type": "string",
      "description": "New role"
    },
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    },
    "memberEmailOrId": {
      "type": "string",
      "description": "Member email or ID"
    }
  }
}

heroku_remove_team_member

Remove a member from a team.

Args:

teamNameOrId: Team name or ID
memberEmailOrId: Member email or ID

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "teamNameOrId",
    "memberEmailOrId"
  ],
  "properties": {
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    },
    "memberEmailOrId": {
      "type": "string",
      "description": "Member email or ID"
    }
  }
}

heroku_list_team_invitations

List pending invitations for a team.

Args:

teamNameOrId: Team name or ID
format: Response format ('json' or 'markdown')

Returns: List of pending team invitations.

{
  "type": "object",
  "required": [
    "teamNameOrId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamNameOrId": {
      "type": "string",
      "description": "Team name or ID"
    }
  }
}