Universal Context Package

An open specification for packaging work context for LLMs.

Never read 50 documents to understand one task again.

v0.1.0-draftApache 2.0JSON Schema 2020-12

The problem

LLMs don't know your work context. Retrieval finds similar text; it doesn't answer what is true now, what changed, why decisions were made, or whether you are even allowed to see it. UCP is the missing artifact: a verifiable, time-aware, permission-aware package of what a person or agent needs to know right now to act on a task.

MCP is the pipe. UCP is what flows through it.

Design principles

Provenance is mandatory

A claim without sources is schema-invalid. Sources carry content hashes.

Time is first-class

Claims have validity windows. Contradictions are represented, not merged.

Permission-aware

Packages declare their audience and attest that access control was enforced.

Token-budgeted

Salience defines deterministic truncation. The core survives any budget.

Get started

# Python
pip install pyucp        # import ucp

# TypeScript
npm install @ucp/core

# MCP server for Cursor / Claude Code
pip install ucp-mcp

import ucp

pkg = ucp.load("task.ucp.json")     # validate + parse
prompt = ucp.render(pkg, token_budget=1500)