Vibemap MCP

Name: Vibemap MCP
Author: AshMet

by AshMetversion 2.8.1i★ –iRuns on your computer

Registry nameio.github.AshMet/vibemap-mcp

Install

Overview

Description from the maker (original English)

Load & create VibeMap product specs from your coding agent; sync build progress.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiVery new↓ 68/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Developer tools
You need to fill in: VIBEMAP_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: VIBEMAP_API_KEY, VIBEMAP_BASE_URL

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "vibemap": {
      "command": "npx",
      "args": [
        "-y",
        "@vibemap.ai/mcp-server"
      ],
      "env": {
        "VIBEMAP_API_KEY": "your-value",
        "VIBEMAP_BASE_URL": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add vibemap --env VIBEMAP_API_KEY=your-value --env VIBEMAP_BASE_URL=your-value -- npx -y @vibemap.ai/mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "vibemap": {
      "command": "npx",
      "args": [
        "-y",
        "@vibemap.ai/mcp-server"
      ],
      "env": {
        "VIBEMAP_API_KEY": "your-value",
        "VIBEMAP_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "vibemap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vibemap.ai/mcp-server"
      ],
      "env": {
        "VIBEMAP_API_KEY": "your-value",
        "VIBEMAP_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

VIBEMAP_API_KEY secret required env
API key from vibemap.ai -> Account -> MCP (Pro plan)
VIBEMAP_BASE_URL env
Defaults to https://vibemap.ai

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account AshMet, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Developer toolsi

More stars than 0% of the other 4927 servers in this category
Published to the registry more recently than 29% of the other 4927 servers in this category
Basic checks equal to or better than 100% of the other 4927 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Vibemap MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: VIBEMAP_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (2.8.1) reached the registry 3 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: GitHub, Desktop Commander, Cloudflare MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitHub

GitHub’s official server lets AI read and manage code, issues and pull requests in your account. Use GitHub’s hosted version or run it locally with Docker.

by githubWidely used★ 34.2KUpdated 5 days ago

Computer or cloud

Install

Desktop Commander

MCP server for terminal commands, file operations, and process management

by wonderwhy-erWidely used↓ 709.6K/wk★ 10.2KUpdated 17 days ago

Runs on your computer

Install

Cloudflare MCP

Cloudflare MCP servers

by cloudflareGrowing★ 4.4KUpdated 14 months ago

Runs in the cloud✓ mcp.cloudflare.com

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@vibemap.ai/mcp-server

Connect your IDE agent to VibeMap via the Model Context Protocol. Load project specs into any MCP-compatible AI coding agent, or reverse-engineer an existing codebase back into structured VibeMap assets.

Quick Start

"mcpServers": { "vibemap": { "command": "npx", "args": ["-y", "@vibemap.ai/mcp-server"], "env": { "VIBEMAP_API_KEY": "vm_your_token_here", "VIBEMAP_BASE_URL": "https://vibemap.ai" } } } }

Generate your API key at vibemap.ai → Account → Developer → API Keys.

What It Does

Outbound (VibeMap → IDE): Load your full project context — features, user stories, acceptance criteria, personas, pages, and DB schema — into your IDE agent. The agent builds to spec and updates your VibeMap kanban in real time as it works.

Inbound (IDE → VibeMap): Point the server at an existing codebase and VibeMap's AI will reverse-engineer it into a structured set of features, user stories, and acceptance criteria.

Requirements

Node.js ≥ 18
A VibeMap account

IDE Setup

Claude Desktop

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

"mcpServers": { "vibemap": { "command": "npx", "args": ["-y", "@vibemap.ai/mcp-server"], "env": { "VIBEMAP_API_KEY": "vm_your_token_here", "VIBEMAP_BASE_URL": "https://vibemap.ai" } } } }

Fully restart Claude Desktop after saving. Confirm the 🔨 hammer icon appears in the message box.

Cursor

Open Settings → MCP and add:

"vibemap": { "command": "npx", "args": ["-y", "@vibemap.ai/mcp-server"], "env": { "VIBEMAP_API_KEY": "vm_your_token_here", "VIBEMAP_BASE_URL": "https://vibemap.ai" } } }

Windsurf

Same format as Cursor. Add to your Windsurf MCP settings file and restart.

Environment Variables

Variable	Description	Default
`VIBEMAP_API_KEY`	Your Personal Access Token (`vm_...`)	Required
`VIBEMAP_BASE_URL`	VibeMap instance URL	`http://localhost:3000`

Tools

The server exposes 55 tools via the vibemap_ prefix.

Projects & context

Tool	Description
`vibemap_list_projects`	List all your projects
`vibemap_create_project`	Create a new project (use before `analyze_codebase`)
`vibemap_get_project_context`	Load full project specs into agent context
`vibemap_get_atomic_blueprint`	Get the code-shaped blueprint of the whole project (large; for scaffolds and audits, not for building a single ticket: use `vibemap_get_criterion_context` there)
`vibemap_list_access_rules`	List table- and page-level access rules (with `op_conditions`) for RLS + auth
`vibemap_get_page_source`	Retrieve a page and its section source code

Personas & pages (spec authoring)

Tool	Description
`vibemap_create_persona`	Create a rich user persona (demographics, goals, pain points, …)
`vibemap_create_page`	Create a page/screen in the project's page inventory
`vibemap_create_schema`	Persist the database schema (tables → columns → relationships) in one call

Conversational agent (hosted, metered)

Tool	Description
`vibemap_agent`	Drive VibeMap's full conversational agent for one turn (same brain as the in-app chat). Metered — uses VibeMap tokens. Destructive turns return a plan + `operationId` to approve in a second call; long generations run in the background (poll `get_generation_status`)

Features

Tool	Description
`vibemap_list_features`	List features with filtering
`vibemap_create_feature`	Create a new feature
`vibemap_update_feature`	Update feature fields or status (validates transitions). For spec authoring only: while building, use `vibemap_propose_spec_change`

User stories

Tool	Description
`vibemap_list_user_stories`	List stories by project or feature
`vibemap_create_user_story`	Create a user story
`vibemap_update_user_story`	Update story fields or status (validates transitions). For spec authoring only: while building, use `vibemap_propose_spec_change`

Acceptance criteria

Tool	Description
`vibemap_list_acceptance_criteria`	Fetch BDD criteria
`vibemap_create_acceptance_criterion`	Create a BDD acceptance criterion
`vibemap_update_acceptance_criterion`	Update a criterion's content (Given/When/Then, description). Status is not writable here: use the lifecycle tools below. For spec authoring only: while building, use `vibemap_propose_spec_change`

Kanban — board & agentic lifecycle

Tool	Description
`vibemap_get_kanban_board`	Get a real-time board view
`vibemap_get_execution_plan`	The build order: criteria grouped by sprint in dependency order, with state
`vibemap_get_next_ready_criterion`	Get the next criterion to work on, its story bundle, and a `reason` when nothing is claimable
`vibemap_claim_story`	Claim every claimable criterion of a story at once; returns a context pack for each
`vibemap_claim_criterion`	Claim a criterion (`ready` → `in_progress`)
`vibemap_get_criterion_context`	Everything needed to build one criterion in a few thousand tokens (use instead of the whole blueprint)
`vibemap_report_progress`	Heartbeat with the current `phase`, plus optional plan, files and test counts
`vibemap_submit_for_review`	Submit a criterion for review with the changed files and the named tests that prove it (→ `in_review`)
`vibemap_get_criterion_evidence`	Submission history of a criterion: files, tests and verdict per attempt
`vibemap_rework_criterion`	Send a criterion that failed review back to `ready` to build it again
`vibemap_resolve_review`	Resolve a review (`passed` / `failed`); needs a CI-review token or a signed-in user
`vibemap_block_criterion`	Block a criterion with a category and reason
`vibemap_ask_user`	Ask the project owner a question when the spec is unclear (blocks the criterion until answered)
`vibemap_get_answers`	Collect the answers to your questions
`vibemap_unblock_criterion`	Unblock a criterion with a resolution
`vibemap_propose_spec_change`	Propose a spec change for the owner to review when the code must differ; never edits the spec
`vibemap_list_kanban_events`	Kanban transition history (for incremental sync)
`vibemap_update_kanban_status`	⚠️ Deprecated — use the lifecycle tools above

Version control

Tool	Description
`vibemap_list_changesets`	List changesets (your writes + history) with op counts; `includeOps` for diffs, `sinceSeq` as a cursor
`vibemap_get_spec_delta`	What changed in the spec since a sequence number, and which criteria that affects
`vibemap_get_release_work_list`	A release's work grouped as new, modified and removed (with the code paths to delete)
`vibemap_get_release_diff`	A release's raw diff against its baseline
`vibemap_sync_changes`	Report changed paths since the last sync so VibeMap can flag spec drift

Codebase

Tool	Description
`vibemap_scan_codebase`	Walk a local directory
`vibemap_analyze_codebase`	Reverse-engineer a codebase into VibeMap assets
`vibemap_submit_code_map`	Submit a structural code map (nodes/edges) rendered on the project's Codebase tab
`vibemap_get_code_map`	Fetch the project's current code map (status, nodes/edges, sync anchor + drift)
`vibemap_get_generation_status`	Poll AI generation task status

Import an existing codebase

The structure is read on your machine with no model and no network call. What reaches VibeMap is the structural facts (table, column, policy and route definitions with their file paths) and the spec text your agent writes. File contents never leave your machine.

Tool	Description
`vibemap_extract_repo_facts`	Read the repository's tables, policies, routes and file clusters locally; sends nothing
`vibemap_import_facts`	Send the facts: VibeMap creates the schema, access rules and a page per route, each linked to its file
`vibemap_import_semantic`	Send the features, stories and criteria your agent wrote, each citing its source files
`vibemap_finalize_import`	Pass the imported criteria (unverified), lock MVP1 and open MVP2
`vibemap_resync`	Apply the structural changes at your current commit and flag the specs the changed files touch
`vibemap_resolve_drift`	Clear handled files, map units or criteria from the drift report
`vibemap_resolve_code_drift_proposal`	Apply or dismiss one staged code-drift proposal

Prompts (slash commands)

The server also exposes prompts — invocable workflows your IDE surfaces as slash commands (in Claude Code: /mcp__vibemap__ ). The body of each prompt is expanded from VibeMap's server at call time, so you invoke a workflow rather than paste a long instruction. Every prompt takes a projectId except new_project, which is the one that creates a project; the code-oriented ones also accept an optional localPath.

Prompt	Args	Description
`new_project`	—	Guided interview that creates a new VibeMap project. Start here
`author_spec`	`projectId`, `localPath?`	Author the full spec graph from your local codebase (bring-your-own-agent, code-first)
`author_idea`	`projectId`	Author the full spec graph from the project idea (bring-your-own-agent, idea-first)
`author_personas`	`projectId`	Stage 1 of 5 — author just the personas
`author_features`	`projectId`	Stage 2 of 5 — author just the features
`author_stories`	`projectId`	Stage 3 of 5 — author just the user stories
`author_criteria`	`projectId`	Stage 4 of 5 — author just the acceptance criteria
`author_pages`	`projectId`	Stage 5 of 5 — author just the pages
`author_schema`	`projectId`, `localPath?`	Author the database schema — tables, columns, relationships
`sync_changes`	`projectId`, `localPath?`	Detect and reconcile spec drift since the last sync
`code_map`	`projectId`, `localPath?`	Build and submit a structural code map
`load_context`	`projectId`	Load the project's spec context into your agent
`kanban`	`projectId`	Show the project's kanban board
`import`	`projectId`, `localPath?`	Import an existing codebase as a locked MVP1: extract locally, import the facts, write the spec per cluster, finalize
`resync`	`projectId`, `localPath?`	Bring an imported project up to date and stage drift proposals for review
`build_sprint`	`projectId`	Build the ready work test first while the board follows live; CI verifies, the agent never marks anything done
`release_next`	`projectId`	Build the next release: new and modified items, and delete what was removed

`gen_*` — run VibeMap's own generators

The author_* prompts above run on your model: your agent does the thinking and VibeMap just stores the result. The gen_* prompts are the other half — they run VibeMap's hosted generation pipelines, the same ones behind the app's /gen-… slash commands. They are metered (they draw down the project owner's VibeMap token budget) and asynchronous (you get a sessionId back and poll vibemap_get_generation_status).

Prompt	Args	Description
`gen_personas`	`projectId`	Generate personas — who you're building for
`gen_features`	`projectId`	Generate features — the set every story, page and table hangs off
`gen_stories`	`projectId`	Generate user stories from your features

| gen_criteria | projectId | Derive acceptance

Only the beginning is shown; read the rest in the repo

Vibemap MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Developer toolsi

Common questions

Alternatives

GitHub

Desktop Commander

Cloudflare MCP

README from the maker

@vibemap.ai/mcp-server

Quick Start

What It Does

Requirements

IDE Setup

Claude Desktop

Cursor

Windsurf

Environment Variables

Tools

Prompts (slash commands)

gen_* — run VibeMap's own generators

`gen_*` — run VibeMap's own generators