WordPress MCP Server

This is a Model Context Protocol (MCP) server designed to interact with WordPress websites. It exposes two primary tools: discover_endpoints and perform_action, allowing AI models to discover WordPress REST API endpoints and perform actions on the website.

Features

• discover_endpoints: Fetches all available REST API endpoints from a configured WordPress site.
• perform_action: Allows performing GET, POST, PUT, and DELETE requests on discovered WordPress REST API endpoints.
• Authentication: Uses Basic Authentication with a WordPress username and application password.

Setup

To use this MCP server, you need to configure it within your MCP client application (like Claude Desktop or Kilo Code). The client will run the server for you.

Here is an example configuration:

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": [
        "-y",
        "@tinkergrove/wordpress-mcp-server"
      ],
      "env": {
        "WEBSITE_URL": "https://your-wordpress-site.com",
        "USERNAME": "your_username",
        "APP_PASSWORD": "your_app_password"
      }
  }
}

Configuration Details

• command: Should be npx.
• args: Handling the package.
• env:
  • WEBSITE_URL: The full URL to your WordPress site (e.g., https://example.com).
  • USERNAME: Your WordPress username.
  • APP_PASSWORD: An application password generated from your WordPress user profile. You can create one by navigating to Users > Profile in your WordPress admin, scrolling down to "Application Passwords", and generating a new one.

Tools

discover_endpoints

• Description: Discovers all available REST API endpoints from the configured WordPress site.
• Parameters: None
• Returns: A JSON object containing the discovered endpoints, specifications, and requirements.

perform_action

• Description: Performs an action on a WordPress REST API endpoint.
• Parameters:
  • route (string, required): The REST API route to interact with (e.g., /wp/v2/posts).
  • method (enum, required): The HTTP method to use (GET, POST, PUT, DELETE).
  • body (object, optional): The request body for POST or PUT requests.
• Returns: A JSON object containing the response from the WordPress API.

Contributing

Feel free to contribute to this project by opening issues or submitting pull requests.