Vibemap MCP server
io.github.AshMet/vibemap-mcp·v2.8.1Load & create VibeMap product specs from your coding agent; sync build progress.
0 stars28 downloads/wk
Reviews
Write oneNobody has reviewed Vibemap yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Vibemap tools (35, 13 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
vibemap_analyze_codebaseScan a local codebase and submit it to VibeMap for AI-powered reverse engineering. The server-side generation persists FEATURES from the code digest. It does NOT persist user stories or acceptance criteria — after the features task completes (poll vibemap_get_generation_status), create those yourself with vibemap_create_user_story and vibemap_create_acceptance_criterion, using your full codebase a
vibemap_block_criterionMark a criterion as blocked. Transitions any-active-status → blocked. Use this when external dependency, ambiguity, or environmental issue prevents progress.
vibemap_claim_criterionAtomically claim an acceptance criterion for implementation. Transitions ready → in_progress. Returns 409 (race) if another agent already claimed it.
vibemap_create_acceptance_criterionwrite actionCreate a new acceptance criterion for a user story in BDD format (Given/When/Then). Use this to flesh out what 'done' means for a story before or during implementation. You can call this multiple times to add multiple scenarios (happy path, error cases, edge cases) to the same story.
vibemap_create_featurewrite actionCreate a new feature in a VibeMap project. Use this when reverse-engineering a codebase to register discovered capabilities.
vibemap_create_pagewrite actionCreate a page/screen in a VibeMap project's page inventory. Author pages after features, stories, and criteria to capture the app's screens and routes. Existing pages are visible via vibemap_get_project_context — enrich, don't duplicate.
vibemap_create_personawrite actionCreate a user persona in a VibeMap project. Personas are the cast of users the spec is written for — author them FIRST, then reference each persona's role (userRole) when writing user stories. Match the depth VibeMap's own generator produces: fill the structured blocks so the persona is rich and semantically searchable, not just a name. Existing personas are visible via vibemap_get_project_context
vibemap_create_projectwrite actionCreate a new VibeMap project. Use this when starting from an existing codebase — create the project first, then call vibemap_analyze_codebase with the returned project ID.
vibemap_create_schemawrite actionPersist a VibeMap project's database schema — tables, columns, and relationships — in one call. Author this LAST, after the rest of the spec exists, grounded on the spec (idea-first) or the codebase's models/migrations (code-first). One table per domain entity; give every table an `id` primary key and created_at/updated_at; set real Postgres column types + constraints; express foreign keys via eac
vibemap_create_user_storywrite actionCreate a new user story inside a VibeMap feature. Provide the user role, action, and expected outcome.
vibemap_get_atomic_blueprintRetrieve a code-shaped atomic blueprint of a VibeMap project — relationships hydrated, Kanban metadata stripped, with synthesized interactions and entity state machines. Designed for LLM coders building the application end-to-end. Prefer this over vibemap_get_project_context when generating code; the blueprint omits PM narrative and process metadata to maximise signal-per-token.
vibemap_get_code_mapFetch the project's current code map (status draft|confirmed, nodes/edges, sync anchor incl. any drift report). Use before re-submitting to preserve the user's hidden-node curation where possible.
vibemap_get_generation_statusPoll the status of a VibeMap AI generation task (e.g., reverse engineering or spec generation). Use the sessionId returned by vibemap_analyze_codebase.
vibemap_get_kanban_boardGet a real-time kanban board view of a project grouped by status columns. Shows features with their stories nested underneath. Ideal for an IDE agent to understand what's planned, in progress, and done.
vibemap_get_next_ready_criterionGet the highest-priority acceptance criterion in `ready` status for the given project. Returns the criterion to work on next, or null if nothing is ready.
vibemap_get_page_sourceRetrieve a VibeMap page's generated source code so you can pull it straight into a repo. Returns the page's own source_code plus the source_code of each of its sections. Use this to export a generated page into your codebase instead of copy-pasting.
vibemap_get_project_contextRetrieve the full context of a VibeMap project including features, user stories, personas, pages, and database schema. Use this before building a feature to understand all the specs.
vibemap_list_acceptance_criteriaList acceptance criteria for a story, feature, or project. Returns BDD-formatted criteria (Given/When/Then) with status.
vibemap_list_access_rulesList a VibeMap project's access-control rules: table-level rules (per persona/role, with can_select/insert/update/delete and structured op_conditions predicates like "own rows only") and page-level rules (can_view/create_content/edit/delete with predicates), plus an advisory reconciliation summary flagging page↔table drift. Use this to generate correct RLS policies and route/UI authorization — the
vibemap_list_changesetsList a VibeMap project's version-control changesets (most recent first) with a per-changeset op count. Every write you make through this server is wrapped in a changeset, so use this to see the changesets your own edits produced, audit who/what changed the project, or review recent edit history. Pass includeOps=true to inline each changeset's individual operations (entity_type, op, diff).
vibemap_list_featuresList features for a VibeMap project. Supports filtering by status, priority, category, and search. Returns paginated results.
vibemap_list_kanban_eventsList kanban transition events for a project, newest first. Use `since` to fetch only events after a timestamp (for reconnect-backfill).
vibemap_list_projectsList all VibeMap projects for the authenticated user. Returns project IDs, names, descriptions, and status.
vibemap_list_user_storiesList user stories for a project or feature. Filter by status, priority. Returns paginated results with full story detail.
vibemap_report_progressAppend a progress event to the criterion timeline without changing its status. Used to surface intermediate work for visibility.
vibemap_resolve_reviewResolve a criterion in review. Transitions in_review → passed | failed. NOTE: agents (env_token:agent) cannot self-resolve their own work — this tool requires a CI-scoped token (env_token:ci) or a session user.
vibemap_scan_codebaseScan a local directory and return a formatted tree view plus file statistics. Use this to explore and understand an existing codebase before syncing to VibeMap.
vibemap_submit_code_mapwrite actionSubmit a structural code map of the user's codebase to VibeMap (rendered on the project's Codebase tab). Build it yourself from your codebase access: one node per meaningful unit (page/route, API endpoint, data model, service, module, config), edges for imports/routes/reads/writes. Node kinds: page|api|model|service|module|config. Layers: ui|api|data|services|shared. Edge kinds: imports|routes|rea
vibemap_submit_for_reviewwrite actionSubmit completed work for review. Transitions in_progress → in_review. Requires a git SHA and a diff URL as evidence.
vibemap_sync_changesReport codebase changes since the last sync so VibeMap can flag spec drift. Workflow: 1) call vibemap_get_code_map and read anchor.commitSha; 2) run `git diff --name-only <commitSha>..HEAD` (plus untracked files from `git status --porcelain`); 3) call this tool with the changed paths and your current HEAD sha. The response lists affected map units and features — update the stale specs with vibemap
vibemap_unblock_criterionUnblock a criterion. Transitions blocked → prior_status (recorded when block was set; defaults to ready).
vibemap_update_acceptance_criterionwrite actionUpdate an acceptance criterion's status or content. Use status 'passed' when your code satisfies the criterion, 'failed' when it does not.
vibemap_update_featurewrite actionUpdate an existing feature's fields or status in VibeMap.
vibemap_update_kanban_statuswrite action[DEPRECATED — use the typed transition tools (claim, report_progress, submit_for_review, resolve_review, block, unblock) instead. This tool will be removed in a future release.] Atomically advance or update the kanban status of a feature, user story, or acceptance criterion. Validates allowed state transitions and prevents invalid moves. Call this when you start or finish implementing something. F
vibemap_update_user_storywrite actionUpdate an existing user story's fields or status in VibeMap.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 4 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Vibemap compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 77% of 2,174 E-commerce servers
- Tools
- 35
- the typical E-commerce server has 6
- Tools that change things
- 37%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 28
- more than 18% of 411 E-commerce servers with a package
What its tools let an agent do: 22 read · 13 change
Install Vibemap in Claude Code, Cursor or VS Code
Runs npx -y @vibemap.ai/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add vibemap-mcp -- npx -y @vibemap.ai/mcp-server
What the publisher says
From the Vibemap repository's README, as published. We do not edit it. Read it on GitHub
@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/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.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 chat input.
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
Tools
The server exposes 36 tools via the vibemap_ prefix.
Projects & context
Personas & pages (spec authoring)
Conversational agent (Engine B — hosted, metered)
Features
User stories
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Vibemap: common questions
- Is Vibemap MCP server safe?
- Mostly: it is graded B (83/100). Read the Vibemap safety report
- How do I install Vibemap?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Vibemap need an API key?
- Yes. The registry entry asks for
VIBEMAP_API_KEY. - Is Vibemap maintained?
- The last commit was 45 days ago (2026-09-20). The latest release is v2.8.1.
- What can I use instead of Vibemap?
- Servers from other publishers that do the same job: Loki Mode MCP server, PostHog MCP Server and New-Term Radar MCP server.
- How does Vibemap compare with other E-commerce MCP servers?
- safety score 83/100 (higher than 77% of 2,174 E-commerce servers); tools 35 (the typical E-commerce server has 6); tools that change things 37% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Vibemap
Same job from other publishers: the closest match first, then the best rated.
- Loki ModeAutonomous spec-to-product coding-agent CLI with an MCP server exposing 39 tools over stdio.not reviewedEstablishedB
- PostHog MCP ServerOfficial PostHog MCP Server for product analytics, feature flags, experiments, and more.not reviewedEstablishedA
- New-Term RadarNew AI model, product and repo names as they surface, and the search terms behind them, sized.not reviewedEstablishedB
- Idea RealityPre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.not reviewedEstablishedB
- StripeMCP server integrating with Stripe - tools for customers, products, payments, and more.not reviewedEstablishedA