prismic_get_refs
Retrieve repository version pointers like master or preview refs from Prismic Content API. Use these refs with document reading tools to access specific content versions efficiently.
Instructions
Get repository refs from Content API root.
Refs are repository-level version pointers (for example master,
preview, or release refs), not per-document refs.
Use returned ref values with prismic_get_documents or
prismic_get_document to read content for that version pointer.
Efficiency tip: call once, cache the chosen ref, and pass it explicitly
to subsequent read calls to avoid per-call implicit master-ref resolution.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- prismic_content_mcp/server.py:174-183 (handler)The core logic function for prismic_get_refs, which uses a service to fetch refs and returns them in a dict.
async def handle_prismic_get_refs( *, service_factory: ServiceFactory = _build_service, ) -> dict[str, Any]: """Return repository-level refs from Prismic Content API root (`/api/v2`).""" async with service_factory() as service: refs = await service.get_refs() return {"refs": refs} - prismic_content_mcp/server.py:548-560 (registration)The MCP tool decorator registration for prismic_get_refs.
@server.tool(name="prismic_get_refs") async def prismic_get_refs() -> dict[str, Any]: """Get repository refs from Content API root. Refs are repository-level version pointers (for example `master`, preview, or release refs), not per-document refs. Use returned `ref` values with `prismic_get_documents` or `prismic_get_document` to read content for that version pointer. Efficiency tip: call once, cache the chosen `ref`, and pass it explicitly to subsequent read calls to avoid per-call implicit master-ref resolution. """ return await handle_prismic_get_refs()