Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Debug logging (optional) | |
| NODE_ENV | No | Development mode | |
| 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_INDICATOR_EMOJI | No | Custom emoji for persona indicators | |
| DOLLHOUSE_INDICATOR_STYLE | No | Style for persona indicators (minimal, compact, full) | |
| DOLLHOUSE_INDICATOR_ENABLED | No | Enable or 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_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, prompts, templates, tools, and ensembles. 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, agents, memories, or ensembles). 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). |
| 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 |
| 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 |
| configure_indicator | Configure how active persona indicators are displayed |
| get_indicator_config | Get current persona indicator configuration |