NextPress documentation

MCP tools reference

Every tool, prompt and resource the NextPress MCP server offers, grouped by the job they do, with the permission each group needs.

On this page

An agent connected through the MCP server sees these tools and picks which to call. Every call uses the server's API key, so each tool needs the matching permission.

Edit a page or post

Each tool works on one saved page, or on a blog post when content_type is "post".

ToolWhat it does
get_page_outlineLists the page's blocks with their IDs, without full content
get_page_blockReads one block. id is the page, block_id the block
change_page_blocksAdds, changes, moves or removes blocks, then saves and checks the page. Refused when the page changed since it was read
check_pageChecks the page for problems
apply_page_phone_fixesApplies the fixes for phone layout warnings that have a clear fix

Blocks and design

ToolWhat it does
list_block_typesLists block types and when to use each
get_block_typeShows one block type's fields, with an example
get_design_guideReturns the page design guide

Pages, posts and blogs

ToolWhat it does
list_pages, get_pageList pages, or read one page by UUID or slug with all its blocks
create_pageCreate a page. It is a draft unless told otherwise
update_pageChange title, slug, status, or replace all blocks. Needs expectedVersion
publish_pagePublish a page
list_posts, get_postList posts, or read one
create_post, update_postCreate a draft post, or change it. Updates need expectedVersion
publish_postPublish a post
list_blogs, get_blog, create_blogList blogs, read one, or create one

Previews and history

ToolWhat it does
preview_page, preview_postCreate a link that shows a draft without signing in. Lasts 3600 seconds unless a shorter expiresInSeconds is given. The most is 3600
get_page_historyList a page's earlier saved versions
restore_page_versionPut an earlier version back. The replaced version stays in the history

Version history exists for pages only, and only the SDK and MCP server can restore it. The admin has no screen for it.

Templates, themes and site

ToolWhat it does
list_template_partsList the site's templates, with how many pages use each
create_template_partCreate a template
get_template_part_usageList the pages that show a template
list_templates, get_templateList or read pre-designed blocks
list_themes, get_themeList or read themes
create_theme, update_themeCreate or change a theme
activate_themeMake a theme the site's active theme
get_site_contextRead the site's branding, active theme, settings and health

Media and forms

ToolWhat it does
list_mediaList the media library, up to 100 items per call
upload_mediaUpload a file from a local path, or from base64 with a filename
copy_brand_logoSave a brand logo from svgl.app, such as https://svgl.app/library/github.svg, into the media library
list_form_submissionsRead the answers sent through the site's forms. Read only

Docs

list_docs, create_docs, get_docs_tree, update_docs_settings, add_docs_page, update_docs_page, delete_docs_page, reorder_docs_pages and get_docs_guide work with documentation sites built in NextPress. They use the page permissions.

Older tools

build_blocks, validate_blocks, patch_page_blocks and patch_post_blocks still work. New work should use change_page_blocks.

Prompts

PromptArgumentsWhat it starts
build_pagepurpose, audience (both optional)Building a page from a draft to a preview link
edit_blockid, block_id, requestChanging one block and nothing else
write_docstopic, audience (optional)Writing documentation pages

Resources

AddressWhat it holds
nextpress://blocks/catalogBlock names with a note on when to use each
nextpress://blocks/schemaThe shape of block data
nextpress://design-guideThe page design guide
nextpress://site/mapPages and posts: address, title and status
nextpress://site/contextBranding, theme, settings and health

When a tool is refused

The reply always gives the reason. Common ones are a missing permission on the key, a page that changed since it was read, or a block that is not allowed in that place.

Next steps