touchstone project (touchstone-mcp)
Copyright 2026 Lovro Lucic

Published under Clarethium (https://github.com/Clarethium).

This product includes software developed by Lovro Lucic.

Components
----------

This repository builds one PyPI distribution, touchstone-mcp,
Apache-2.0 licensed. It contains two components:

- **clarethium_touchstone** (src/clarethium_touchstone/):
  the reference Python implementation of the Touchstone Standard.
  Eleven measurement layers (structural profile, claim density,
  temporal instability, source matching, entity provenance,
  vocabulary proximity, presentation features, epistemic
  calibration, information novelty, quality profile, grounding
  decomposition) implemented as regex, structural analysis, source
  matching, and arithmetic. The calibrated Verifier composes the
  substrate signals into a hallucination probability with scope
  classification and span-level localization.

- **touchstone_mcp** (src/touchstone_mcp.py): the Model Context
  Protocol server that wraps the Verifier and the raw measurement
  orchestrator as MCP tools (verify, measure,
  assess_derivation_regime, list_modes) for MCP-compatible AI
  clients (Claude Desktop, Claude Code, Cursor). Adds fastmcp; no
  measurement logic of its own.

Licensing
---------

Code in this repository is licensed under Apache 2.0; see LICENSE
at repository root. The Touchstone Standard text under STANDARDS/
is licensed CC-BY 4.0 and is not part of the PyPI distribution.

External works referenced
-------------------------

Touchstone Standard (STANDARDS/touchstone-1.0.md) is licensed
CC-BY 4.0. touchstone-mcp does not bundle the Standard text in its
PyPI wheel; the Standard is the canonical specification and is
referenced by URL.

The fastmcp runtime that touchstone-mcp depends on is published
separately at https://github.com/jlowin/fastmcp and is not
redistributed by this project.

Companion projects in the Clarethium body
-----------------------------------------

- Lodestone: canonical methodology (CC-BY 4.0)
  https://github.com/Clarethium/lodestone
- cma: executable compound practice loop (Apache 2.0)
  https://github.com/Clarethium/cma
- frame-check: applied vehicle, sibling MCP using Touchstone
  https://github.com/Clarethium/frame-check

Sibling-MCP pattern conformance
-------------------------------

touchstone-mcp's license-expression metadata shape and
tag-prefixed release discipline (touchstone-mcp-vX.Y.Z) follow the
conventions established by cma-mcp and frame-check-mcp.
