VibeKit

io.github.VibeKit-BotPublished by GitHub account VibeKit-Botv0.8.0Updated Oct 24, 2026

Build, deploy, and operate hosted web apps on VibeKit (vibekit.bot) from any MCP client.

VerifiedStreamable HTTPWeb executableDatabasesCloud & InfrastructureDeveloper Tools

Overview

AI-generated overview

VibeKit's hosted MCP server for creating, deploying and operating web apps on vibekit.bot, including AI coding agents, Postgres databases and QA runs.

What you can do
  • List, inspect, create and delete hosted apps, and deploy or redeploy from a GitHub repo or starter template
  • Start, stop, restart apps, read logs, list deploys and roll back to an earlier build
  • Read and set app environment variables
  • Chat with an app's AI coding agent, check its progress and history, and submit, poll, wait for or cancel coding tasks
  • Provision a Postgres database and inspect its schema, query it read-only or browse table rows
  • Run automated headless-browser QA and read results; manage recurring scheduled tasks
When to use it
Use it when you want an assistant to build, ship and maintain web apps on VibeKit hosting without leaving the chat: deploying a repo, debugging logs, rolling back a bad deploy, querying an app's database, or kicking off AI coding tasks and QA runs.
Requirements
A VibeKit account and API key (starts with vk_), passed as the VIBEKIT_API_KEY environment variable for a local install or as an api_key query parameter or Authorization Bearer header for the remote endpoint. Network access to vibekit.bot. The local option is an npm package requiring Node.js.
Before you install
The key grants full control of the account: apps can be created, redeployed, restarted, stopped and permanently deleted, and environment variables can be read and changed. Deleting an app is irreversible and removes its database, env vars and subdomain. The AI agent and submitted tasks write code, commit to GitHub and deploy by default. Database provisioning may require a paid add-on, and credits are consumed. Every tool call is forwarded to the VibeKit API.

Installation

In SourceWeft

  1. Open VibeKit in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.VibeKit-Bot%2Fvibekit-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "vibekit": {
      "type": "http",
      "url": "https://mcp.vibekit.bot/mcp"
    }
  }
}

README

vibekit-mcp

[smithery badge]

MCP server for VibeKit, deploy apps, manage hosting, and chat with AI agents from any MCP client.

This package is for VibeKit cloud/API access. It does not connect your local Claude Code instance to Telegram. For local-machine remote control, use vibekit-agent.

Use it remotely (no install)

VibeKit also runs as a hosted remote server, so clients that accept a remote MCP URL (claude.ai web connectors, ChatGPT, etc.) need no install:

https://mcp.vibekit.bot/mcp?api_key=vk_your_api_key_here

Paste that URL into your client's "custom connector" / "remote MCP server" field. Clients that let you set headers can instead send Authorization: Bearer vk_your_api_key_here and use the bare https://mcp.vibekit.bot/mcp. See Get an API key below.

Prefer a local stdio install (e.g. Claude Desktop)? Use the steps below.

Get an API key

Keys start with vk_. Two ways to get one:

  • Instant, no signup: one request returns a key.
    bash
    curl -X POST https://vibekit.bot/api/v1/auth/register# Response: {"apiKey": "vk_...", "plan": "free", "credits": 0}
    Save the returned key and reuse it. Each call to /auth/register creates a brand-new account, so call it once, not per request.
  • From your account: if you already use VibeKit, copy or regenerate your key in the web dashboard or the iOS app settings.

Installation

bash
npm install -g vibekit-mcp

Setup

  1. Get a VibeKit API key (see Get an API key above).

  2. Add to your MCP client config (e.g. Claude Desktop) (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

json
{  "mcpServers": {    "vibekit": {      "command": "vibekit-mcp",      "env": {        "VIBEKIT_API_KEY": "vk_your_api_key_here"      }    }  }}
  1. Restart your MCP client

Available Tools

Hosting

ToolDescription
vibekit_list_appsList all hosted apps
vibekit_get_appGet details about a specific app
vibekit_list_templatesList starter templates for vibekit_create_app
vibekit_create_appCreate new app from a template
vibekit_deployDeploy GitHub repo to hosting
vibekit_redeployRedeploy app with latest code
vibekit_list_deploysList an app's recent deploys with status and commit
vibekit_rollback_deployRoll an app back to a previous deploy
vibekit_app_logsGet application logs
vibekit_restart_appRestart an app
vibekit_stop_appStop an app
vibekit_start_appStart a stopped app
vibekit_app_envGet app environment variables
vibekit_set_envSet app environment variables
vibekit_delete_appDelete an app permanently

Agent

ToolDescription
vibekit_chatChat with an app's AI agent
vibekit_agent_statusGet agent status
vibekit_agent_historyGet chat history with agent

Database

ToolDescription
vibekit_enable_databaseEnable a Postgres database for an app
vibekit_database_statusGet database status and connection info
vibekit_db_schemaGet the database schema (every table and its columns)
vibekit_db_queryRun a read-only SQL query (SELECT only, up to 200 rows)
vibekit_db_tableBrowse one table's rows with pagination and sorting

QA

ToolDescription
vibekit_run_qaRun automated QA tests
vibekit_qa_statusGet QA test results

Tasks

ToolDescription
vibekit_submit_taskSubmit a coding task
vibekit_get_taskGet task status/result
vibekit_list_tasksList recent tasks
vibekit_wait_for_taskWait for task completion
vibekit_cancel_taskCancel a running task
vibekit_create_scheduleCreate recurring scheduled task
vibekit_list_schedulesList scheduled tasks
vibekit_delete_scheduleDelete scheduled task

Account

ToolDescription
vibekit_accountGet account info (plan, credits, usage)
vibekit_list_skillsList implementation skills
vibekit_get_skillFetch specific skill content

Example Usage

Once configured, you can use prompts like:

  • "Deploy my GitHub repo to VibeKit and create a new app"
  • "Chat with the AI agent for my app about adding a contact form"
  • "Show me the logs for my app and restart it if there are errors"
  • "Enable a database for my app, then show me its schema and query the users table"
  • "List my app's recent deploys and roll back to the last working one"
  • "Run QA tests on my deployed app"
  • "Check my VibeKit account balance and list my apps"
  • "Create a weekly schedule to improve my app's performance"

Environment Variables

VariableDescriptionDefault
VIBEKIT_API_KEYYour VibeKit API key (required)none
VIBEKIT_API_URLAPI base URLhttps://vibekit.bot/api/v1

Related Packages

  • vibekit-cli: terminal client for VibeKit cloud workflows
  • vibekit-agent: Telegram bridge for local Claude Code on your own machine

Links

Privacy Policy

VibeKit's privacy policy: https://vibekit.bot/privacy

What this MCP server does with your data, concretely:

  • Every tool call is forwarded to the VibeKit API (https://vibekit.bot/api/v1) over HTTPS, authenticated with the API key you configure. Tool inputs and outputs are processed by VibeKit to run your apps and agents, under the privacy policy above.
  • The server itself keeps no state: nothing is written to disk, no analytics or telemetry are collected by this package, and your API key is read from configuration (VIBEKIT_API_KEY / the extension's key field) and sent only to vibekit.bot.
  • Data retention, third-party sharing, and deletion are governed by the policy above. Questions: [email protected].

Source: README.md at commit 54e8187

Tools

36

vibekit_list_apps

VibeKit List Apps

List all hosted apps in your VibeKit account, each with its id, subdomain, status, and live URL. Start here to get an appId for the other app tools.

Takes no parameters.

vibekit_get_app

VibeKit Get App

Get full details for one hosted app — status, subdomain/URL, repo, runtime, and database/domain config. Use the appId from vibekit_list_apps.

ParametersappIdrequired

vibekit_create_app

VibeKit Create App

Create a new hosted app from a starter template and deploy it live at <subdomain>.vibekit.bot. Call vibekit_list_templates first to pick a valid template. To deploy existing code from a GitHub repo instead, use vibekit_deploy.

Parameterstemplaterequiredsubdomainrequired

vibekit_list_templates

VibeKit List Templates

List the starter templates available to vibekit_create_app (e.g. landing, dashboard, blog, saas, crud-api). Call this before vibekit_create_app to choose a valid template.

Takes no parameters.

vibekit_deploy

VibeKit Deploy

Deploy a GitHub repo to VibeKit hosting, live at <subdomain>.vibekit.bot (Fargate container behind nginx, SSL automatic). Use when the code already lives in a GitHub repo; for a starter template instead use vibekit_create_app.

Parametersreporequiredsubdomainrequired

vibekit_redeploy

VibeKit Redeploy

Redeploy an existing app to pull and ship the latest code. Use after pushing changes to the app's GitHub repo.

ParametersappIdrequired

vibekit_app_logs

VibeKit App Logs

Fetch recent container/application logs for an app. Use this to debug crashes, errors, or a deploy that isn't serving.

ParametersappIdrequiredlines

vibekit_restart_app

VibeKit Restart App

Restart a hosted app's container. Use when an app is wedged, or to apply changed environment variables.

ParametersappIdrequired

vibekit_stop_app

VibeKit Stop App

Stop a hosted app's container. The app stays in your account and can be brought back with vibekit_start_app. Use to take an app offline without deleting it.

ParametersappIdrequired

vibekit_start_app

VibeKit Start App

Start a stopped hosted app's container. Use to bring an app stopped via vibekit_stop_app back online.

ParametersappIdrequired

vibekit_app_env

VibeKit Get Env Vars

Get the environment variables configured for an app (names and values). Read-only — use vibekit_set_env to change them.

ParametersappIdrequired

vibekit_set_env

VibeKit Set Env Vars

Set or update environment variables for an app (merges with existing). The app must be restarted or redeployed for changes to take effect.

ParametersvarsrequiredappIdrequired

vibekit_delete_app

VibeKit Delete App

Permanently delete a hosted app — stops the container and removes its workspace, database, env vars, and subdomain. Irreversible (the GitHub repo is NOT touched). Confirm with the user before calling.

ParametersappIdrequired

vibekit_chat

VibeKit Chat with Agent

Send a message to an app's built-in AI coding agent, which reads, writes, and modifies the app's code and redeploys it. Use for 'build/make a change to my app' requests. If the agent finishes quickly you get its reply directly. Otherwise you get status:'working' — do NOT resend; instead give the user LIVE progress: poll vibekit_agent_status every few seconds and relay the current step from activity.status ('editing the homepage…', 'deploying…') until activity.done, then read vibekit_agent_history for the final reply.

ParametersappIdrequiredmessagerequired

vibekit_agent_status

VibeKit Agent Status

Check whether an app's AI agent is idle or working, and get its LIVE progress. Returns activity.status = the current human-readable build step (e.g. 'editing index.html', 'deploying'), activity.steps = the steps so far, and activity.done = whether the turn finished. Poll this every few seconds while a build is running and relay activity.status to the user so they see progress. Once activity.done is true the response also includes liveCheck = a server-side fetch of the deployed page ({ url, ok, httpStatus, title }); use it to confirm the app is live and renders — do NOT curl/fetch the URL yourself, your sandbox may block it.

ParametersappIdrequired

vibekit_agent_history

VibeKit Agent History

Get the recent chat history between the user and an app's AI agent.

ParametersappIdrequiredlimit

vibekit_enable_database

VibeKit Enable Database

Provision a Postgres database for an app (idempotent — safe if already enabled). Required before the vibekit_db_* tools work. Note: free-tier apps need the $3/mo Database add-on.

ParametersappIdrequired

vibekit_database_status

VibeKit Database Status

Get an app's database status and connection info (whether it's provisioned, frozen, etc.).

ParametersappIdrequired

vibekit_db_schema

VibeKit Database Schema

Get an app's database schema — every table and its columns. Always call this before writing a query with vibekit_db_query.

ParametersappIdrequired

vibekit_db_query

VibeKit Run SQL Query

Run a read-only SQL query against an app's Postgres database and return up to 200 result rows. SELECT only — writes and DDL (INSERT/UPDATE/DELETE/ALTER/DROP/…) are rejected server-side; use vibekit_chat or vibekit_submit_task to have the agent make data or schema changes. Call vibekit_db_schema first to learn the tables. SQL string, max 5000 chars.

ParameterssqlrequiredappIdrequired

vibekit_db_table

VibeKit Browse Table

Browse rows of one table with pagination and optional sorting — a quick read-only alternative to hand-writing a SELECT.

ParametersappIdrequiredlimittablerequiredoffset

vibekit_list_deploys

VibeKit List Deploys

List an app's recent deploys, newest first, with status and commit info. Find a deployId here to pass to vibekit_rollback_deploy.

ParametersappIdrequiredlimit

vibekit_rollback_deploy

VibeKit Rollback Deploy

Roll an app back to a previous deploy (get the deployId from vibekit_list_deploys). The container restarts on the rolled-back build; reversible by rolling forward again.

ParametersappIdrequireddeployIdrequired

vibekit_run_qa

VibeKit Run QA

Kick off an automated QA run (headless-browser checks) against a hosted app. Poll vibekit_qa_status for results.

ParametersappIdrequired

vibekit_qa_status

VibeKit QA Status

Get the latest automated QA results and status for an app.

ParametersappIdrequired

vibekit_submit_task

VibeKit Submit Task

Submit an autonomous coding task. The AI writes the code, commits to GitHub, and (by default) deploys to <subdomain>.vibekit.bot. Returns a taskId — poll vibekit_get_task or block with vibekit_wait_for_task. Use for 'build X' or 'change X' work against a repo.

ParametersrepotaskrequiredbranchdeploycallbackUrl

vibekit_get_task

VibeKit Get Task

Get the status and result of a task submitted via vibekit_submit_task.

ParameterstaskIdrequired

vibekit_list_tasks

VibeKit List Tasks

List recent coding tasks, optionally filtered by status.

Parameterslimitstatus

vibekit_wait_for_task

VibeKit Wait for Task

Block until a submitted task finishes (or the timeout), polling every 5 seconds, then return its result. Use right after vibekit_submit_task when you want the final result inline.

ParameterstaskIdrequiredtimeoutSeconds

vibekit_cancel_task

VibeKit Cancel Task

Cancel a running task by taskId. No-op if it has already finished.

ParameterstaskIdrequired

vibekit_create_schedule

VibeKit Create Schedule

Create a recurring coding task that the AI runs automatically on a cron schedule (e.g. a weekly SEO pass). Use for 'every Monday, do X to my repo' requests.

Parameterscronrequirednamereporequiredtaskrequired

vibekit_list_schedules

VibeKit List Schedules

List all of the account's scheduled recurring tasks.

Takes no parameters.

vibekit_delete_schedule

VibeKit Delete Schedule

Delete a scheduled recurring task by scheduleId. Confirm with the user first.

ParametersscheduleIdrequired

vibekit_account

VibeKit Account Info

Get VibeKit account info: plan, credit balance, and usage.

Takes no parameters.

vibekit_list_skills

VibeKit List Skills

List available implementation skills (IDs, names, descriptions, tags) from the VibeKit skills registry. Discover skills here before fetching one with vibekit_get_skill.

Parameterstag

vibekit_get_skill

VibeKit Get Skill

Fetch the full content of a specific skill — implementation patterns, code examples, and best practices for a domain. Fetch on-demand when you need guidance on a specific topic.

Parametersidrequired

Version history

1
  1. v0.8.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts