Skip to content

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 setup

Output


  ✓ 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 status

Configure for your user, overwriting any existing entry

upg mcp setup --scope user --force

Related

upg install-skillsupg init