forg-mcp

FORG MCP server — published on npm as forg-mcp for automatic AI session tracking across official FORG adapters.

Once connected, FORG automatically:

• Opens a session when your AI tool starts
• Tracks tool usage throughout the session
• Closes the session when your AI tool exits
• Displays everything on your FORG dashboard

Install

forg-mcp is normally installed for you automatically via the FORG CLI:

forg connect <tool>

Supported official adapters:

• claude-code
• cursor
• vscode
• windsurf
• jetbrains
• opencode
• neovim
• copilot
• continue
• codex
• gemini-cli
• aider
• zed
• warp
• roo
• cline
• powershell

Manual MCP config

If you need to wire it into another MCP-compatible tool manually, add this server entry:

{
  "command": "npx",
  "args": ["-y", "forg-mcp@latest"]
}

FORG-generated configs handle FORG_KEYSTORE=file:// automatically when a tool needs the file-backed keystore path.

How it works

• Session start → emitted automatically when the MCP server initializes
• Session end → emitted automatically when the AI tool disconnects
• Tool tracking → emitted as MCP-aware tools invoke FORG-managed actions
• Goal and attribution → attached to the current FORG device, session, and project context

Requirements

• Node.js ≥ 18
• FORG account at forg.pro
• forg CLI activated with a valid license token

License

See LICENSE — UpgradIQ, Inc.