Run the Heroku agent and tools in a Meshagent Room in the cloud:

Required Environment Variables

  • HEROKU_API_KEY: Your Heroku authentication token.

Steps

  1. Install Meshagent Tools

    pip install "meshagent[all]"
    
  2. Sign Up and Authenticate with Meshagent
    Follow the CLI Getting Started Guide to authenticate.

  3. Start the Room with the Heroku MCP Agent

    meshagent service test --room=test --role=agent --image=meshagent/mcp-heroku:latest --env MESHAGENT_PORT=8001 --env HEROKU_API_KEY=<YOUR_HEROKU_AUTH_TOKEN> --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" --name=mcp-heroku-service
    
    • This command starts a Meshagent Room with the MCP Heroku server available.
    • Tip: Rooms auto-close if left inactive.
  4. Join Room with a Chatbot Agent and Heroku Toolkit

    meshagent chatbot join --room=test --agent-name=sample --name=sample --toolkit=mcp-heroku
    
    • This joins the room with a chatbot agent enabled with the Heroku toolkit.
    • Multiple toolkits can be enabled in a room.
    • The output will provide a link to the room for interactive use.

Tools Available

Below are the tools provided by this Meshagent-wrapped Heroku MCP server, ready to use within Meshagent Rooms and chatbots:

Tool NameShort Description
create_addonCreate add-on: specify service, plan, custom names
create_appCreate app: custom name, region (US/EU), team, private space
deploy_one_off_dynoRun code/commands in Heroku one-off dyno with network and filesystem access
deploy_to_herokuUse for all deployments
get_addon_infoGet add-on details: plan, state, billing
get_app_infoGet app details: config, dynos, addons, access, domains
get_app_logsApp logs: monitor/debug/filter by dyno/process/source
list_addon_plansList service plans: features, pricing, availability
list_addon_servicesList available add-on services and features
list_addonsList add-ons: all apps or specific app, detailed metadata
list_appsList Heroku apps: owned, collaborator access, team/space filtering
list_private_spacesLists Heroku Private Spaces with CIDR blocks, regions, compliance and capacity details
list_teamsLists accessible Heroku Teams
maintenance_offDisable maintenance mode and restore normal app operations
maintenance_onEnable maintenance mode and redirect traffic for a Heroku app
pg_backupsManage backups: schedules, status, verification, recovery
pg_credentialsManage access: credentials, permissions, security, monitoring
pg_infoView database status: config, metrics, resources, health
pg_killStop processes: stuck queries, blocking transactions, runaway operations
pg_locksAnalyze locks: blocked queries, deadlocks, concurrency
pg_maintenanceTrack maintenance: windows, schedules, progress, planning
pg_outliersFind resource-heavy queries: performance, patterns, optimization
pg_psMonitor active queries: progress, resources, performance
pg_psqlExecute SQL queries: analyze, debug, modify schema, manage data
pg_upgradeUpgrade PostgreSQL: version migration, compatibility, safety
pipelines_createCreates new Heroku deployment pipeline with configurable stages, apps, and team
pipelines_infoDisplays detailed pipeline configuration, stages, and connected apps
pipelines_listLists accessible Heroku pipelines
pipelines_promotePromotes apps between pipeline stages with configurable targets
ps_listList and monitor Heroku app dynos
ps_restartRestart Heroku app processes
ps_scaleScale Heroku app dynos
rename_appRename app: validate and update app name
transfer_appTransfer app ownership to user/team

Tool Details

For full argument details and usage patterns, see the Docker Hub page.


Meshagent and Further Reading


Why wrap MCP in Meshagent Rooms?
Meshagent Rooms provide a secure, cloud-hosted environment for agents and conversational tools with ephemeral isolation. Wrapping MCP servers like Heroku in Meshagent allows teams and chatbots to seamlessly access, automate, and collaborate on cloud tasks, all in real time and with fine-grained control over API keys and toolkits. Learn more about the concept in the Meshagent docs.