MCP WordPress Server

Instructions

Implementation Reference

• src/tools/seo/SEOToolDefinitions.ts:358-383 (schema)

  Defines the Tool object for 'wp_seo_get_live_data' including name, description, and input schema requiring postId.
  export const getLiveSEODataTool: Tool = { name: "wp_seo_get_live_data", description: "Retrieve live SEO data from WordPress including plugin-specific metadata and configurations", inputSchema: { type: "object", properties: { postId: { type: "number", description: "WordPress post ID to get SEO data for", }, includeAnalysis: { type: "boolean", description: "Include SEO analysis of the live data", }, includeRecommendations: { type: "boolean", description: "Include optimization recommendations", }, site: { type: "string", description: "Site identifier for multi-site setups", }, }, required: ["postId"], }, };
• src/tools/seo/SEOTools.ts:379-391 (registration)

  Registers the handler mapping for 'wp_seo_get_live_data' to 'handleGetLiveSEOData' in the getHandlerForTool function, used by getTools() for MCP registration.
  const handlers: Record<string, unknown> = { wp_seo_analyze_content: handleAnalyzeContent, wp_seo_generate_metadata: handleGenerateMetadata, wp_seo_bulk_update_metadata: handleBulkUpdateMetadata, wp_seo_generate_schema: handleGenerateSchema, wp_seo_validate_schema: handleValidateSchema, wp_seo_suggest_internal_links: handleSuggestInternalLinks, wp_seo_site_audit: handlePerformSiteAudit, wp_seo_track_serp: handleTrackSERPPositions, wp_seo_keyword_research: handleKeywordResearch, wp_seo_test_integration: handleTestSEOIntegration, wp_seo_get_live_data: handleGetLiveSEOData, };
• src/tools/seo/SEOHandlers.ts:276-296 (handler)

  The registered MCP handler function that parses arguments and delegates to SEOTools instance's getLiveSEOData method.
  /** * Handle get live SEO data request */ export async function handleGetLiveSEOData(client: WordPressClient, args: Record<string, unknown>): Promise<unknown> { const logger = LoggerFactory.tool("wp_seo_get_live_data"); try { const seoTools = getSEOToolsInstance(); const params: SEOToolParams = { postId: args.postId as number, includeAnalysis: args.includeAnalysis as boolean, includeRecommendations: args.includeRecommendations as boolean, site: args.site as string, }; return await seoTools.getLiveSEOData(params); } catch (error) { logger.error("Failed to get live SEO data", { error, args }); throw error; } }
• src/tools/seo/SEOTools.ts:657-713 (handler)

  Core tool logic implementation that retrieves live SEO data from WordPress site using SEOWordPressClient, performs analysis, and structures the response with post details and statistics.
  /** * Get live SEO data for multiple posts */ async getLiveSEOData(params: SEOToolParams & { maxPosts?: number }): Promise<unknown> { const siteLogger = LoggerFactory.tool("wp_seo_get_live_data", params.site); return await siteLogger.time("Get live SEO data", async () => { try { const seoClient = await this.getSEOClient(params.site); // Get all posts with SEO data const postsWithSEO = await seoClient.getAllPostsWithSEO({ maxPosts: params.maxPosts || 20, includePages: true, }); // Analyze the SEO data const analysis = this.analyzeLiveSEOData(postsWithSEO); const result = { totalContent: postsWithSEO.length, contentWithSEO: postsWithSEO.filter((p) => p.seoData).length, analysis, posts: postsWithSEO.map((post) => ({ id: post.id, title: post.title?.rendered, type: post.type, url: post.link, seoData: post.seoData ? { hasTitle: !!post.seoData.title, hasDescription: !!post.seoData.description, hasFocusKeyword: !!post.seoData.focusKeyword, plugin: post.seoData.plugin, lastModified: post.seoData.lastModified, } : null, })), retrievedAt: new Date().toISOString(), }; siteLogger.info("Live SEO data retrieved", { totalContent: result.totalContent, withSEO: result.contentWithSEO, plugin: analysis.detectedPlugin, }); return result; } catch (_error) { handleToolError(_error, "get live SEO data", { site: params.site, maxPosts: params.maxPosts, }); throw _error; } }); }