Metadata-Version: 2.4
Name: vivary-mcp
Version: 0.1.3
Summary: Optional read-only MCP adapter for governed Vivary context.
Author: Jeff Kazzee
License-Expression: MIT
Project-URL: Homepage, https://vivary.vercel.app/
Project-URL: Documentation, https://vivary.vercel.app/
Project-URL: Repository, https://github.com/vivary-dev/vivary
Project-URL: Issues, https://github.com/vivary-dev/vivary/issues
Project-URL: Changelog, https://github.com/vivary-dev/vivary/blob/dev/CHANGELOG.md
Keywords: agents,context,mcp,vivary
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: vivary-tropo>=0.5.3
Requires-Dist: mcp==2.0.0
Dynamic: license-file

# vivary-mcp

Optional Python 3.11+ read-only MCP adapter for Vivary context.

- Protocol: `2026-07-28`
- SDK: exact `mcp==2.0.0`
- Transport: local standard input/output only
- Tools: `vivary_find`, `vivary_query`, `vivary_check`, `vivary_capsule`
- Authority: operator-bound local roots; no writes, network calls, providers, or
  caller-directed processes
- Status: development source candidate `0.1.3`, unpublished, disabled by default,
  external conformance unproven; requires `vivary-tropo>=0.5.3`.
  Source: [`pyproject.toml`](pyproject.toml); verified: 2026-08-13.

The read-only ceiling belongs to MCP, not to the whole Vivary workspace lifecycle.
The adapter may return a complete public capsule envelope. Save that complete object:
an id or fingerprint alone is not sufficient. An explicitly human-approved,
exact-plan-hash `create-vivary record --capsule <path>` transaction can then create or
update exactly one earned typed record outside MCP. MCP startup and calls never
materialize records or packs.

See the canonical [MCP adapter guide](../../docs/MCP.md) for installation, tool
schemas, privacy boundaries, diagnostics, and verification.
