Novamira HQ in beta: all your WordPress sites, one connection for your AI. Get it free →

Getting started with Novamira

Novamira is the free and open source plugin that gives your AI full access to WordPress through MCP. It connects the client you already use, Claude, ChatGPT, Cursor, Codex, Gemini CLI or any other MCP-compatible client, straight to your site. Your AI can execute PHP, run WP-CLI commands, query the database and edit files, and everything it builds is native WordPress that stays yours even if you remove the plugin. This guide takes you from installation to your first connected conversation.

For development and staging environments only. Always keep backups.

What problem does it solve?

Without Novamira, asking an AI to help with WordPress means copying code back and forth between your AI client and your site. The AI cannot see your database, cannot test its own code, cannot inspect plugin behavior, and cannot iterate on solutions without your manual intervention at every step.

With Novamira, the AI connects directly to your WordPress installation through the standard Model Context Protocol (MCP). It can query the database, test code changes, inspect the results, and iterate, all within a single conversation. You stay in control: you review and approve each action before it runs.

How it works

Novamira builds on three open standards that are part of the WordPress ecosystem:

  1. WordPress Abilities API (WordPress 6.9 core) provides a standardized way to register executable capabilities in WordPress.
  2. MCP Adapter (official WordPress plugin, bundled with Novamira) bridges those capabilities to the MCP protocol so AI clients can discover and invoke them.
  3. Model Context Protocol (MCP) is the open standard that AI clients use to communicate with external tools.

Novamira registers nine abilities (tools) that together give AI agents comprehensive access to your WordPress site:

Ability What it does
Execute PHP Runs PHP code with the full WordPress environment: $wpdb, all functions, loaded plugins. 30-second time limit.
Read File Reads file contents from the server filesystem. Supports partial reads and binary files.
Write File Creates or overwrites files. PHP files are restricted to the sandbox directory.
Edit File Targeted string replacement in existing files, similar to how AI code editors work.
Delete File Deletes files or directories.
Disable File Temporarily disables a sandbox file without deleting it.
Enable File Re-enables a previously disabled sandbox file.
List Directory Lists directory contents with glob filtering and recursive traversal.
Create Upload Link Creates a temporary URL so the agent can upload plugins, themes, media, or other files directly to your site.

How to connect your AI client

Who is this for?

Novamira is designed for developers and technical professionals working on development or staging WordPress sites who want to give AI agents full programmatic access to their installation. You should be comfortable with PHP, WordPress internals, and the concept of AI-assisted development.

You choose the AI model, you provide the API key, you review the output. We provide the plugin.

Next steps