prismic_add_media
Upload media files to Prismic CMS with optional metadata like alt text, credits, and notes. Securely adds images or documents to your content repository using the Asset API.
Instructions
Upload media via Prismic Asset API.
Uploads file_path using multipart/form-data to POST /assets.
Optional metadata maps to Asset API fields: notes, credits, alt.
Requires PRISMIC_REPOSITORY and PRISMIC_WRITE_API_TOKEN.
Security: PRISMIC_UPLOAD_ROOT must be set; upload paths must resolve
within that directory (traversal and symlink escapes are blocked).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | ||
| notes | No | ||
| credits | No | ||
| alt | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- prismic_content_mcp/server.py:421-439 (handler)The handler function that performs the media upload logic by calling the service.
async def handle_prismic_add_media( *, file_path: str, notes: str | None = None, credits: str | None = None, alt: str | None = None, service_factory: ServiceFactory = _build_service, ) -> dict[str, Any]: """Upload media to Prismic Asset API (`POST /assets`).""" async with service_factory() as service: media = await service.add_media( file_path=file_path, notes=notes, credits=credits, alt=alt, ) return {"media": media} - prismic_content_mcp/server.py:792-808 (registration)The MCP tool registration for 'prismic_add_media' which delegates the execution to the handler.
@server.tool(name="prismic_add_media") async def prismic_add_media( file_path: str, notes: str | None = None, credits: str | None = None, alt: str | None = None, ) -> dict[str, Any]: """Upload media via Prismic Asset API. Uploads `file_path` using `multipart/form-data` to `POST /assets`. Optional metadata maps to Asset API fields: `notes`, `credits`, `alt`. Requires `PRISMIC_REPOSITORY` and `PRISMIC_WRITE_API_TOKEN`. Security: `PRISMIC_UPLOAD_ROOT` must be set; upload paths must resolve within that directory (traversal and symlink escapes are blocked). """ return await handle_prismic_add_media(