Setup Guide

Install GEM² in 30 seconds

One command. Auto-detects your AI tools. No API keys needed — OAuth handles authentication on first use.

Auto-install

The install script detects which AI tools you have, installs a self-healing launcher, and registers GEM² MCP servers in each tool. Your existing configs are backed up before any changes.

Option 1 — npx (recommended)

npx @gem_squared/setup

Option 2 — curl

curl -sSL https://user-mgmt.gemsquared.ai/setup/install | bash

Option 3 — GitHub (inspect before running)

bash <(curl -sSL https://raw.githubusercontent.com/gem-squared/gem2-setup/main/install.sh)

View source on GitHub →

Requires jq (auto-installed via Homebrew/apt if missing) and Node.js ≥ 20 for Claude Desktop and Cursor.

What the installer does

Checks dependencies

Installs jq if missing (via Homebrew, apt, or dnf).

Detects AI tools

Scans for Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code + Continue.

Installs GEM² launcher

For Claude Desktop and Cursor only. The launcher at ~/.gem2/launcher.sh finds Node ≥ 20 from nvm/fnm/Homebrew/system on every MCP start. Self-heals if you update Node.

Registers MCP server

Adds gem2-tpmn entry to each tool's config file. Existing configs are backed up before modification.

After install

Step 1

Run the install command

One command detects your AI tools, installs the launcher, and registers GEM² MCP servers.

Step 2

Restart your AI tool

Close and reopen Claude Code, Cursor, or whichever tool you use.

Step 3

Authenticate on first use

Your browser opens for GEM² login. Enter your LLM API key once — it's encrypted and never stored on our servers.

Step 4

Start verifying

Ask your AI tool: "Check this content for overclaims" — GEM² handles the rest.

Supported AI tools

The installer auto-detects these tools and configures each one.

Claude Code

Streamable HTTP

Claude Desktop

stdio + launcher

Cursor

stdio + launcher

Windsurf

Streamable HTTP

VS Code + Continue

Streamable HTTP

What gets modified

The script adds the TPMN Checker MCP server to each tool's config. A timestamped backup is created before any changes.

Tool	Config file
Claude Code	~/.claude/settings.json
Claude Desktop	claude_desktop_config.json
Cursor	~/.cursor/mcp.json
Windsurf	mcp_config.json
VS Code + Continue	~/.continue/config.json

// Added to your tool's config (existing entries preserved)
"mcpServers": {
  "gem2-tpmn": { "url": "https://mcp-tpmn-checker.gemsquared.ai/mcp" }
}

Claude Code, Windsurf, and Continue use the url format (streamable HTTP). Claude Desktop and Cursor use the GEM² launcher with mcp-remote as a stdio bridge.

Platform support

Auto-installer v1.1.0



macOS

Supported

Intel and Apple Silicon. Auto-installs jq via Homebrew if missing.

🐧

Linux

Supported

Ubuntu, Debian, Fedora, and other distributions. Auto-installs jq via apt or dnf.

💻

Windows

Coming soon

Not yet supported. Windows users can configure manually by editing tool config files directly.

Privacy & security

No secrets stored

The installer only writes MCP server URLs to config files. No API keys, tokens, or credentials are stored locally.

Encrypted API keys

LLM API keys are entered via OAuth consent in the browser, encrypted (AES-256-GCM), and embedded in your session token. Never stored on GEM² servers.

Auto-backup

Every config file is backed up with a timestamp before modification. Uninstall restores your original state.

Open source

Review the script before running: curl -sSL https://user-mgmt.gemsquared.ai/setup/install | less

Requirements

✓macOS or Linux

✓bash shell

✓curl or wget

✓jq (auto-installed if missing)

✓Node.js ≥ 20 — only for Claude Desktop and Cursor (the launcher auto-detects from nvm, fnm, Homebrew, or system PATH)

Manual install

Prefer to configure manually? Add the MCP server URL to your tool's config file directly.

Claude Code

Edit ~/.claude/settings.json and add the mcpServers block shown above.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or ~/.config/Claude/claude_desktop_config.json (Linux). Requires mcp-remote via npx (Node ≥ 20).

Cursor

Edit ~/.cursor/mcp.json. Requires mcp-remote via npx (Node ≥ 20).

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json.

VS Code + Continue

Edit ~/.continue/config.json.

Uninstall

Removes GEM² MCP entries from all tool configs and the~/.gem2/ launcher. Does not touch any other MCP entries or user data.

npx @gem_squared/setup uninstall

curl -sSL https://user-mgmt.gemsquared.ai/setup/uninstall | bash

Ready to verify AI outputs?

Start with 300 free credits. Need more? Get early access pricing before GA.

View pricing Learn about TPMN Checker