wp_update_site_settings

Modify WordPress site settings including title, description, and timezone through the MCP WordPress Server to customize site configuration.

Instructions

Updates one or more general settings for a WordPress site.

Input Schema

TableJSON Schema

Name	Required	Description
`site`	No	The ID of the WordPress site to target (from mcp-wordpress.config.json). Required if multiple sites are configured.
`title`	No	The title of the site.
`description`	No	The tagline or description of the site.
`timezone`	No	A city in the same timezone, e.g., 'America/New_York'.

Implementation Reference

src/tools/site.ts:194-201 (handler)

The MCP tool handler function that receives parameters, calls WordPressClient.updateSiteSettings, and returns a formatted success message or throws an error.

public async handleUpdateSiteSettings(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
  try {
    const updatedSettings = await client.updateSiteSettings(params);
    return `✅ Site settings updated successfully. New title: ${updatedSettings.title}`;
  } catch (_error) {
    throw new Error(`Failed to update site settings: ${getErrorMessage(_error)}`);
  }
}

src/tools/site.ts:34-55 (registration)

Tool registration object within SiteTools.getTools() array, defining name, description, input parameters schema, and handler binding.

{
  name: "wp_update_site_settings",
  description: "Updates one or more general settings for a WordPress site.",
  parameters: [
    {
      name: "title",
      type: "string",
      description: "The title of the site.",
    },
    {
      name: "description",
      type: "string",
      description: "The tagline or description of the site.",
    },
    {
      name: "timezone",
      type: "string",
      description: "A city in the same timezone, e.g., 'America/New_York'.",
    },
  ],
  handler: this.handleUpdateSiteSettings.bind(this),
},

src/server/ToolRegistry.ts:47-62 (registration)

Dynamic registration of all tool classes (including SiteTools) by instantiating them, calling getTools(), and registering each tool with the MCP server.

Object.values(Tools).forEach((ToolClass) => {
  let toolInstance: { getTools(): unknown[] };

  // Cache and Performance tools need the clients map
  if (ToolClass.name === "CacheTools" || ToolClass.name === "PerformanceTools") {
    toolInstance = new ToolClass(this.wordpressClients);
  } else {
    toolInstance = new (ToolClass as new () => { getTools(): unknown[] })();
  }

  const tools = toolInstance.getTools();

  tools.forEach((tool: unknown) => {
    this.registerTool(tool as ToolDefinition);
  });
});

src/types/tools.ts:481-497 (schema)

TypeScript interface defining the structured input parameters for the wp_update_site_settings tool.

export interface UpdateSiteSettingsParams extends BaseToolParams {
  readonly title?: string;
  readonly description?: string;
  readonly url?: string;
  readonly email?: string;
  readonly timezone?: string;
  readonly date_format?: string;
  readonly time_format?: string;
  readonly start_of_week?: number;
  readonly language?: string;
  readonly use_smilies?: boolean;
  readonly default_category?: CategoryId;
  readonly default_post_format?: string;
  readonly posts_per_page?: number;
  readonly default_ping_status?: PingStatus;
  readonly default_comment_status?: CommentStatus;
}

src/client/operations/site.ts:39-41 (helper)
Core helper function in SiteOperations that performs the actual POST request to the WordPress REST API /settings endpoint to update site settings.
```
async updateSiteSettings(settings: Partial<WordPressSiteSettings>): Promise<WordPressSiteSettings> {
  return this.client.post<WordPressSiteSettings>("settings", settings);
}
```

MCP WordPress Server