Skip to content
UPG is in early alpha. The specification is still evolving and may change between versions.

Adopt

5 surfaces

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>/.mcp.json. user = ~/.claude.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 .mcp.json

upg mcp setup

Output


  ✓ MCP server configured in /Users/you/checkout/.mcp.json

    "unified-product-graph": {
        "command": "npx",
        "args": [
            "-y",
            "@unified-product-graph/mcp-server@latest"
        ]
    }

  Open Claude Code in this directory. The UPG tools will be available automatically.

Report MCP server config across project and user scopes

upg mcp status

Configure for your user, overwriting any existing entry

upg mcp setup --scope user --force

Related

upg install-skillsupg init