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. Run doctor/setup first, then attach the MCP server in your client.

1) Verify local setup

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

2) Configure 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>"
swift run agentglass license-activate --key AG-XXXX-XXXX

3) Start MCP server

swift run agentglass-mcp

4) Client config snippets

Claude Desktop

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

{
  "mcpServers": {
    "agentglass": {
      "command": "swift",
      "args": [
        "run",
        "--package-path",
        "/Users/you/Github/AgentGlass",
        "agentglass-mcp"
      ]
    }
  }
}

Cursor / Windsurf

Open MCP settings JSON, then paste/merge:

{
  "mcpServers": {
    "agentglass": {
      "command": "swift",
      "args": [
        "run",
        "--package-path",
        "/Users/you/Github/AgentGlass",
        "agentglass-mcp"
      ]
    }
  }
}

5) 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