Prismic Content MCP

Instructions

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()