Skip to content
Unified Product GraphBeta
Get Started
Unified Product Graph

The open specification for product knowledge.
312 types. 36 domains.
MIT Licensed

Understand
The SpecBlog
Explore
Graph ExplorerEntitiesEdgesLifecyclesFrameworksPlaybooksApproaches
Adopt
MCP ServerSDKCLISkillsIntegrationsGitHub ↗
© 2026 Unified Product Graph · MIT License · Privacy · TermsBuilt by The Product Creator

Adopt

5 surfaces

Surfaces

MCP Server
SDK

Compare

1
MCP vs SDK vs CLI

Guides

8
Building a DocumentImplementing an AdapterValidationMigrationsDriving an LLMRendering UIsBootstrapping a GraphJSDoc Cascade

Cookbook

10
All recipesFind all nodes of a given typeWalk the graph: persona → jobs → featuresSearch the graph by title or descriptionCreate a node with an auto-parent edgeUpdate a node: status transition or partial patchValidate before persisting a batch writeGate CI on graph healthWrite a minimal adapter (Markdown vault → UPG)Feed a typed graph slice to Claude (RAG-style context)Wire UPGClient into a Claude agent (tool use)

Playground

1
Try the SDK

Client API

4
UPGClientclient.nodesclient.edgeshealth / search / verify

Core primitives

10
CatalogShapesRegistryGrammarPropertiesPresentationIntelligencePlaybooksApproachesRegions
CLI
Skills
Integrations

SDK · Cookbook

Recipes for everyday graph work

10 task-oriented snippets. Copy, paste, adjust. Each recipe is a single page: one canonical snippet, a brief explanation, a few variations, and links to related work.

Reading

Find all nodes of a given type

List every feature, persona, or any other typed node. Avoid the wrapped-return gotcha.

Read recipe →

Walk the graph: persona → jobs → features

Follow typed edges to assemble a multi-hop view in a few lines.

Read recipe →

Search the graph by title or description

Fuzzy match across every node. Cheap, returns ranked hits.

Read recipe →

Writing

Create a node with an auto-parent edge

Pass parent_id and you get both a node and the parent edge back in one call. Destructure the wrapped return shape.

Read recipe →

Update a node: status transition or partial patch

Shallow-merge a patch onto an existing node. Persists on every call.

Read recipe →

Maintaining

Validate before persisting a batch write

Wrap a bulk create in a verify-and-rollback pattern so a bad batch never lands on disk.

Read recipe →

Gate CI on graph health

Fail a pull request if the graph health score drops below a threshold. Two-file recipe: a script + a workflow.

Read recipe →

Importing

Write a minimal adapter (Markdown vault → UPG)

A ~30-line adapter shape: parse the source, map each entity, persist via UPGClient, verify at the end.

Read recipe →

AI integration

Feed a typed graph slice to Claude (RAG-style context)

Search for relevant nodes, pull a one-hop neighbourhood, build a typed context block, hand to Claude.

Read recipe →

Wire UPGClient into a Claude agent (tool use)

A runnable agent that can read AND write the graph. Each UPGClient method becomes a typed tool; Claude picks which to call in a loop.

Read recipe →