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

Adopt

5 surfaces

MCP Tools

Tool Reference

95 MCP tools for reading, writing, and traversing your product graph. Grouped by concern.

95Tools
9Groups

Context & Session

6

Graph overview, session state, product context, and digest tools.

get_graph_digestget_product_contextget_session_contextstartsubmit_feedback+1

Nodes

17

Create, read, update, delete, search, move, batch, and deduplicate nodes.

batch_create_nodesbatch_delete_nodesbatch_update_nodescreate_nodededuplicate_nodes+12

Edges

9

Create, read, delete, export, rename, and resolve edge types.

batch_create_edgesbatch_delete_edgesbatch_move_nodescreate_edgedelete_edge+4

Areas & Change Log

11

Areas, change log, and time-bounded change queries.

assign_product_to_areacreate_areacreate_portfoliodelete_areaget_area_context+6

Workspace & Portfolios

39

Workspace initialisation, product switching, portfolios, and cross-product edges.

aggregate_edge_propertiesattach_product_to_portfolioaudit_axis_overlapaudit_property_coveragebatch_create_cross_product_edges+34

Schema

1

Entity schemas, valid children, entity metadata, and type labels.

get_entity_schema

Spec Introspection

6

Spec introspection: approaches, playbooks, regions, domains, lenses, frameworks.

apply_frameworkget_catalog_entryget_import_recipeget_spec_versionlist_catalog+1

Cloud Sync

3

Push and pull graph state to/from the UPG cloud.

apply_pull_changesetget_sync_statepush_to_cloud

Validation

3

Validate the graph, detect anti-patterns, run structural health checks, and audit skill integrity.

get_anti_pattern_violations_forskill_auditvalidate_graph

Run it with your AI

See how the tools work together

The catalogue lists what each tool does. To see how they combine, paste this into an MCP client connected to your graph and let the agent run a real workflow end to end.

Show me how an AI agent actually uses the Unified Product Graph MCP tools together. Walk through a realistic workflow against my graph: create a persona, add the jobs it cares about, link them, then run a gap analysis. For each step, name the tool you would call and why, so I learn how the tools combine rather than just what each one does.