WordPress MCP Server

Instructions

Args:
    title: The title of the post.
    content: The content/body of the post (supports HTML and Gutenberg blocks).
    status: Post status - 'draft', 'publish', 'pending', 'private'. Default is 'draft'.
    excerpt: Optional excerpt/summary of the post.

Returns:
    Created post with id, title, status, date, and link.

Implementation Reference

• src/wordpress_mcp/server.py:119-139 (handler)

  Handler function for the 'wp_create_post' tool, including registration via @mcp.tool() decorator and input schema via type hints and docstring. Delegates to WordPressClient.create_post.

  @mcp.tool()
  def wp_create_post(
      title: str,
      content: str,
      status: str = "draft",
      excerpt: str | None = None,
  ) -> dict:
      """Create a new WordPress post.
  
      Args:
          title: The title of the post.
          content: The content/body of the post (supports HTML and Gutenberg blocks).
          status: Post status - 'draft', 'publish', 'pending', 'private'. Default is 'draft'.
          excerpt: Optional excerpt/summary of the post.
  
      Returns:
          Created post with id, title, status, date, and link.
      """
      client = get_client()
      return client.create_post(title=title, content=content, status=status, excerpt=excerpt)

• src/wordpress_mcp/client.py:199-223 (helper)

  Core helper method in WordPressClient that constructs the POST data and calls the WordPress REST API to create the post.

  def create_post(
      self,
      title: str,
      content: str,
      status: str = "draft",
      excerpt: str | None = None,
  ) -> dict:
      """Create a new post."""
      data = {
          "title": title,
          "content": content,
          "status": status,
      }
      if excerpt:
          data["excerpt"] = excerpt
  
      post = self._post("posts", data)
  
      return {
          "id": post["id"],
          "title": post["title"]["rendered"],
          "status": post["status"],
          "date": post["date"],
          "link": post["link"],
      }