How to Use the Heroku (PaaS) MCP in Windsurf

Q: How do I connect the Heroku (PaaS) MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the MCP Server configuration under the mcpServers key. Alternatively, use the Settings UI under Cascade to add the server, then click refresh in the panel.

Q: Can Windsurf safely run destructive commands like app deletion on Heroku (PaaS)?

Yes, but use caution. The deleteapp tool permanently removes your application, so you should instruct Cascade to ask for manual confirmation before executing destructive tasks.

Q: Does this Heroku (PaaS) integration with Windsurf support viewing active dynos?

Yes. Cascade uses listdynos to inspect container telemetry and can trigger restartalldynos if it detects crashed processes.

Q: How does the agent handle sensitive config variables?

The listconfigvars tool retrieves decrypted keys like database credentials. Windsurf keeps these in the session memory to help debug environment issues, but never writes them to your local files unless you explicitly ask it to.

Control your Heroku PaaS infrastructure directly from Windsurf using this MCP Server and Cascade's autonomous actions.

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 Windsurf

Create your Vinkius account to connect Heroku (PaaS) to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate App Provisioning in Windsurf

The `create_app` tool spins up a new application container on Heroku without you leaving the editor. When Cascade plans a deployment, it couples this with `list_addons` to instantly attach database or logging add-ons in a single autonomous run. You don't need to manually configure the new environment. Windsurf runs the entire sequence, verifies the setup, and presents you with the live URL so you can jump straight into writing code.

Audit Configuration and Environment Variables

The `list_config_vars` tool pulls decrypted environment variables like database URLs and API keys directly into your Cascade context. This lets your agent check active credentials against your local configuration files to find missing environment keys. Instead of hopping back and forth to the Heroku dashboard, Cascade runs this check behind the scenes. It flags mismatched production keys instantly, making sure your local build behaves exactly like the live environment.

Direct Dyno Management and Restarts

The `list_dynos` tool tracks the exact state of your application containers, showing you whether they are up, crashed, or idling. If a memory leak stalls your system, Cascade can trigger `restart_all_dynos` or target a hung worker with `restart_specific_dyno` to restore traffic flow. When things go south during a migration, Cascade also uses `toggle_maintenance_mode` to pause user traffic safely. This Heroku MCP Server gives your agent the power to diagnose and resolve production crashes before you even open your browser.

Setup guide

Set up Heroku (PaaS) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Heroku (PaaS) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Heroku (PaaS) payment history." If connected, Cascade will call the Heroku (PaaS) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the MCP Server configuration under the `mcpServers` key. Alternatively, use the Settings UI under Cascade to add the server, then click refresh in the panel.

Yes, but use caution. The `delete_app` tool permanently removes your application, so you should instruct Cascade to ask for manual confirmation before executing destructive tasks.

Yes. Cascade uses `list_dynos` to inspect container telemetry and can trigger `restart_all_dynos` if it detects crashed processes.

The `list_config_vars` tool retrieves decrypted keys like database credentials. Windsurf keeps these in the session memory to help debug environment issues, but never writes them to your local files unless you explicitly ask it to.

Your API key is stored locally on your machine or injected via Vinkius as an environment variable. The server only fetches app metadata and config vars during active sessions, ensuring your production keys never touch external logs.

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