What can you do with this server?

Connects your IDE agent to VibeMap for bidirectional synchronization: loading project specs into AI agents and reverse-engineering codebases into structured VibeMap assets. Project & Context Management – List, create, and retrieve projects; load full specs (features, stories, personas, pages, DB schema, atomic blueprint, access rules); audit changesets. Spec Authoring – Create user personas, pages, export page source, persist database schema. Features, User Stories, Acceptance Criteria – Create, update, list, and filter by status; manage BDD-format criteria with scenario categories. Kanban & Agentic Lifecycle – View board; claim, report progress, submit for review, resolve, block/unblock criteria; track kanban events. Codebase Reverse Engineering – Scan directory; AI-powered reverse-engineering into features; submit/get structural code maps; sync changes to detect drift; poll generation status. Slash Command Workflows (Prompts) – author_spec (code-first), author_idea (idea-first), sync_changes, code_map, load_context, kanban.

How do I use @vibemap.ai/mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@vibemap.ai/mcp-server load project specs for my app" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@vibemap.ai/mcp-server

by AshMet

Overview Schema Related Servers Score Discussions

TypeScript

Remote

@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.

Related MCP server: llmsproxy

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 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

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 36 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 atomic blueprint for LLM generation
`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 (Engine B — 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)

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)

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 or mark criteria passed/failed (validates transitions)

Kanban — board & agentic lifecycle

Tool	Description
`vibemap_get_kanban_board`	Get a real-time board view
`vibemap_get_next_ready_criterion`	Get the highest-priority criterion ready to work on
`vibemap_claim_criterion`	Claim a criterion (`ready` → `in_progress`)
`vibemap_report_progress`	Append a progress event to a criterion
`vibemap_submit_for_review`	Submit a criterion for review (→ `review_pending`)
`vibemap_resolve_review`	Resolve a review (`passed` / `failed`)
`vibemap_block_criterion`	Block a criterion with a category and reason
`vibemap_unblock_criterion`	Unblock a criterion with a resolution
`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
`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

Prompts (slash commands)

The server also exposes prompts — invocable workflows your IDE surfaces as slash commands (in Claude Code: /mcp__vibemap__<name>). 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. Each takes a projectId; the code-oriented ones also accept an optional localPath.

Prompt	Args	Description
`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)
`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

Documentation

Full docs at vibemap.ai/docs/developer-docs/mcp-server/introduction

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

vibecompass-mcp
Knowledge & Memory Project Management Developer Tools
jack-whimvy
A
license
A
quality
B
maintenance
MCP server that connects AI coding tools to VibeCompass projects for reading context and writing decisions, conflicts, and session notes.
Updated a month ago (2026-07-11 07:29 UTC)
10
18
MIT
llmsproxy
AI & Machine Learning Developer Tools
danielckv
A
license
-
quality
A
maintenance
Connects MCP clients (Claude Desktop, Cursor, Cline, Zed) to llmsproxy.ai, exposing chat, coding, and retrieval capabilities as MCP tools, resources, and prompts.
Updated a month ago (2026-07-01 16:00 UTC)
12
Apache 2.0
Context7 MCP Server
Developer Tools Code Analysis AI & Machine Learning
Mapileon2
F
license
-
quality
D
maintenance
Enables LLM-powered code analysis, generation, debugging, and context management through MCP integration with IDEs like Cursor and Claude Desktop.
Updated a year ago (2025-08-20 20:45 UTC)
Bridge Suite MCP Server
Developer Tools CI/CD & DevOps Autonomous Agents
alarinel
A
license
-
quality
D
maintenance
Gives AI agents full access to IntelliJ IDE by running terminal commands, triggering builds, pushing notifications, and querying project context through a single MCP server with specialized plugins.
Updated 4 months ago (2026-03-30 18:43 UTC)
8
1
MIT

View all related MCP servers

Related MCP Connectors

StremAI
StremAI MCP: shared memory for AI coding agents. Connected agents can recall. OAuth + local stdio.
Frenchie
OCR, transcription, file extraction, and image generation for AI agents via MCP.
anythingmcp
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AshMet/vibemap-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

@vibemap.ai/mcp-server

Quick Start

What It Does

Requirements

IDE Setup

Claude Desktop

Cursor

Windsurf

Environment Variables

Tools

Prompts (slash commands)

Documentation

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

vibecompass-mcp

llmsproxy

Context7 MCP Server

Bridge Suite MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API