list_posts | List posts (with draft/published status) from the content repo | collection? |
read_post | Read a post's content and frontmatter | slug, collection? |
create_post | Create a new post (allowlist-validated), commit it to the content repo | slug, html, title, date, draft?, tags?, collection? |
edit_post | Update content/frontmatter of an existing post (allowlist-validated), commit the change | slug, html?, title?, date?, draft?, tags?, collection? |
delete_post | Remove a post, commit the deletion | slug, collection? |
upload_image | Upload an image (base64-encoded) into an existing post's image directory and commit it to the content repo. Reference it in the post's HTML as <img src="<filename>" alt="...">, a bare filename — do not write <picture>/srcset/width/height, those are generated automatically at build time. | slug, filename, data, collection? |
create_branch | Start (or resume) the draft branch for a post. Fails if another draft is already checked out for this slug — see spec §5.4 "Per-post draft locking". | slug, collection? |
abandon_draft | Discard a post's draft branch without publishing, releasing the lock on it | slug, collection? |
diff | Show a post's draft-branch changes against main (or another ref) | slug, against?, collection? |
publish | Merge a post's draft branch into main, push, and trigger a rebuild. Mode (direct/pr) is set by the PUBLISH_MODE env var, not per-call. | slug, collection? |
preview | Push a post's draft branch to the content repo. No hosted preview URL in v1 — check out the branch and run the build locally to view it. | slug, collection? |
revalidate | Trigger a Cloudflare Pages rebuild via its deploy hook | (none) |
deploy_status | Read the most recent Cloudflare Pages deployment's real state — closes the loop publish/revalidate open, since a deploy hook accepting a POST doesn't prove the build actually succeeded | (none) |
rollback | Revert to a previous commit — pass slug to revert just that post, omit it to revert a whole commit repo-wide | commitHash, slug?, collection? |