vibez-approval
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
vibez-approval
Make an AI agent wait for a person before it does something it can't take back.
The agent files a request. It shows up on your Vibez.now Requests page and in the iOS app. The agent carries on only once you approve. A rejection, an expired request, a network error or a missing key all count as not approved, so a failure never lets the action through.
Get an API key from Settings in Vibez.now and set it as VIBEZ_API_KEY.
As an MCP server
Works with any MCP client: Claude Code, Claude Desktop, Cursor, and others.
claude mcp add vibez-approval -e VIBEZ_API_KEY=your-key -- npx -y vibez-approvalFor clients configured with JSON:
{
"mcpServers": {
"vibez-approval": {
"command": "npx",
"args": ["-y", "vibez-approval"],
"env": { "VIBEZ_API_KEY": "your-key" }
}
}
}Tools:
request_approval{ title, detail?, reason?, expires_in_minutes?, wait_seconds? }: asks a person, then waits up towait_secondsfor an answer (default 50, maximum 600).check_approval{ request_id, wait_seconds? }: reads the decision, waiting while it's still pending.
MCP clients time out long tool calls. If nobody has answered within wait_seconds, the result is pending with a request_id and tells the agent not to proceed. The agent calls check_approval to keep waiting. Every result also carries structuredContent: { request_id, status, approved, reason }.
To name the agent for auto-approve rules, set VIBEZ_AGENT_NAME.
Related MCP server: final-approval
As a library
import { askHuman } from "vibez-approval";
if (await askHuman({ title: "Run: rm -rf build", detail: "rm -rf build" })) {
// approved
}createClient({ apiKey, apiUrl, sandbox }) returns the same function plus three lower-level calls:
submitfiles a request.statusreads it.waitForpolls until it's decided.
Set sandbox: true (or VIBEZ_SANDBOX=1) to exercise the API without creating anything. Sandbox requests stay pending.
Examples
examples/ in the GitHub repo has runnable versions of each guide below:
a Claude Code
PreToolUsehook (claude-code/approve-bash.py);a Vercel AI SDK tool (
ai-sdk/approved-shell-tool.ts);a standard-library Python helper, with LangChain and OpenAI Agents SDK agents (
python/);a plain Node script (
ask-before-running.mjs).
Guides
Node 18 or later. Built by AW3 Technology, Inc.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Set up human approval for your AI agents' tool calls.
Add human approval to AI agent workflows through cQnce authorization tools.
Give any AI agent a way to ask a person — for approval, a decision, an answer or a review.
Runtime permission, approval, and audit layer for AI agent tool execution.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to pause execution at critical decision points and request human review before proceeding. Provides tools for creating interrupts, polling for decisions, and managing approvals through a simple REST API interface.6 npmMIT
- AlicenseAqualityDmaintenanceHuman-in-the-loop approval gate for AI agents. Your agent calls submit_approval before any irreversible action; a human reviews on a branded page; a signed webhook fires back with the decision.11MIT
- AlicenseNot gradedqualityDmaintenanceProvides a human approval gate for AI agents, enabling interactive inline cards for approving, editing, or rejecting actions before they are executed.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to request human approvals with customizable forms, webhooks, and team features.68 npmMIT