Claude Code

Run Celavii's 83 tools inside Claude Code over the MCP stdio transport. Works in both the terminal CLI and the VS Code / JetBrains extension.

Recommended — install skill

Tell Claude Code to install Celavii itself. Paste this into any Claude Code session:

Read https://github.com/efraijo/celavii-toolkit and run the celavii-install skill.

Claude Code reads our README, finds the skills/celavii-install/ directory, asks for your API key once, edits ~/.claude/mcp_servers.json safely (with a backup), and runs verification — all without you touching JSON.

Manual install

Edit ~/.claude/mcp_servers.json (Windows: %APPDATA%\Claude\mcp_servers.json) and add a celavii entry:

{
  "mcpServers": {
    "celavii": {
      "command": "npx",
      "args": ["-y", "celavii-mcp@latest"],
      "env": {
        "CELAVII_API_KEY": "cvii_live_..."
      }
    }
  }
}

Replace cvii_live_... with the key you minted in Settings → API. Fully quit Claude Code (⌘Q / File → Quit) and reopen.

Verify

In a fresh Claude Code session:

/mcp

You should see celavii listed as connected with 83 tools. If it shows failed, the key wasn't accepted — see troubleshooting.

Reduce surface (optional)

Don't want all 83 tools? Filter the groups Claude Code sees with CELAVII_TOOLS:

{
  "mcpServers": {
    "celavii": {
      "command": "npx",
      "args": ["-y", "celavii-mcp@latest"],
      "env": {
        "CELAVII_API_KEY": "cvii_live_...",
        "CELAVII_TOOLS": "meta,profiles,analytics"
      }
    }
  }
}

Comma-separated list of group names. Valid: profiles, campaigns, lists, analytics, content, manage, knowledge, enhance, scrape, refine, jobs. (meta is always loaded.)

Updating

The @latest tag in npx -y celavii-mcp@latest pulls the newest published version on every cold start. To check what's installed right now:

npm view celavii-mcp version

Current registry version: 0.2.8. Release notes live in the changelog.

Browse all 83 tools at the MCP Tools Catalog.