vibekit-mcp 0.5.3 → 0.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +106 -50
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,20 +1,20 @@
1
1
  # vibekit-mcp
2
2
 
3
- MCP server for VibeKit — deploy apps, manage hosting, and chat with AI agents from any MCP client.
3
+ MCP server for VibeKit — control your hosted apps, AI agents, and deployments from Claude Desktop, Cursor, or any MCP client.
4
4
 
5
- ## Installation
5
+ ## Quick Start
6
+
7
+ **1. Install**
6
8
 
7
9
  ```bash
8
10
  npm install -g vibekit-mcp
9
11
  ```
10
12
 
11
- ## Setup
13
+ **2. Get an API key**
12
14
 
13
- 1. Get a VibeKit API key:
14
- - Open [@the_vibe_kit_bot](https://t.me/the_vibe_kit_bot) in Telegram
15
- - Send `/apikey` to generate your key
15
+ Go to [app.vibekit.bot](https://app.vibekit.bot) → Settings → API Keys, or via Telegram: [@the_vibe_kit_bot](https://t.me/the_vibe_kit_bot) → `/apikey`
16
16
 
17
- 2. Add to your MCP client config (e.g. Claude Desktop) (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
17
+ **3. Add to Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
18
18
 
19
19
  ```json
20
20
  {
@@ -29,80 +29,134 @@ npm install -g vibekit-mcp
29
29
  }
30
30
  ```
31
31
 
32
- 3. Restart your MCP client
32
+ **4. Restart your MCP client** and start building.
33
+
34
+ ---
33
35
 
34
- ## Available Tools
36
+ ## What You Can Do
35
37
 
36
- ### Hosting
38
+ ### Apps
37
39
 
38
40
  | Tool | Description |
39
41
  |------|-------------|
40
- | `vibekit_list_apps` | List all hosted apps |
41
- | `vibekit_get_app` | Get details about a specific app |
42
- | `vibekit_create_app` | Create new app from template |
43
- | `vibekit_deploy` | Deploy GitHub repo to hosting |
44
- | `vibekit_redeploy` | Redeploy app with latest code |
45
- | `vibekit_app_logs` | Get application logs |
42
+ | `vibekit_list_apps` | List all your hosted apps |
43
+ | `vibekit_get_app` | Get app details (status, URL, memory, uptime) |
44
+ | `vibekit_create_app` | Create a new app from a template |
45
+ | `vibekit_deploy` | Deploy a GitHub repo |
46
+ | `vibekit_redeploy` | Redeploy with latest code |
47
+ | `vibekit_rollback` | Roll back to a previous snapshot |
48
+ | `vibekit_deploy_history` | List deployment snapshots |
49
+ | `vibekit_app_logs` | Get runtime logs |
46
50
  | `vibekit_restart_app` | Restart an app |
47
51
  | `vibekit_stop_app` | Stop an app |
48
52
  | `vibekit_start_app` | Start a stopped app |
49
- | `vibekit_app_env` | Get app environment variables |
50
- | `vibekit_set_env` | Set app environment variables |
51
- | `vibekit_delete_app` | Delete an app permanently |
53
+ | `vibekit_delete_app` | Permanently delete an app |
54
+ | `vibekit_exec` | Run a shell command inside a running container |
55
+
56
+ ### Environment Variables
57
+
58
+ | Tool | Description |
59
+ |------|-------------|
60
+ | `vibekit_app_env` | Get env vars (values revealed) |
61
+ | `vibekit_set_env` | Set one or more env vars |
62
+ | `vibekit_delete_env` | Delete a specific env var |
52
63
 
53
- ### Agent
64
+ ### AI Agent
54
65
 
55
66
  | Tool | Description |
56
67
  |------|-------------|
57
- | `vibekit_chat` | Chat with an app's AI agent |
58
- | `vibekit_agent_status` | Get agent status |
59
- | `vibekit_agent_history` | Get chat history with agent |
68
+ | `vibekit_chat` | Send a message to an app's AI agent |
69
+ | `vibekit_agent_status` | Check if agent is idle or running |
70
+ | `vibekit_agent_stop` | Stop a running agent request |
71
+ | `vibekit_agent_history` | Get conversation history |
72
+ | `vibekit_agent_config` | Get current model config |
73
+ | `vibekit_agent_set_model` | Change model (`claude-opus-4-6`, `claude-sonnet-4-20250514`, `claude-haiku-3.5`) |
74
+ | `vibekit_agent_reset` | Reset agent (clear sessions, memory, restart, or cleanup disk) |
75
+ | `vibekit_agent_compact` | Compact agent memory to free context |
76
+
77
+ ### Files
78
+
79
+ | Tool | Description |
80
+ |------|-------------|
81
+ | `vibekit_list_files` | List files in the workspace |
82
+ | `vibekit_read_file` | Read a file's contents |
83
+ | `vibekit_write_file` | Write or update a file |
84
+ | `vibekit_file_changes` | See uncommitted file changes |
60
85
 
61
86
  ### Database
62
87
 
63
88
  | Tool | Description |
64
89
  |------|-------------|
65
- | `vibekit_enable_database` | Enable database for an app |
66
- | `vibekit_database_status` | Get database status and connection info |
90
+ | `vibekit_enable_database` | Provision a Postgres database |
91
+ | `vibekit_database_status` | Connection info and stats |
92
+ | `vibekit_database_schema` | Get tables and columns |
93
+ | `vibekit_database_query` | Run a SQL query |
94
+
95
+ ### Custom Domains
96
+
97
+ | Tool | Description |
98
+ |------|-------------|
99
+ | `vibekit_add_domain` | Add a custom domain |
100
+ | `vibekit_remove_domain` | Remove a custom domain |
67
101
 
68
102
  ### QA
69
103
 
70
104
  | Tool | Description |
71
105
  |------|-------------|
72
106
  | `vibekit_run_qa` | Run automated QA tests |
73
- | `vibekit_qa_status` | Get QA test results |
107
+ | `vibekit_qa_status` | Get latest QA results |
74
108
 
75
- ### Tasks
109
+ ### Cron Schedules (per app)
76
110
 
77
111
  | Tool | Description |
78
112
  |------|-------------|
79
- | `vibekit_submit_task` | Submit a coding task |
80
- | `vibekit_get_task` | Get task status/result |
113
+ | `vibekit_app_schedules` | List cron jobs for an app |
114
+ | `vibekit_create_app_schedule` | Create a cron job |
115
+ | `vibekit_delete_app_schedule` | Delete a cron job |
116
+
117
+ ### Async Coding Tasks
118
+
119
+ | Tool | Description |
120
+ |------|-------------|
121
+ | `vibekit_submit_task` | Submit an async coding task (GitHub-based) |
122
+ | `vibekit_get_task` | Get task status and result |
81
123
  | `vibekit_list_tasks` | List recent tasks |
82
- | `vibekit_wait_for_task` | Wait for task completion |
83
- | `vibekit_create_schedule` | Create recurring scheduled task |
84
- | `vibekit_list_schedules` | List scheduled tasks |
85
- | `vibekit_delete_schedule` | Delete scheduled task |
124
+ | `vibekit_wait_for_task` | Poll until task completes |
125
+ | `vibekit_create_schedule` | Create a recurring coding task |
126
+ | `vibekit_list_schedules` | List recurring schedules |
127
+ | `vibekit_delete_schedule` | Delete a schedule |
86
128
 
87
- ### Account
129
+ ### Account & Skills
88
130
 
89
131
  | Tool | Description |
90
132
  |------|-------------|
91
- | `vibekit_account` | Get account info (plan, credits, usage) |
92
- | `vibekit_list_skills` | List implementation skills |
93
- | `vibekit_get_skill` | Fetch specific skill content |
133
+ | `vibekit_account` | Plan, credits, and usage |
134
+ | `vibekit_list_skills` | Browse implementation skills |
135
+ | `vibekit_get_skill` | Fetch a skill's full content |
136
+
137
+ ---
138
+
139
+ ## Example Prompts
140
+
141
+ ```
142
+ "List my apps and show the logs for the one that's erroring"
94
143
 
95
- ## Example Usage
144
+ "Chat with the agent on my 'dogs' app — ask it to add a dark mode toggle"
96
145
 
97
- Once configured, you can use prompts like:
146
+ "Read the server.js file from my app and tell me what it does"
98
147
 
99
- - "Deploy my GitHub repo to VibeKit and create a new app"
100
- - "Chat with the AI agent for my app about adding a contact form"
101
- - "Show me the logs for my app and restart it if there are errors"
102
- - "Enable a database for my app and check its status"
103
- - "Run QA tests on my deployed app"
104
- - "Check my VibeKit account balance and list my apps"
105
- - "Create a weekly schedule to improve my app's performance"
148
+ "Run a SQL query on my app's database: SELECT COUNT(*) FROM users"
149
+
150
+ "Redeploy my app, then run QA and show me the results"
151
+
152
+ "Roll back my app to the previous deployment"
153
+
154
+ "Set DATABASE_URL and STRIPE_SECRET as env vars on my app, then restart it"
155
+
156
+ "Check my account balance and show how many sessions I've used this month"
157
+ ```
158
+
159
+ ---
106
160
 
107
161
  ## Environment Variables
108
162
 
@@ -111,9 +165,11 @@ Once configured, you can use prompts like:
111
165
  | `VIBEKIT_API_KEY` | Your VibeKit API key (required) | — |
112
166
  | `VIBEKIT_API_URL` | API base URL | `https://vibekit.bot/api/v1` |
113
167
 
168
+ ---
169
+
114
170
  ## Links
115
171
 
116
- - [VibeKit Website](https://vibekit.bot)
117
- - [API Documentation](https://vibekit.bot/SKILL.md)
118
- - [Get API Key](https://t.me/the_vibe_kit_bot)
119
- - [GitHub](https://github.com/609NFT/vibekit)
172
+ - [Dashboard](https://app.vibekit.bot)
173
+ - [Website](https://vibekit.bot)
174
+ - [API Docs](https://vibekit.bot/SKILL.md)
175
+ - [GitHub](https://github.com/609NFT/vibekit)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vibekit-mcp",
3
- "version": "0.5.3",
3
+ "version": "0.5.4",
4
4
  "description": "MCP server for VibeKit — deploy apps, manage hosting, chat with AI agents, and run coding tasks from Claude Desktop, Cursor, and other MCP clients.",
5
5
  "main": "dist/index.js",
6
6
  "bin": {