Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Debug logging (optional) | |
| NODE_ENV | No | Node.js environment (development/production) | |
| GITHUB_TOKEN | No | For private repository access (optional) | |
| PERSONAS_DIR | No | Custom personas directory | |
| DOLLHOUSE_USER | No | User attribution for persona creation | |
| DOLLHOUSE_EMAIL | No | Contact email (optional) | |
| DOLLHOUSE_DISABLE_UPDATES | No | Disable auto-update system | |
| DOLLHOUSE_INDICATOR_EMOJI | No | Custom emoji for persona indicators | |
| DOLLHOUSE_INDICATOR_STYLE | No | Persona indicator style (minimal/compact/full) | |
| DOLLHOUSE_GITHUB_CLIENT_ID | No | OAuth app client ID (for self-hosting) | |
| DOLLHOUSE_INDICATOR_ENABLED | No | Enable/disable persona indicators |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_elements | List all available elements of a specific type |
| activate_element | Activate a specific element by name |
| get_active_elements | Get information about currently active elements of a specific type |
| deactivate_element | Deactivate a specific element |
| get_element_details | Get detailed information about a specific element |
| reload_elements | Reload elements of a specific type from the filesystem |
| render_template | Render a template element with provided variables |
| execute_agent | Execute an agent element with a specific goal |
| create_element | Create a new element of any type |
| edit_element | Edit an existing element of any type |
| validate_element | Validate an element for correctness and best practices |
| delete_element | Delete an element and optionally its associated data files |
| list_personas | List all available personas |
| activate_persona | Activate a specific persona by name or filename |
| get_active_persona | Get information about the currently active persona |
| deactivate_persona | Deactivate the current persona |
| get_persona_details | Get detailed information about a specific persona |
| reload_personas | Reload all personas from the personas directory |
| create_persona | Create a new persona with guided assistance |
| edit_persona | Edit an existing persona's properties |
| validate_persona | Validate a persona's format and provide quality feedback |
| export_persona | Export a single persona to a JSON format |
| export_all_personas | Export all personas to a JSON bundle |
| import_persona | Import a persona from a file path or JSON string |
| share_persona | Generate a shareable URL for a persona |
| import_from_url | Import a persona from a shared URL |
| browse_collection | Browse content from the DollhouseMCP collection by section and content type. Content types include personas (AI behavioral profiles), skills, agents, and templates. When users ask for 'personas', they're referring to content in the personas type. |
| search_collection | Search for content in the collection by keywords. This searches all content types including personas (AI behavioral profiles that users activate to change AI behavior), skills, agents, prompts, etc. When a user asks to 'find a persona', search in the collection. |
| get_collection_content | Get detailed information about content from the collection. Use this when users ask to 'see details about a persona' or 'show me the creative writer persona'. Personas are a type of content that defines AI behavioral profiles. |
| install_content | Install AI customization elements from the collection to your local portfolio. Use this when users ask to download/install any element type (personas, skills, templates, or agents). Examples: 'install the creative writer persona', 'get the code review skill', 'download the meeting notes template'. |
| submit_content | Submit local content to the collection for community review. Use this when users want to 'share their persona' or 'submit a persona to the collection'. This handles all content types including personas (AI behavioral profiles). |
| get_collection_cache_health | Get health status and statistics for the collection cache system. This helps monitor cache performance and identify any issues with offline browsing capability. |
| browse_marketplace | [DEPRECATED - Use browse_collection] Browse content from the DollhouseMCP collection by section and content type. Content types include personas (AI behavioral profiles), skills, agents, and templates. When users ask for 'personas', they're referring to content in the personas type. | Will be removed in v2.0.0 |
| search_marketplace | [DEPRECATED - Use search_collection] Search for content in the collection by keywords. This searches all content types including personas (AI behavioral profiles that users activate to change AI behavior), skills, agents, prompts, etc. When a user asks to 'find a persona', search in the collection. | Will be removed in v2.0.0 |
| get_marketplace_persona | [DEPRECATED - Use get_collection_content] Get detailed information about content from the collection. Use this when users ask to 'see details about a persona' or 'show me the creative writer persona'. Personas are a type of content that defines AI behavioral profiles. | Will be removed in v2.0.0 |
| install_persona | [DEPRECATED - Use install_content] Install AI customization elements from the collection to your local portfolio. Use this when users ask to download/install any element type (personas, skills, templates, or agents). Examples: 'install the creative writer persona', 'get the code review skill', 'download the meeting notes template'. | Will be removed in v2.0.0 |
| submit_persona | [DEPRECATED - Use submit_content] Submit local content to the collection for community review. Use this when users want to 'share their persona' or 'submit a persona to the collection'. This handles all content types including personas (AI behavioral profiles). | Will be removed in v2.0.0 |
| set_user_identity | Set your username for persona attribution and collection participation |
| get_user_identity | Get current user identity information |
| clear_user_identity | Clear user identity and return to anonymous mode |
| setup_github_auth | Set up GitHub authentication to access all DollhouseMCP features. This uses GitHub's secure device flow - no passwords needed! Use this when users say things like 'connect to GitHub', 'set up GitHub', 'I have a GitHub account now', or when they try to submit content without authentication. |
| check_github_auth | Check current GitHub authentication status. Shows whether you're connected to GitHub, your username, and what actions are available. Use when users ask 'am I connected to GitHub?', 'what's my GitHub status?', or similar questions. |
| clear_github_auth | Remove GitHub authentication and disconnect from GitHub. Use when users say 'disconnect from GitHub', 'remove my GitHub connection', 'clear authentication', or want to switch accounts. |
| check_for_updates | Check if a newer version of DollhouseMCP is available |
| update_server | Update DollhouseMCP to the latest version from GitHub |
| rollback_update | Rollback to the previous version from backup |
| get_server_status | Get current server status, version, and system information |
| convert_to_git_installation | Convert from npm installation to git installation for more control over updates |
| configure_indicator | Configure how active persona indicators are displayed |
| get_indicator_config | Get current persona indicator configuration |