from @unified-product-graph/cli · Setup
upg mcp
Configure, inspect, and run the UPG MCP server.
Usage
upg mcp <setup|status|run> [options]Arguments
<subcommand>- setup (write the server entry), status (report config), or run (serve over stdio)
Options
setup --scope <user|project>- project = <cwd>/.claude/settings.json. user = ~/.claude/settings.json
setup --force- Overwrite an existing entry without prompting
setup --command <cmd>- Override the server command. Example: "node /path/to/index.js"
run -f, --file <path>- Path to a .upg file. Overrides auto-discovery
run -t, --title <title>- Title to mint when creating a blank .upg file
Examples
Write the UPG MCP server entry into .claude/settings.json
upg mcp setupOutput
✓ MCP server configured in /Users/you/checkout/.claude/settings.json
"unified-product-graph": {
"command": "npx",
"args": [
"@unified-product-graph/mcp",
"mcp",
"run"
]
}
Open Claude Code in this directory. The UPG tools will be available automatically.Report MCP server config across project and user scopes
upg mcp statusConfigure for your user, overwriting any existing entry
upg mcp setup --scope user --force