BizXEngine

Setup BizXEngine Memory

This page contains step-by-step instructions for AI agents to set up BizXEngine's intelligent memory system. If you are an AI agent, follow the steps below. If you are a human, you can also follow these steps manually or just run npx @bizxengine/mcp in your terminal.

Prerequisites

1. Node.js 18+ installed on the system
2. A BizXEngine API key — get one free at app.bizxengine.com (no credit card required)
3. One of: Claude Code, Cursor, Windsurf, VS Code, OpenClaw, or any MCP-compatible client

Recommended

Option A: Automated Setup

Run the interactive installer. It auto-detects your IDE and configures everything.

$ npx @bizxengine/mcp

Or, for silent/non-interactive install (useful if you are an AI agent running this):

$ npx @bizxengine/mcp --install YOUR_API_KEY

Replace YOUR_API_KEY with the actual key from the user's BizXEngine dashboard.

Option B: Manual Setup

If the automated installer doesn't work, or you prefer manual configuration:

Step 1 — Get the API key

Ask the user for their BizXEngine API key. They can find it at app.bizxengine.com → Workspace → API Keys. If they don't have an account, direct them to sign up (free, no credit card).

Step 2 — Save the API key

Create the config directory and file:

$ mkdir -p ~/.bizxengine

$ echo '{"apiKey":"YOUR_API_KEY"}' > ~/.bizxengine/config.json

Step 3 — Configure MCP server

Add the following to your IDE's MCP configuration:

Claude Code — ~/.claude/settings.json or project .mcp.json

{
  "mcpServers": {
    "bizxengine": {
      "command": "npx",
      "args": ["-y", "@bizxengine/mcp"]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "bizxengine": {
      "command": "npx",
      "args": ["-y", "@bizxengine/mcp"]
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bizxengine": {
      "command": "npx",
      "args": ["-y", "@bizxengine/mcp"]
    }
  }
}

VS Code — .vscode/mcp.json in your project root

{
  "mcpServers": {
    "bizxengine": {
      "command": "npx",
      "args": ["-y", "@bizxengine/mcp"]
    }
  }
}

Step 4 — Verify

Restart your IDE, then test the connection by asking your AI:

"What is your BizXEngine status?"

The AI should use the brain.status tool and report a successful connection.

Available Tools After Setup

Once connected, the AI agent gets these MCP tools:

Tool	What it does
brain.remember	Save important information — auto-scored, deduplicated, categorized
brain.recall	Semantic search over memory — returns ranked, scored results
brain.answer	Reason across multiple memories to synthesize a direct answer
brain.health	Memory quality report — health score, total count, stale signals
brain.status	Live connection check — confirms the workspace is reachable

Quick Test

After setup, try these commands with your AI to confirm everything works:

"Remember that I prefer dark mode and Tailwind CSS."

"What do you know about my preferences?"

"Check your brain health."

For AI Agents: Report After Setup

After completing setup, report the following to the user:

1. Which IDE was configured
2. Where the config file was written
3. Whether brain.status returned a successful connection
4. Any errors encountered and how they were resolved

Need help? Contact us • Full API docs • npm package • Home