# dev/page MCP v2

Endpoint: https://www.devpage.org/api/mcp

Use get_capabilities for the complete machine-readable catalog. Writes require an idempotencyKey. update_page also requires expectedCurrentVersion and expectedContentHash. Default search returns 25 metadata records, never full source.

## Tools

- get_capabilities: Read the compact dev/page MCP catalog and discovery references. Scopes: none.
- create_page: Create, summarize, and place a page in one call. Scopes: pages:write.
- get_page: Read page metadata or an explicitly requested bounded content range. Scopes: pages:read.
- search_pages: Search or list compact page metadata with an opaque cursor. Scopes: pages:read.
- update_page: Append an immutable guarded version using full source or one bounded patch. Scopes: pages:write.
- list_versions: List immutable version metadata, newest first, with a cursor. Scopes: pages:read.
- activate_version: Make an existing immutable version active with a current-version guard. Scopes: pages:write.
- organize_pages: Apply explicit guarded folder lifecycle and page assignments in one batch. Scopes: pages:write.
- set_page_trashed: Recoverably trash or restore a page. Scopes: pages:delete.

Per-tool documentation: https://www.devpage.org/docs/mcp/tools
Errors and recovery: https://www.devpage.org/docs/mcp/errors