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;
      }
    });
  }