wp_get_page_revisions
Retrieve revision history for a WordPress page to track changes, restore previous versions, or compare content updates.
Instructions
Retrieves revisions for a specific page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | No | The ID of the WordPress site to target (from mcp-wordpress.config.json). Required if multiple sites are configured. | |
| id | Yes | The ID of the page to get revisions for. |
Implementation Reference
- src/tools/pages.ts:224-240 (handler)The main handler function for the 'wp_get_page_revisions' tool. It extracts the page ID from parameters, fetches revisions using WordPressClient.getPageRevisions, formats a user-friendly list of revisions (author and modified date), or returns a no-revisions message. Handles errors gracefully.
public async handleGetPageRevisions(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> { const { id } = params as { id: number }; try { const revisions = await client.getPageRevisions(id); if (revisions.length === 0) { return `No revisions found for page ${id}.`; } const content = `Found ${revisions.length} revisions for page ${id}:\n\n` + revisions .map((r) => `- Revision by user ID ${r.author} at ${new Date(r.modified).toLocaleString()}`) .join("\n"); return content; } catch (_error) { throw new Error(`Failed to get page revisions: ${getErrorMessage(_error)}`); } } - src/tools/pages.ts:140-152 (registration)Tool registration within PageTools.getTools(). Defines the tool name, description, input parameters (page ID), and binds the handler function for MCP tool registry.
{ name: "wp_get_page_revisions", description: "Retrieves revisions for a specific page.", parameters: [ { name: "id", type: "number", required: true, description: "The ID of the page to get revisions for.", }, ], handler: this.handleGetPageRevisions.bind(this), }, - src/tools/pages.ts:140-152 (schema)Input schema definition for the tool, specifying the required 'id' parameter of type number with description.
{ name: "wp_get_page_revisions", description: "Retrieves revisions for a specific page.", parameters: [ { name: "id", type: "number", required: true, description: "The ID of the page to get revisions for.", }, ], handler: this.handleGetPageRevisions.bind(this), }, - src/client/operations/pages.ts:68-70 (helper)Core API helper method in PagesOperations that performs the actual HTTP GET request to WordPress REST API endpoint `/wp-json/wp/v2/pages/{id}/revisions` via the base client.
async getPageRevisions(id: number): Promise<WordPressPage[]> { return this.client.get<WordPressPage[]>(`pages/${id}/revisions`); }