Cursor

What you need

You need Cursor, Node.js 24 or newer, a WordPress site with FluentCart installed and active, an HTTPS store URL, and a WordPress user that can read the FluentCart data you need.

Create safe store access

Before creating its Application Password, create or use a dedicated, low-privilege WordPress account for FluentCart. That account's WordPress permissions decide what store data FluentCart MCP can read. Read-only mode prevents MCP writes, but it does not make returned customer or order data private from the selected AI client.

Sign in as that account and open Users → Profile. Create and copy an Application Password named FluentCart MCP. An Application Password is different from the normal WordPress login password: use the new value WordPress displays only for this connection.

The setup wizard needs these three fields:

Add the global server

Check that Node.js is current:

node --version

Install Node.js 24 or newer if needed, then run the setup wizard:

npx -y fluentcart-mcp setup

npx -y downloads FluentCart MCP on demand and does not install the package globally.

Open Settings → Cursor Settings → MCP → Add new global MCP server and add only this entry to the global mcp.json:

{
  "mcpServers": {
    "fluentcart": {
      "command": "npx",
      "args": ["-y", "fluentcart-mcp"]
    }
  }
}

If Cursor reports that the command cannot be found, run which npx on macOS or Linux, or where npx on Windows. On macOS or Linux, replace "npx" with the returned absolute path.

On Windows, do not paste a normal path with single backslashes into JSON. Double every backslash, as in this complete valid example:

{
  "mcpServers": {
    "fluentcart": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": ["-y", "fluentcart-mcp"]
    }
  }
}

The doubled backslashes are required by JSON. You can instead replace the backslashes in the where npx result with forward slashes, for example C:/Program Files/nodejs/npx.cmd.

Confirm it works

Save the file, check that fluentcart is enabled in Settings → MCP, then ask: Show me the FluentCart dashboard stats. The returned store data is the useful confirmation.

If it does not work

If Cursor reports command-not-found or rejects mcp.json, use the absolute npx path above, then follow the client-start stage. If the setup wizard rejects the URL or credentials, use the credential stage. If the server connects but cannot read store data, check the WordPress user's FluentCart permissions and use the store-connection stage.

Optional next steps

Continue with Usage or Advanced configuration.