MCP WordPress Server

Instructions

Implementation Reference

• src/tools/auth.ts:86-107 (handler)

  The handleTestAuth function implements the core logic of the wp_test_auth tool: pings the WordPress site, retrieves the current user, formats a success message with site, method, user, and roles details, or throws an error on failure.

  public async handleTestAuth(
    client: WordPressClient,
    params: Record<string, unknown>,
  ): Promise<Record<string, unknown>> {
    try {
      await client.ping();
      const user = await client.getCurrentUser();
      const siteConfig = client.config;
  
      const content =
        "✅ **Authentication successful!**\n\n" +
        `**Site:** ${siteConfig.baseUrl}\n` +
        `**Method:** ${siteConfig.auth.method}\n` +
        `**User:** ${user.name} (@${user.slug})\n` +
        `**Roles:** ${user.roles?.join(", ") || "N/A"}\n\n` +
        "Your WordPress connection is working properly.";
  
      return { content };
    } catch (_error) {
      throw new Error(`Authentication test failed: ${getErrorMessage(_error)}`);
    }
  }

• src/tools/auth.ts:29-40 (registration)

  The tool definition object in AuthTools.getTools() that registers wp_test_auth with its name, detailed description, empty parameters (site added dynamically), and binds the handler.

    name: "wp_test_auth",
    description:
      "Tests the authentication and connectivity for a configured WordPress site with detailed connection diagnostics.\n\n" +
      "**Usage Examples:**\n" +
      "• Test connection: `wp_test_auth`\n" +
      '• Multi-site test: `wp_test_auth --site="my-site"`\n' +
      "• Verify setup: Use this after configuring new credentials\n" +
      "• Troubleshoot: Run when experiencing connection issues\n" +
      "• Health check: Regular verification of WordPress connectivity",
    parameters: [], // The 'site' parameter is added dynamically by the server
    handler: this.handleTestAuth.bind(this),
  },

• src/tools/auth.ts:29-40 (schema)

  Tool schema definition including name, description, and parameters array (empty, as 'site' parameter is dynamically added by ToolRegistry).

    name: "wp_test_auth",
    description:
      "Tests the authentication and connectivity for a configured WordPress site with detailed connection diagnostics.\n\n" +
      "**Usage Examples:**\n" +
      "• Test connection: `wp_test_auth`\n" +
      '• Multi-site test: `wp_test_auth --site="my-site"`\n' +
      "• Verify setup: Use this after configuring new credentials\n" +
      "• Troubleshoot: Run when experiencing connection issues\n" +
      "• Health check: Regular verification of WordPress connectivity",
    parameters: [], // The 'site' parameter is added dynamically by the server
    handler: this.handleTestAuth.bind(this),
  },