OVI Cards

Agents produce stories. Orchestrators need packets they can validate, route, budget, and inspect.

01 / RUN IT

Thirty seconds to falsifiable.

Install the same package described here. The repository includes the protocol, implementation, tests, examples, MCP server, and benchmark script.

PYPI / BASE PACKAGEOPEN PYPI ↗

pip install ovi-cards

MCP SUPPORTpip install ovi-cards[mcp]

02 / CONTRACT

BOUNDED BY DESIGN

A communication protocol, not a summarizer.

05card types

RESULT, ERROR, PLAN, PATCH, and NOTE cover the working lifecycle of an agent task.

15semantic checks

Hard requirements can fail a card; soft failures reduce its declared confidence.

O(1)bounded packet size

Key arrays and text fields have explicit limits, keeping orchestration context predictable.

03MCP tools

Create, validate, and verify cards from Cursor, Claude Desktop, or another MCP client.

03 / PUBLISHED BENCHMARK

69.5%

median token reduction

Reported across seventeen task-oriented samples. The published mean is 66.3%; the repository’s modeled 100-step orchestration scenario reports 88% savings.

REPOSITORYSource, tests, examples, protocolGitHub ↗

PACKAGEovi-cards 0.1.0PyPI ↗

CLAIM LEDGERSupported and partial claimsReceipts →