Skip to main content
Glama
deenesjakoruzh
adigoel07

Tool of Truth

by adigoel07
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Tool of Truth

Cada llamada de herramienta, comprobada.

Centinela de verificación para el uso de herramientas por agentes de IA. Proxy MITM que intercepta todas las llamadas a herramientas MCP, detecta fabricaciones, realiza un seguimiento de costos, verifica resultados e infiere la satisfacción del usuario.

Características

Característica

Estado

Descripción

MITM Proxy

✅

Intercepta de forma transparente todas las llamadas a herramientas MCP

Detección de fabricaciones

✅

Análisis profundo de 7 señales: traza, similitud de documentos, tiempos, marcadores de posición, contradicciones

Puntuación de confianza

✅

Puntuación ponderada de 0 a 100 con tope de fabricación

Seguimiento de costes

✅

Coste por llamada para 8 proveedores

Conteo de tokens

✅

Tokens de entrada/salida por llamada

Verificación de resultados

✅

Compara el resultado de la herramienta con la solicitud original del usuario

Cumplimiento de habilidades

✅

Verifica el flujo de trabajo mediante manifiestos

Satisfacción del usuario

✅

Infiere la satisfacción a partir de los mensajes de seguimiento

Recibos

✅

Con hash SHA-256, JSON + legible por humanos

Almacenamiento local

✅

Archivos diarios JSONL + búsqueda indexada

Transparencia de herramientas

✅

Muestra lo que realmente hacen las herramientas posteriores

Related MCP server: openclaw-output-vetter-mcp

Inicio rápido

1. Instalar

npm install -g tooloftruth-mcp

2. Conectar (Opción A: Directa)

// Your agent's MCP config
{
  "tooloftruth": {
    "command": "tooloftruth-mcp"
  }
}

3. Conectar (Opción B: Proxy — modo MITM)

// Your agent's MCP config
{
  "tooloftruth": {
    "command": "tooloftruth-mcp"
  }
}
// ~/.tooloftruth/proxy.json
{
  "servers": {
    "firecrawl": { "command": "npx", "args": ["firecrawl-mcp"] },
    "github": { "command": "npx", "args": ["@modelcontextprotocol/server-github"] }
  }
}

4. Usar

You: Did you actually use firecrawl?
Agent: [calls tooloftruth_verify]
Agent: VERIFIED — firecrawl was called at 10:30:02, trust score 98/100, cost $0.03

You: How much did I spend on tools today?
Agent: [calls tooloftruth_cost]
Agent: Total: $0.47 across 12 tool calls

You: Was that result what I asked for?
Agent: [calls tooloftruth_outcome]
Agent: ALIGNED — tool result matches your request

You: That's wrong, try again
Agent: [calls tooloftruth_satisfaction]
Agent: User appears dissatisfied — result may be wrong

CLI

# Intercept and monitor non-MCP commands
tooloftruth -- gh api repos/user/repo

# One-shot status report (daemon health, receipts, cost, top tools)
tooloftruth status

Daemon

Un daemon de launchd vigila .tooloftruth/receipts/, agrega estadísticas diarias y alerta sobre fabricaciones.

# Install the daemon (macOS)
launchctl load ~/Library/LaunchAgents/com.tooloftruth.daemon.plist

Las estadísticas se escriben en .tooloftruth/stats/YYYY-MM-DD.json.

Escaneo de verdad

tooloftruth_truth_scan realiza una verificación web real de las afirmaciones: búsqueda en Bing (curl) → obtención con crawl4ai → extracción de evidencia → veredicto.

Herramientas MCP

Herramienta

Descripción

tooloftruth_verify

Verifica que se haya utilizado una herramienta específica

tooloftruth_check

Comprobación previa: ¿está la herramienta instalada/configurada?

tooloftruth_receipt

Generar/ver el recibo de verificación

tooloftruth_cost

Desglose de costes por herramienta

tooloftruth_history

Buscar recibos históricos

tooloftruth_truth

Informe de verdad completo de la sesión

tooloftruth_satisfaction

Inferir la satisfacción del usuario a partir del mensaje

tooloftruth_outcome

Verificar que el resultado coincide con la solicitud del usuario

tooloftruth_audit

Contrastar las afirmaciones del agente con las llamadas reales a herramientas

tooloftruth_conversation

Ver el registro de la conversación

tooloftruth_truth_scan

Investigación web + verificación de datos de una afirmación

Cómo funciona el proxy MITM

Agent ←→ Tool of Truth ←→ MCP Server (downstream)
              ↓
         Records everything
         Runs deep fabrication checks
         Verifies outcome alignment
         Infers satisfaction
         Generates receipts
         Returns result unchanged

Almacenamiento

Todos los datos permanecen en el directorio de inicio de tu máquina:

~/.tooloftruth/
├── config.json          ← settings
├── index.json           ← fast lookup index
├── proxy.json           ← downstream server config
├── receipts/
│   ├── 2026-08-17.jsonl ← today's calls
│   └── ...
├── conversations/
│   └── 2026-08-17.jsonl ← claim/action conversations
└── stats/               ← daemon aggregations
    ├── 2026-08-17.json
    └── ...

## Skill Manifests

Skills can attach verification manifests:

```json
{
  "skill": "last-30-days",
  "version": "2.1.0",
  "requires": {
    "github_mcp": {
      "tool": "get_repo_stats",
      "mustBeCalled": true
    }
  }
}

Desarrollo

git clone https://github.com/adigoel07/tooloftruth.git
cd tooloftruth
pnpm install
pnpm build
npx vitest run

Licencia

MIT — úsalo, haz un fork, constrúyelo sobre él.

Autor

Creado por adigoel07.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • SentinelGate by Sentinel-Gate

    SentinelGateofficial

    Sentinel-Gate
    A
    license
    Not graded
    quality
    A
    maintenance
    Open-source MCP proxy that enforces security policies, content scanning, and audit logging between AI agents and tool servers
    25
    AGPL 3.0

  • openclaw-output-vetter-mcp

    temurkhan13
    A
    license
    A
    quality
    B
    maintenance
    MCP server for verifying AI agent claims vs reality — single-transcript inline grounding-check that flags when an agent's response states facts not in the input context, when its code silently swallows exceptions and substitutes mock data, or when its multi-turn transcript contains contradictions or unverified completion claims. Sub-second, local, free, no API calls.
    4
    42 PyPI
    1
    MIT

  • MCP Trust Gateway

    a2a-settlement
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables trust, reputation, and economic accountability for MCP by proxying between clients and servers, enriching every tool invocation with trust evaluation, KYA tiers, spending limits, and delegation chains.
    MIT