Documentation

Bifrost is a free WordPress plugin that turns your site into an MCP server (Model Context Protocol). Once installed, AI assistants like Claude, ChatGPT, Gemini, or Cursor can read your pages, run audits, suggest improvements — and with your permission, write content, build Elementor pages, edit products, run WP-CLI commands, and more.

Think of it as: your site becomes one of the apps your AI talks to, exactly like Slack or Gmail.

MCP (Model Context Protocol) is an open standard, originally from Anthropic, for how AI agents talk to external tools and data. Instead of writing a custom API integration for every AI model, you expose your data once as an MCP server, and any MCP client (Claude, Cursor, future ChatGPT, etc.) can use it.

For WordPress, this means: install Bifrost once, and your site works with every current and future AI agent that supports MCP.

Free: AI can read and analyze. Run Site Health and SEO audits. Read-only by default. 1 connected site. Forever free.

Pro: Everything Free does, plus AI writes — it builds Elementor pages from a description, creates custom plugins, edits WooCommerce products, runs sandboxed PHP. Up to 5 sites. Skills marketplace. Auto-rollback if a write breaks the site. From 79 RON / month.

See pricing for full plan details.

1. Create a free Miradoes account (30 seconds — email + password).
2. You're auto-redirected to download Bifrost Free (~90 KB).
3. In WordPress wp-admin: Plugins → Add New → Upload Plugin → choose the .zip → Install Now → Activate.
4. A new "Miradoes" menu appears in your wp-admin sidebar. Click it, then "Sign in with Miradoes".
5. Approve the OAuth dialog. Done — your site is linked.

Full walkthrough on the install page.

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

{
  "mcpServers": {
    "my-wp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-site.com/wp-json/wpab/v1/mcp"]
    }
  }
}

Replace your-site.com with your actual WordPress domain. Then restart Claude Desktop. You should see a tools icon (🔌) showing connection to your site.

ChatGPT supports MCP via Custom GPTs. Create a new Custom GPT, go to Actions → Import OpenAPI specification → use your Bifrost endpoint URL with OAuth authentication. Detailed walkthrough is coming soon. For now, Claude Desktop and Cursor are the smoothest experience.

Bifrost 2.0.1 has four layers of WSOD protection:

1. Read-only by default. AI can't write anything until you flip "Allow raw PHP" in settings.
2. Syntax validation before write — broken PHP is refused without touching disk.
3. Pre-write health check — site is probed; if already degraded, write is refused.
4. Auto-rollback — after every PHP write, site is probed again. If unreachable, the previous version is restored from automatic backup and opcache invalidated. You typically never notice the crash.

Plus self-protection: AI can never modify Bifrost itself — so even in worst case you can disable it from wp-admin.

In /account → "Manage subscription". You'll be redirected to Stripe Customer Portal where you can cancel with one click. Cancellation takes effect at the end of your current billing period — you keep Pro access until that date.

14-day money-back guarantee on all paid plans (Monthly, Annual, Lifetime). Email support@miradoes.com with subject "Refund [your email]" and we process within 24 business hours. Money returns to the original card in 5–10 business days. See refund policy for details.

• "OAuth failed" — your Miradoes session expired. Sign in again on miradoes.com, then retry from wp-admin.
• "Connection refused" in Claude — install mcp-remote globally: npm install -g mcp-remote, then restart Claude Desktop.
• "License invalid" / Pro features grayed out — wp-admin → Miradoes → Account → Re-sync license.
• "503 Service Unavailable" from /api/v1/download/free — temporary, our zip cache is rebuilding. Try again in 1 minute.
• Anything else — email support@miradoes.com. We typically reply within 4 business hours.