get_profile
Get Profile
Retrieve the current user's profile information including name, email, language, and default team/project IDs.
Ask your agent in plain language. Each of these maps to a real tool on the server.
get_profile
Retrieve the current user's profile information including name, email, language, and default team/project IDs.
get_page
Retrieve the contents of a specific page in a design file, including all objects/shapes on the page. If no pageId is provided, returns the first page.
manage_libraries
List, link, or unlink shared design libraries for a file. Libraries provide reusable components, colors, and typographies across files.
manage_pages
Add, rename, reorder, or delete pages within a design file. Pages are managed through the file update mechanism.
get_file_summary
Get a lightweight summary of a design file's components, variants, colors, and typographies without loading the full file data.
manage_comments
Create, list, reply to, resolve, and delete comments and comment threads on design files. Use **action** to specify the operation.
manage_project
Create, rename, delete, or pin/unpin a project within a team. Use **action** to specify the operation.
list_projects
List all projects within a team. Projects are containers for grouping design files.
list_teams
List all teams the current user belongs to, including owned teams and teams they've been invited to. Includes team metadata and member counts.
manage_file
Create, rename, delete, or update sharing settings of a design file. Use **action** to specify the operation.
manage_team
Create, rename, or delete a team. Also retrieve team details and members, invite teammates, and manage member roles. Use **action** to specify the operation.
get_file
Retrieve detailed information about a design file, including its pages, component summary, and metadata. For full file data with all shapes, use the **includeData** flag.
list_files
List design files by project, recent files by team, shared library files, or search files by name. Use **source** to choose the listing mode.
export_file
Export a design file in Penpot's native .penpot binary format. Can optionally include linked libraries and embed assets for standalone import.
add_media_from_url
Upload a media asset (image) to a design file from a URL. The image will be downloaded and stored as a media object in the file.
manage_file_snapshot
Save a named version of a design file, restore a saved version, or delete a user-created version. Restoring replaces the current file contents; retrieve get_file again before making further edits.
list_file_snapshots
List the visible saved versions of a design file, including labels, revision numbers, and creator information. Use the returned snapshot IDs to restore a version.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Create, manage, and export design files and prototyping projects. Manage teams with role-based access, organize projects, and manipulate design elements including shapes, components, pages, and media assets. Search and filter shapes by type, color, font, or text content. Upload media assets, add comments for collaboration, export design tokens for code workflows, and export files in native .penpot format.
Common questions about connecting Penpot to AI agents with Metorial.