customizationpersonasskillsagentspermissioning
MCP server enabling reusable AI customization elements with dynamic permissioning and versioning for any MCP client.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
We couldn’t automatically confirm this listing starts correctly
The install command below didn't complete successfully in our automated test.
npx -y @dollhousemcp/mcp-server@latestnpm notice npm notice New major version of npm available! 10.1.0 -> 12.0.2 npm notice Changelog: <https://github.com/npm/cli/releases/tag/v12.0.2> npm notice Run `npm install -g npm@12.0.2` to update! npm notice npm ERR! code ETARGET npm ERR! notarget No matching version found for @posthog/types@^1.409.1. npm ERR! notarget In most cases you or one of your dependencies are requesting npm ERR! notarget a package version that doesn't exist. npm ERR! A complete log of this run can be found in: /h
This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 4d ago.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Create and customize AI personas and skills
Activate ensembles to modify AI behavior dynamically
Edit templates and agents to refine AI tasks
Manage local portfolios of AI customization elements
Browse and install community-shared AI elements
Key features
Modular elements: personas, skills, templates, agents, memories, ensembles
Dynamic permissioning for AI operation safety
Robust validation and versioning architecture
Local portfolio management with starter elements
Public collection of shareable AI customization content
Browser-based setup wizard with multi-client support
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Server.
Extracted Tool Capabilities
Modular elements: personas, skills, templates, agents, memories, ensembles
Dynamic permissioning for AI operation safety
Robust validation and versioning architecture
Local portfolio management with starter elements
Public collection of shareable AI customization content
Browser-based setup wizard with multi-client support
Documentation Overview
DollhouseMCP
Open-source AI customization through modular elements.
How It Works
Pick any path to start:
- Activate a starter element from your portfolio — your AI immediately changes
- Create any element type (persona, skill, template, agent, memory, ensemble) by describing what you want in plain English
- Edit any existing element to refine it
- Browse the community collection and install elements made by other users
Your portfolio (~/.dollhouse/portfolio/ on macOS/Linux, %USERPROFILE%\.dollhouse\portfolio\ on Windows) is a local folder that holds all your Dollhouse elements. It ships with 37 starters — including the dollhouse-expert-suite ensemble (persona + knowledge base) you can activate for guided help. Everything you create or install lands here. Share back to the community or sync to GitHub whenever you're ready.
Quick Start
v2.0.0 is now available. DollhouseMCP v2 is the default release. Release notes | Migration guide | Report issues
DollhouseMCP installs on any MCP-compatible AI client — Claude Code, Claude Desktop, Cursor, Gemini, Codex, and local LLMs. Core element management (create, activate, search, browse) works across all platforms. Advanced features (Gatekeeper confirmation flows, agentic loop execution) have been tested extensively on Claude Code and should work on any client that supports standard MCP tool call/response patterns.
Interactive Setup (any platform):
Opens a browser-based setup wizard with one-click install for Claude Desktop, Claude Code, Cursor, VS Code, Codex, Gemini CLI, Windsurf, Cline, and LM Studio. Detects existing installations, supports auto-updating and pinned versions.
Permission hook support in the setup wizard currently breaks down like this:
| Platform | Setup status | Permission hook status |
|---|---|---|
| Claude Code | One-click install | Full native support |
| Cursor | One-click install | Partial native support |
| VS Code | One-click install | Partial native support |
| Codex | One-click install | Partial native support, Bash-only |
| Gemini CLI | One-click install | Partial native support |
| Windsurf | One-click install | Partial native support |
| Cline | One-click install | MCP setup only in this release |
| LM Studio | One-click install | MCP setup only in this release |
| Claude Desktop | One-click install | No native permission hook path in this release |
Claude Code (one command):
Claude Desktop (one-click install):
Download the DollhouseMCP Desktop Extension (.mcpb file) and double-click it. Claude Desktop handles the rest — no terminal required.
Other platforms — see the Quick Start Guide or run the interactive setup above.
Then start a conversation:
DollhouseMCP ships with 38 Dollhouse elements across all 6 types. Just describe what you want in natural language.
First time? The Public Beta Onboarding Guide walks you from install to your first activated Dollhouse persona in under 10 minutes.
Dollhouse Elements: Behavior, Capabilities, and Permissions
Dollhouse elements are modular building blocks that customize your AI. When you activate a Dollhouse element, you're not just changing a prompt — you're changing what tools the AI can access, what commands it can run, and what operations require your approval.
| Dollhouse Element | What It Does |
|---|---|
| Dollhouse Personas | Shape behavior, tone, expertise, and priorities. Act as security principals with permission policies that control what the AI can do. |
| Dollhouse Skills* | Add discrete capabilities the AI can activate on demand. Code review, data analysis, penetration testing, translation, and more. |
| Dollhouse Templates | Standardize outputs with variable substitution. Reports, emails, briefs, documentation — consistent structure every time. Variables are auto-derived from {{placeholder}} tokens in content — no manual schema needed. |
| Dollhouse Agents | Execute multi-step goals autonomously. State tracking, resilience policies, autonomy evaluation, and an execution lifecycle. |
| Dollhouse Memories | Persist structured context across sessions. Facts, preferences, project state. Can auto-load on startup. |
| Dollhouse Ensembles | Bundle multiple elements into one activatable unit. Activation strategies, conflict resolution, and coordinated permission policies. |
*Skills Compatibility
Dollhouse Skills (introduced July 2025) predate the agent skills format later adopted by Claude/Anthropic. DollhouseMCP includes a built-in lossless bidirectional converter between the two formats.
- Import: Convert agent skills → Dollhouse Skills via
convert_skill_format. Once converted, they're first-class Dollhouse elements — combinable with Personas, Templates, and other Skills inside Ensembles, managed by Dollhouse Agents, and protected by Gatekeeper policies.- Export: Convert Dollhouse Skills → agent skills for platforms that don't have DollhouseMCP installed.
- Roundtrip: The converter supports a lossless mode that preserves everything in both directions. A safe mode is also available that sanitizes potentially risky patterns during conversion.
All Dollhouse elements are readable markdown or YAML files stored in your local portfolio. You own them, you control them. When interacting with your AI, use "Dollhouse" to disambiguate — say "activate the Dollhouse code review persona" or "run the Dollhouse research agent" to ensure the AI uses DollhouseMCP elements rather than native platform features.
MCP-AQL: How Your AI Talks to DollhouseMCP
Most MCP servers expose dozens of individual tools, each consuming context tokens and forcing the LLM to pick the right one from a flat list. DollhouseMCP takes a different approach.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
41
Stargazers on the source repository.
Last commit
6d ago
Most recent push to the default branch.
Install check
Inconclusive
Install command did not finish in our automated test.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/dollhousemcp-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/dollhousemcp-mcp-server"><img src="https://allmcps.com/api/badge/dollhousemcp-mcp-server?style=directory" alt="MCP Server on AllMCPs" /></a>