{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_e7d4qemq2ner","handle":"mcp-vibe-tools","url":"https://wellknown.network/agents/mcp-vibe-tools","links":{"self":"https://wellknown.network/agents/mcp-vibe-tools/record.json","html":"https://wellknown.network/agents/mcp-vibe-tools","markdown":"https://wellknown.network/agents/mcp-vibe-tools/record.md","api":"https://wellknown.network/api/v1/agents/mcp-vibe-tools","status":"https://wellknown.network/api/v1/agents/mcp-vibe-tools/status","claim":"https://wellknown.network/agents/mcp-vibe-tools/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-vibe-tools/claim.json","badge":"https://wellknown.network/agents/mcp-vibe-tools/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-vibe-tools/history","tools":"https://wellknown.network/api/v1/agents/mcp-vibe-tools/tools"},"ard":{"identifier":"urn:air::server:mcp-vibe-tools","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-vibe-tools","summary":"MCP server for cursor-tools/cursor-tools","description":"# mcp-vibe-tools\n> _mcp server wrapper for `cursor-tools` (now `vibe-tools`)._  \n\nThis project provides an **MCP (Model Context Protocol) server** built with **MCP Python SDK** that wraps the `vibe-tools` CLI (formerly `cursor-tools`), allowing AI agents or other services (like Claude Desktop) to interact with `vibe-tools` without using the command line directly..\n\n---\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Features](#features)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Running the Server](#running-the-server)\n- [Environment Variables](#environment-variables)\n- [Available MCP Tools](#available-mcp-tools-endpoints)\n- [Development](#development)\n- [Contributing](#contributing)\n- [License](#license)\n\n---\n\n## Overview\n\nThis server exposes endpoints corresponding to various `vibe-tools` commands (like `repo`, `plan`, `web`, `browser`, `xcode`, etc.). It translates JSON request bodies into CLI arguments, executes the command in the correct working directory, and returns the output.\n\nIt is implemented in **Python** using **Python MCP SDK** (https://github.com/modelcontextprotocol/python-sdk).\n\nA key feature is the ability to dynamically set the working directory for context-dependent commands, enabling interaction with multiple projects without restarting the server.\n\n---\n\n## Features\n\n- Wraps ALL `vibe-tools` commands.\n- Manages execution context (working directory) dynamically.\n- Allows changing the target project directory via an MCP tool.\n- Handles parameter mapping from JSON to CLI flags.\n- Provides async tool support with proper context injection.\n- Includes unit tests for core functionality.\n\n---\n\n## Prerequisites\n\n1. **Python 3.11+**\n\n2. **vibe-tools CLI**\n\n   - Must be installed globally (`npm install -g vibe-tools` or `pnpm install -g vibe-tools`)\n   - Properly configured with API keys, `.repomixignore`, etc.\n   - See [vibe-tools repo](https://github.com/getcursor/cursor-tools)\n\n3. **Install Python dependencies**\n\n```bash\npip…","publisher":null,"homepage":null,"repository":null,"version":"3.0.2","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-vibe-tools","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.814,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-vibe-tools","registry":"pypi","observedAt":"2026-10-28T15:25:43.472Z","publishedAt":"2025-04-09T19:34:42.380266Z","latestVersion":"3.0.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-vibe-tools","url":"https://pypi.org/project/mcp-vibe-tools/","firstSeenAt":"2026-09-10T05:21:47.264Z","fetchedAt":"2026-10-28T15:23:31.836Z","normalizedAt":"2026-10-28T15:23:31.836Z"}]},"firstSeenAt":"2026-09-10T05:21:47.264Z","updatedAt":"2026-10-28T15:25:43.472Z"}