Available tools and actions

Depending on your user role permissions, the Prepr MCP server allows an AI client to perform actions using the tools listed below.

Context and discovery

The AI client can inspect environment settings, locale configurations, and content models to safely map out your data layout.

• get_initial_context - Bootstrap the session with environment metadata, locales, workflow stages, current user, and a schema summary.
• get_schema - Inspect the full environment schema and resolve exact model IDs and field IDs.
• list_locales - See which locales exist in the current environment before reading or changing localized content.
• list_workflow_stages - Discover the valid workflow stages you can move content through.
• list_users - Find assignable users before assigning content items.
• get_current_user - Resolve the currently authenticated user, especially for requests like “assign to me”.

Read and query

The AI client can locate, filter, and fetch your existing content and assets without altering any database records.

• query_items - Search and filter content items when you need one or more matching candidates.
• query_assets - Search and filter assets such as images, videos, audio, documents, and PDFs.
• get_item - Fetch a single content item when you already know its exact Content Item ID.

Write and mutation

If granted write access via your token, the AI client can actively build, modify, transition, or publish items inside Prepr.

• create_item - Create one localized content item in a specific model.
• update_item - Fully update one localized content item while keeping the existing locale payload shape intact.
• patch_items - Patch supported root-level fields on an existing localized content item without sending a full update payload.
• upload_asset - Import a public image, audio file, or document URL into Prepr as an asset.
• publish_items - Publish one or more localized content items now or schedule them for later.
• unpublish_items - Unpublish one or more localized content items in a specific locale.
• change_workflow_stage_items - Move one or more content items to a different workflow stage.

Collaboration and deletion

The AI handles content assignments, editorial comments, and explicit-confirmation removals to keep teamwork seamless and safe.

• assign_items - Assign one or more localized content items to a specific user.
• unassign_items - Remove the assigned user from one or more localized content items.
• add_comment - Add an editorial comment to a content field on a localized content item.
• delete_items - Permanently delete an entire content item across all locales, with explicit confirmation.
• delete_item_locale - Permanently delete one locale from a content item, with explicit confirmation.
• give_feedback - Report MCP tool issues such as broken behavior, missing capabilities, confusing output, or unclear documentation.