How to Use the Heroku (PaaS) MCP in Vercel AI SDK

Q: How do I use the Vercel AI SDK to restart Heroku (PaaS) dynos?

Pass the tools from this MCP server to generateText. Your agent can then call restartalldynos or restartspecificdyno based on user input. The AI SDK streams the confirmation right back to your UI.

Q: Can I create Heroku (PaaS) apps from a Next.js app using the Vercel AI SDK?

Yes. Your agent can use the createapp tool. You can build a form in your frontend that collects the app name and region, then passes it to the agent to provision the app on Heroku (PaaS).

Q: What's the best way to list my Heroku (PaaS) apps in React with the Vercel AI SDK?

Use the listapps tool. The AI SDK will stream the list of apps, which you can then render into a table or list in your React component, updating it live as the data arrives.

Q: Is it safe to delete apps with this MCP server?

The deleteapp tool is destructive and permanent. While you can call it from your agent, you should always build a strong confirmation dialog in your UI before executing the action. The responsibility for safe UI design is yours.

Q: How is data privacy handled for Heroku config variables?

This server accesses sensitive data like DATABASEURL and API keys via listconfigvars. The Vercel AI SDK streams this data to your frontend. It's on you to ensure your application handles this data securely and does not expose it in the browser.

Build UIs that manage Heroku in real-time. The Vercel AI SDK streams dyno status and app info directly into your React components.

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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

See Dyno Status Live

Connect this MCP server to your AI SDK app and stream Heroku dyno states directly into your UI. Your users can watch the status change from 'starting' to 'up' or 'crashed' in real-time, without a page refresh, using the `list_dynos` tool. This isn't just a static list. The Vercel AI SDK streams data as it arrives from the MCP server. This means you can build responsive components that react instantly to a `restart_specific_dyno` command, showing the reboot process live.

Manage Apps from Your Frontend

Let your users manage their Heroku infrastructure without leaving your app. They can ask your agent to spin up a new environment with `create_app` or check its configuration with `get_app_info`. This isn't just for display. You can build interactive controls that trigger actions like `delete_app` or `toggle_maintenance_mode`, all from your Next.js frontend. The AI SDK handles the tool call; you just build the UI.

Build an Interactive Config Viewer

The `list_config_vars` tool lets your agent fetch environment variables from a Heroku app. With the Vercel AI SDK, you can stream these keys and values into a secure, client-side component for auditing. Imagine building a settings page where a user can ask, 'show me the staging config,' and see the variables appear one by one. You can even use `list_addons` to show which third-party services are connected.

Setup guide

Set up Heroku (PaaS) MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Heroku (PaaS) tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Heroku (PaaS) transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Pass the tools from this MCP server to `generateText`. Your agent can then call `restart_all_dynos` or `restart_specific_dyno` based on user input. The AI SDK streams the confirmation right back to your UI.

Yes. Your agent can use the `create_app` tool. You can build a form in your frontend that collects the app name and region, then passes it to the agent to provision the app on Heroku (PaaS).

Use the `list_apps` tool. The AI SDK will stream the list of apps, which you can then render into a table or list in your React component, updating it live as the data arrives.

The `delete_app` tool is destructive and permanent. While you can call it from your agent, you should always build a strong confirmation dialog in your UI before executing the action. The responsibility for safe UI design is yours.

This server accesses sensitive data like `DATABASE_URL` and API keys via `list_config_vars`. The Vercel AI SDK streams this data to your frontend. It's on you to ensure your application handles this data securely and does not expose it in the browser.

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