Skip to main content

Model Context Protocol server for Touchstone: hallucination detection for LLM outputs without calling another LLM. Wraps the calibrated Verifier and the raw measurement orchestrator from the clarethium-touchstone reference implementation as MCP tools.

Project description

touchstone-mcp

Model Context Protocol server for Touchstone: hallucination detection for LLM outputs without calling another LLM.

touchstone-mcp exposes the calibrated Verifier and the raw measurement orchestrator from the clarethium-touchstone reference implementation as MCP tools. Any MCP host (Claude Desktop, Claude Code, Cursor, custom) can attach it as a stdio MCP server.

Install

pip install touchstone-mcp

fastmcp and clarethium-touchstone install transitively. The touchstone-mcp console script is registered automatically and runs on the stdio transport by default.

Host config

Drop this into your MCP host config:

{
  "mcpServers": {
    "touchstone": {
      "command": "touchstone-mcp"
    }
  }
}

For Claude Code: claude mcp add touchstone touchstone-mcp.

Tools exposed

  • verify — calibrated (text, source) hallucination probability with scope classification, signal breakdown, and span-level localization.
  • measure — raw multi-layer Touchstone output (all eleven Section 5 measurement layers).
  • assess_derivation_regime — Layer 11 standalone regime classifier.
  • list_modes — enumerate the four Verifier modes with their required inputs.

See the host wiring guide for full tool reference, scope semantics, and threshold guidance.

Programmatic use

from touchstone_mcp import build_server

server = build_server()
server.run()                 # stdio transport

Version pairing

touchstone-mcp depends on clarethium-touchstone>=0.2.0. The MCP server is a thin wrapper around the library's public surface; measurement semantics and calibration coefficients are defined and tested in the library, not here.

License

Apache-2.0. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

touchstone_mcp-0.1.1.tar.gz (21.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

touchstone_mcp-0.1.1-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

Details for the file touchstone_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: touchstone_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 21.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for touchstone_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 b214ff29fdce45843597468bc88d22c9966d06cd3f4654602cad7af0ac0e194d
MD5 e9b75c9771fe5cfc5f51333732eb5e4f
BLAKE2b-256 b576bf2eea6c468aa08a8a47521542ee0f8dedf86770fb61b2400db60c0f59a7

See more details on using hashes here.

File details

Details for the file touchstone_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: touchstone_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 12.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for touchstone_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f17bbc8460b876d420249bf096eee488304732a67dd999e95636fc070ee4f782
MD5 d84915cadd02a15c4335ac284cc8c560
BLAKE2b-256 8e446060f670d4e8fb9aa8ea000c80108555bfbc4cf1a54c4653aba361699e3a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page