Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port on which the MCP server will run | 5000 |
| DEBUG | No | Enable debug mode for additional logging | true |
| PENPOT_API_URL | No | The URL of the Penpot API | https://design.penpot.app/api |
| PENPOT_PASSWORD | Yes | Your Penpot password for authentication | |
| PENPOT_USERNAME | Yes | Your Penpot username for authentication |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| server_info | Provide information about the server. |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_projects | Retrieve a list of all available Penpot projects. |
| get_project_files | Get all files contained within a specific Penpot project. |
| get_file | Retrieve a Penpot file by its ID and cache it. Don't use this tool for code generation, use 'get_object_tree' instead. |
| export_object | Export a Penpot design object as an image. |
| get_object_tree | Get the object tree structure for a Penpot object ("tree" field) with rendered screenshot image of the object ("image.mcp_uri" field). Args: file_id: The ID of the Penpot file object_id: The ID of the object to retrieve fields: Specific fields to include in the tree (call "penpot_tree_schema" resource/tool for available fields) depth: How deep to traverse the object tree (-1 for full depth) format: Output format ('json' or 'yaml') |
| search_object | Search for objects within a Penpot file by name. |
| penpot_schema | Provide the Penpot API schema as JSON. |
| penpot_tree_schema | Provide the Penpot object tree schema as JSON. |
| get_rendered_component | Return a rendered component image by its ID. |
| get_cached_files | List all files currently stored in the cache. |