Procurement Graph

A dependency graph of strategic sourcing artifacts and analyses, exposed as an MCP server.

This is an open specification I publish through Canonical Agency. It generalizes patterns from procurement and spend-intelligence engagements at two enterprises under NDA.

What it models

The strategic sourcing process is usually drawn as a linear set of phases. I find that framing brittle. Phases describe when work happens; they do not describe what depends on what. The same spend cube feeds the diagnostic, the category strategy, and the ongoing performance dashboard. The same supplier scorecard depends on baseline metrics captured during onboarding. Treating these as a graph (nodes plus edges) makes it possible to ask the questions that actually matter on an engagement:

• What deliverables are blocked by missing inputs?
• If raw spend changes, what gets invalidated?
• Given my entity-profile data, which analyses can I run today?
• What is the build order to produce a category strategy?

Phases (0 through 6) remain in the spec as a navigational frame. They are not the structural spine.

Phase model

Seven phases, zero through six, anchoring the program from opening diagnostic through ongoing performance management.

Phase 0  Opportunity Assessment & Business Case
Phase 1  Spend Analysis & Category Segmentation
Phase 2  Supply Market Research
Phase 3  Strategy Development
Phase 4  Sourcing Execution (RFx + Negotiation)
Phase 5  Implementation & Supplier Transition
Phase 6  Performance Management & Benefits Tracking

Layer model

Every node lives in one of five layers. Layers describe what kind of work a node is, independent of which phase it belongs to.

Layer 1  Truth and facts          (raw data, supplier master, contracts)
Layer 2  Analytical assets        (spend cube, should-cost, risk scores)
Layer 3  Decision artifacts       (category strategy, negotiation strategy)
Layer 4  Execution artifacts      (RFx packages, contracts, transition plans)
Layer 5  Proof and control        (benefits tracking, scorecards, compliance)

Tools (v0.4)

Navigation and catalog:

Graph traversal:

Install (local / editable)

cd /Users/fbaig/Projects/procurement-graph
uv sync
uv run procurement-graph

Validate the content corpus

procurement-graph validate runs the integrity checks the test suite enforces (edge consistency, acyclicity, example linkage, phase continuity) as a standalone CLI. Useful for content editors to verify their work before committing.

uv run procurement-graph validate

Claude Desktop config

{
  "mcpServers": {
    "procurement-graph": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/fbaig/Projects/procurement-graph",
        "run",
        "procurement-graph"
      ]
    }
  }
}

Repository layout

content/
├── phases/         seven phase descriptions
├── analyses/       Layer 2 analyses from the procurement analytics catalog
├── deliverables/   Layer 3-5 deliverables from the phase-by-phase taxonomy
├── horizontal/     cross-phase artifacts (governance, RAID, benefits tracker)
├── engagement/     shared fictional engagement (TechnoFlex PSA resin)
└── examples/       15 filled-in artifact examples anchored to the TechnoFlex engagement

src/procurement_graph/
├── __main__.py     entrypoint dispatching to MCP server or validate CLI
├── server.py       FastMCP app and tool registrations (16 tools)
├── loaders.py      cached file readers
├── parsing.py      YAML frontmatter and markdown body parsing
├── models.py       pydantic node, phase, and example models
├── graph.py        dependency-graph traversal (BFS, topo sort, feasibility)
└── validate.py     standalone content-integrity checks

The methodology content lives in content/ as markdown with YAML frontmatter, so the source of truth is editable without touching the server code.

License

Apache-2.0.