AgentGlass logo AgentGlass
Back to Landing
MCP Quickstart

Connect AgentGlass in 2 minutes.

Use this page for copy-paste setup with Claude Desktop, Cursor, and Windsurf. Start with the installer from the downloaded release zip, then attach the MCP server in your client.

0) Download AgentGlass

  • Use the Download AgentGlass button from the billing success page.
  • If you closed that page, reuse your direct download URL (from PRODUCT_DOWNLOAD_URL).
  • Public release artifact name: agentglass-mcp-macos-<version>.zip.

1) Fast install from downloaded zip

From the extracted release folder, run:

./install-agentglass-mcp.command
  • Installs agentglass and agentglass-mcp to ~/.local/bin
  • Removes quarantine from the release folder
  • Writes mcp-config-snippet.json for copy-paste client setup

2) Verify local setup

agentglass doctor
agentglass setup --boot-first-available
agentglass license-status

3) Optional: override license + telemetry endpoints

export AGENTGLASS_LICENSE_VERIFY_URL="https://license-api.example.com/v1/license/verify"
export AGENTGLASS_LICENSE_PUBLIC_KEY_BASE64="<ed25519-public-key-base64>"
export AGENTGLASS_TELEMETRY_URL="https://license-api.example.com/v1/telemetry/events"
export AGENTGLASS_TELEMETRY_WRITE_KEY="<optional-write-key>"
agentglass license-activate --key AG-XXXX-XXXX

4) Start MCP server

agentglass-mcp

5) Client config snippets

If you ran the installer, you can paste the generated mcp-config-snippet.json directly.

Claude Desktop

Config path: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "agentglass": {
      "command": "/Users/you/.local/bin/agentglass-mcp",
      "args": []
    }
  }
}

Cursor / Windsurf

Open MCP settings JSON, then paste/merge:

{
  "mcpServers": {
    "agentglass": {
      "command": "/Users/you/.local/bin/agentglass-mcp",
      "args": []
    }
  }
}

6) Validate connection

  • Call tools/list
  • Call tools/call with name: health_check
  • Call tools/call with name: list_simulators
  • If a call fails, inspect structuredContent.error.code and structuredContent.error.contractVersion