Skip to content

Marksab001/Agent2Wp

Repository files navigation

🤖 Agent2Wp - Connect AI agents to your WordPress

Agent2Wp links your WordPress site to AI tools like Claude and Cursor. It lets AI read and write content, manage files, and update your site settings. You keep full control while the agent handles repetitive tasks.

⚙️ Requirements

Ensure your computer has the following tools installed before you start:

  • A Windows 10 or 11 computer.
  • A WordPress site running on a local server or a live hosting provider.
  • Admin access to your WordPress dashboard.
  • The Claude Desktop app or the Cursor editor if you plan to use these specific AI tools.

🏗️ How it works

The Model Context Protocol (MCP) allows your AI tools to talk to your website safely. Agent2Wp acts as a bridge. It translates your instructions into actions that WordPress understands.

The plugin provides your AI tools with specific skills:

  • Post Management: Create, edit, and delete blog posts and pages.
  • File Access: Upload images or read assets from your media library.
  • Elementor Support: Interact with existing page layouts.
  • WP-CLI Integration: Run background commands for site maintenance.
  • WooCommerce Help: Manage basic shop data and product information.

📥 Getting the software

You must download the plugin file from the official source.

  1. Visit the Agent2Wp GitHub repository page.
  2. Locate the green button labeled Code.
  3. Click the arrow next to the button and select Download ZIP.
  4. Save the Agent2Wp-main.zip file to your computer.
  5. Do not unzip this file yet; WordPress handles the installation for you.

🛠️ Installing the plugin

Follow these steps to add Agent2Wp to your website:

  1. Log in to your WordPress dashboard.
  2. Navigate to the Plugins menu on the left side.
  3. Click the Add New button at the top of the screen.
  4. Click Upload Plugin.
  5. Select the Agent2Wp-main.zip file you downloaded earlier.
  6. Click Install Now.
  7. Once the installation completes, click Activate Plugin.

🔌 Connecting your AI agent

After activating the plugin, you must link it to your AI tool.

  1. Open your Claude Desktop or Cursor settings.
  2. Look for the MCP Configuration section.
  3. Add a new entry for Agent2Wp.
  4. Point the configuration to your site URL.
  5. Provide the API key generated by the plugin settings page inside your WordPress dashboard.
  6. Restart your AI application to load the new tools.

📝 Troubleshooting

If you run into issues, try these steps:

  • Connection Error: Verify that your site URL is correct and your server reaches the internet.
  • Permission Denied: Check if your WordPress user role has enough permissions to modify posts.
  • Plugin Missing: Ensure you uploaded the ZIP file specifically, not the individual folders inside it.
  • AI Not Responding: Ensure your AI software is updated to the latest version.

🔒 Security notes

Because this tool gives AI the power to change your site, keep these points in mind:

  • Only connect tools you trust.
  • Do not share your API keys with anyone.
  • Disable the plugin when you do not need active AI integration.
  • Always keep a backup of your WordPress database.

📋 Common tasks

You can now use natural language to tell your AI agent what to do:

  • "Create a draft post about our upcoming winter sale."
  • "Summarize the latest content in my media library."
  • "List all active plugins on the site."
  • "Update the layout of the homepage using Elementor."

🚀 Future updates

Updates happen frequently. To update the plugin, download the new ZIP file from the link, deactivate the current version in WordPress, delete it, and upload the new version. Your settings usually persist, but verify them after every update.

About

Connect AI agents to WordPress using the Model Context Protocol. Execute PHP, manage files, and control WP-CLI directly from your server without third-party proxies.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors