English Français العربية

Mobius MCP

Community Other

Build WordPress sites on the Sweipe or FlatMobile themes: import demos, build a site from a brief, review it, rewrite page copy and change settings.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mobius-mcp
  2. Setup
  3. Tools
  4. The REST surface behind it
  5. Development

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

ToolWhat it doesCredits
sweipe_statusTheme, plugin, licence, AI state, where the site plan stands0
sweipe_list_demos / sweipe_import_demo / sweipe_import_statusThe demo packages and a waiting import0
sweipe_ai_pingService check + credit balance0
sweipe_ai_libraryTemplates a site can be planned from0
sweipe_ai_planBrief → plan (pages and sections)1
sweipe_ai_get_planThe stored plan0
sweipe_ai_buildPlan → pages with copy and photos, imported4
sweipe_ai_reviewRender, inspect, screenshot, judge; corrected plan5 (fix: 2, free when clean)
sweipe_site_from_briefPlan, build, review, rebuild, fix in one call~12
sweipe_brief_pages / sweipe_brief_generate / sweipe_brief_apply / sweipe_brief_undoRewrite the copy of existing pages, with backups1 per page
sweipe_brief_pickWhich demos fit a brief0
sweipe_ai_set_enabledAI features on/off0
wp_get_settings / wp_update_settings / wp_list_pagesCore title, tagline, timezone, language, front page0

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

Frequently asked questions

What is Mobius MCP?

Build WordPress sites on the Sweipe or FlatMobile themes: import demos, build a site from a brief, review it, rewrite page copy and change settings.

How do I install Mobius MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Mobius MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Mobius MCP?

It is published by tcgunel. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.