Mobius MCP

mobius-mcp

The Mobius Studio MCP server for Sweipe and FlatMobile sites. On npm as mobius-studio-mcp.

An MCP server that lets an AI agent (Claude Code, Claude Desktop, Cursor, any MCP client) set up a WordPress site running the Sweipe or FlatMobile theme: import a demo, plan and build a site from a one-paragraph brief, rewrite the copy of existing pages, review the result, change core settings.

It talks to the theme plugin's sweipe/v1/agent REST surface (Companion 1.2.1+) with a WordPress Application Password. The AI itself runs on the theme's service and is paid for by the site's licence in monthly credits; no API key is needed anywhere.

Setup

1. On the site, as an administrator: Users → Profile → Application Passwords, add one named mcp, copy the password.
2. Make sure the theme licence is activated (Sweipe → License) and AI is on (Sweipe → AI).
3. Add the server to your client.

Claude Code:

claude mcp add sweipe -e SWEIPE_SITE_URL=https://example.com -e SWEIPE_USER=admin -e SWEIPE_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" -- npx -y mobius-studio-mcp

Claude Desktop / Cursor (mcpServers entry):

{
  "sweipe": {
    "command": "npx",
    "args": ["-y", "mobius-studio-mcp"],
    "env": {
      "SWEIPE_SITE_URL": "https://example.com",
      "SWEIPE_USER": "admin",
      "SWEIPE_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
    }
  }
}

Application Passwords need HTTPS; on a local http:// site add add_filter( 'wp_is_application_passwords_available', '__return_true' ); to a must-use plugin.

Works for FlatMobile sites too: the server reads the site's REST index and picks sweipe/v1 or flatmobile/v1 on its own (SWEIPE_NAMESPACE overrides).

Optional: SWEIPE_IMPORT_BUDGET (seconds the server spends per import step, default 25, max 55; lower it if your host kills long requests).

Tools

SKILL.md is a plain-English skill file for agents: when to use which tool, what to check first, what to ask the owner before spending credits.

The REST surface behind it

Everything the server does is a call to https://example.com/wp-json/sweipe/v1/agent/… with Basic auth; the routes are listed at the top of the plugin's plugin/Services/Ai/AgentApi.php. Any script can use them directly:

curl -u 'admin:xxxx xxxx xxxx xxxx xxxx xxxx' https://example.com/wp-json/sweipe/v1/agent/status
curl -u '…' -H 'Content-Type: application/json' -d '{"brief":"…","language":"English"}' https://example.com/wp-json/sweipe/v1/agent/ai/plan

Development

npm install
npm run build
SWEIPE_SITE_URL=http://localhost:8081 SWEIPE_USER=admin SWEIPE_APP_PASSWORD=… node dist/index.js

MIT © Mobius Studio