How to Use the Heroku (PaaS) MCP in VS Code Copilot

Q: How do we set up the Heroku (PaaS) MCP for our team in VS Code Copilot?

Create a .vscode/mcp.json file in your project's repository root. Add the Heroku server config there and commit it. Everyone who pulls the repo automatically gets the tools in their editor.

Q: Can VS Code Copilot really delete a Heroku (PaaS) app?

Yes, the deleteapp tool is powerful and irreversible. For safety, you might want to use a separate, read-only MCP configuration for most developers and reserve delete permissions for senior roles.

Q: Does the Heroku (PaaS) integration with VS Code Copilot support maintenance mode?

It does. You can ask Copilot's agent to use the togglemaintenancemode tool. It's perfect for telling your agent to prep an app for a database migration or a risky deployment.

Q: What's the best way to find the ID for an app?

Just ask Copilot to listapps. It will return a list of all your applications, including their names and unique IDs, which you need for most other commands.

Standardize Heroku operations for your entire engineering team inside VS Code Copilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Heroku (PaaS) MCP to VS Code Copilot

Create your Vinkius account to connect Heroku (PaaS) to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Heroku (PaaS) with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

One Config, Tools for Everyone

Stop passing around shell scripts or outdated wiki pages. Commit a `.vscode/mcp.json` file to your repo, and every developer on your team gets the same set of Heroku tools inside VS Code. Now, anyone can ask Copilot to `list_apps` and get a consistent, live list of project environments. A junior dev can safely check dyno health with `list_dynos` or review add-ons with `list_addons` without needing full dashboard access.

Run Heroku Ops from Your Editor

An alert fires. Instead of opening a new terminal and logging in, just open Copilot Chat. Your agent is already authenticated and ready to run diagnostics or restart services. You can immediately `toggle_maintenance_mode` to protect users, then use `restart_all_dynos` to try and fix a widespread issue. If a specific background job is stuck, `restart_specific_dyno` gets it moving again without a full-site outage.

Manage Heroku Apps with VS Code Copilot

This MCP server gives your team a shared, auditable way to manage Heroku resources. It's perfect for platform teams that want to give developers self-service capabilities inside the editor they already use. Let developers spin up their own review apps with `create_app`, configured exactly to team standards. When the feature is merged, they can use `delete_app` to tear it down, keeping your Heroku account clean. All from within VS Code.

Setup guide

Set up Heroku (PaaS) MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Heroku (PaaS) MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Heroku (PaaS) tools listed. Try asking: "List my recent Heroku (PaaS) transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "heroku-paas-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Heroku. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Heroku (PaaS) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Heroku (PaaS) MCP in VS Code Copilot

Create a `.vscode/mcp.json` file in your project's repository root. Add the Heroku server config there and commit it. Everyone who pulls the repo automatically gets the tools in their editor.

Yes, the `delete_app` tool is powerful and irreversible. For safety, you might want to use a separate, read-only MCP configuration for most developers and reserve delete permissions for senior roles.

It does. You can ask Copilot's agent to use the `toggle_maintenance_mode` tool. It's perfect for telling your agent to prep an app for a database migration or a risky deployment.

Just ask Copilot to `list_apps`. It will return a list of all your applications, including their names and unique IDs, which you need for most other commands.

This MCP server exposes sensitive config vars like OAuth keys. Since the `.vscode/mcp.json` file is committed to your repo, you must use a secrets management system to inject the Heroku API key at runtime instead of hardcoding it.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript