Skip to main content
Glama

VibeKit Chat with Agent

vibekit_chat

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
appIdYesApp ID (from vibekit_list_apps)
messageYesWhat you want the agent to do or change — be specific about features, design, and behavior.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYesWhether the call succeeded.
dataNoThe agent's reply and remaining credit balance, or a status:'working' note with polling instructions when the coding turn is still running.
errorNoError message when ok is false (e.g. missing/invalid VIBEKIT_API_KEY, or an API error).

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "description": "Result envelope: ok=true with data on success, ok=false with error on failure.",
      +  "properties": {
      +    "data": {
      +      "description": "The agent's reply and remaining credit balance, or a status:'working' note with polling instructions when the coding turn is still running."
      +    },
      +    "error": {
      +      "description": "Error message when ok is false (e.g. missing/invalid VIBEKIT_API_KEY, or an API error).",
      +      "type": "string"
      +    },
      +    "ok": {
      +      "description": "Whether the call succeeded.",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "ok"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations set openWorldHint=true and destructiveHint=false, but the description adds crucial async behavior: the agent may return a direct reply or a 'working' status, instructing not to resend but to poll. It also reveals the tool modifies code and redeploys, going well beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is moderately long but front-loaded with the core action. Every sentence serves a purpose: stating the action, usage scenario, and async handling. Could be slightly trimmed, but overall well-structured and efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex async agent tool with two parameters and an output schema, the description covers the full lifecycle: sending, potential direct reply, polling via vibekit_agent_status, and final reply via vibekit_agent_history. It also mentions redeployment, making it comprehensively useful for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers 100% of parameters, each with a description. The description adds context for appId (from vibekit_list_apps) and advises the user to be specific in message, which enhances the schema. Baseline 3 is appropriate given high schema coverage, but the added context justifies a 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states it sends a message to an AI coding agent to modify app code and redeploy. The verb 'send a message' and resource 'built-in AI coding agent' are specific, and the use case 'build/make a change' distinguishes it from sibling tools like vibekit_get_app or vibekit_deploy.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly says when to use ('build/make a change to my app' requests) and provides detailed follow-up instructions: if status is 'working', poll vibekit_agent_status and then read vibekit_agent_history. Although it doesn't explicitly state when not to use, the guidance is very clear and actionable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4/5.0
Disambiguation4/5

Most tools have distinct purposes, but vibekit_chat and vibekit_submit_task both handle AI-driven code changes, leading to potential confusion. Descriptions help differentiate, but overlap exists.

Naming Consistency4/5

All tools use the 'vibekit_' prefix and lowercase with underscores. Most follow a verb_noun pattern, but a few (e.g., 'vibekit_account') are noun-only, causing minor inconsistency.

Tool Count3/5

36 tools is on the high side, covering many aspects of the platform. While mostly justified, the count feels slightly excessive and could be streamlined.

Completeness5/5

The tool set covers the full lifecycle of apps, databases, tasks, schedules, skills, QA, and environment variables. No obvious gaps for the stated domain.