chimeralang-mcp 0.3.2

ChimeraLang MCP Server — probabilistic types, consensus gates, and hallucination detection as Claude tools

chimeralang-mcp

Give Claude typed confidence, hallucination detection, and constraint enforcement — as native MCP tools.

ChimeraLang is a programming language built for AI cognition. This MCP server exposes its runtime as 38 tools Claude can call during any conversation — no Anthropic permission needed, works today with Claude Desktop and Claude Code.

---

Install

pip install chimeralang-mcp
# or
uvx chimeralang-mcp

---

Claude Desktop Setup

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "chimeralang": {
      "command": "uvx",
      "args": ["chimeralang-mcp"]
    }
  }
}

Or with pip-installed version:

{
  "mcpServers": {
    "chimeralang": {
      "command": "python",
      "args": ["-m", "chimeralang_mcp"]
    }
  }
}

Restart Claude Desktop — 38 ChimeraLang tools are now available.

---

Tools

The core language/runtime tools are executable and deterministic. Several of the higher-level reasoning, safety, and cognition helpers are lightweight local heuristics intended for planning, triage, and guardrails rather than authoritative verification.

Core Language

Tool	What it does
chimera_run	Execute a .chimera program string
chimera_typecheck	Static type-check a .chimera program without executing
chimera_prove	Execute + generate a Merkle-chain integrity proof

Confidence & Safety

Tool	What it does
chimera_confident	Assert a value meets >= 0.95 confidence threshold
chimera_explore	Wrap a value as exploratory (hallucination explicitly permitted)
chimera_gate	Collapse multiple candidates via consensus (majority / weighted_vote / highest_confidence)
chimera_constrain	Full constraint middleware on any tool result
chimera_detect	Hallucination detection across range, dictionary, semantic, cross-reference, temporal, and confidence-threshold strategies
chimera_safety_check	Validate content against a safety policy
chimera_ethical_eval	Evaluate an action against ethical principles

Reasoning & Cognition

Tool	What it does
chimera_plan_goals	Decompose a high-level goal into ordered sub-goals
chimera_causal	Build and query a causal graph (add_edge / query / paths / info)
chimera_deliberate	Heuristic multi-perspective deliberation with Jaccard similarity and divergence scoring
chimera_quantum_vote	Multi-agent consensus voting with contradiction detection
chimera_metacognize	Reflect on reasoning quality — computes ECE, overconfidence rate
chimera_self_model	Maintain a persistent self-model of agent capabilities
chimera_embodied	Embodied reasoning simulation
chimera_social	Social reasoning and perspective modelling
chimera_evolve	Run fitness-ranked candidate selection across generations
chimera_meta_learn	Record adaptation events and retrieve meta-learning stats
chimera_transfer_learn	Map concepts across source and target domains

Knowledge & Memory

Tool	What it does
chimera_world_model	Persistent in-session world model (key→value with confidence)
chimera_knowledge	In-session knowledge base (add / search / list)
chimera_memory	In-session memory store (store / recall by importance)

Token Budget, Cost & Workflow

Tool	What it does
chimera_compress	Compress text using abbreviation/shorthand strategies
chimera_optimize	Aggressive text cleanup and extraction passes for large text/code blobs
chimera_fracture	Full pipeline — optimize docs + compress messages + quality gate
chimera_score	Rank messages by importance for lossy compression decisions
chimera_budget	Report current token usage against a budget
chimera_cost_estimate	Deterministic cost estimate for any supported model
chimera_cost_track	Record before/after compression events to the session tracker
chimera_dashboard	Session-level cost intelligence summary
chimera_csm	Context Session Manager: optimize prompt, compress history, and propose a token budget
chimera_budget_lock	Lock and track an approved per-turn output budget
chimera_mode	Recommend a task-relevant subset of the tool inventory
chimera_batch	Execute multiple Chimera tools in a single MCP call
chimera_summarize	LLM-free extractive summarizer for long documents

Meta & Audit

Tool	What it does
chimera_audit	Session-level call log and confidence summary

---

What problem does this solve?

Claude's tool-use loop has no built-in mechanism for:

• Confidence gating — only proceed if confidence >= threshold
• Typed output contracts — this result must satisfy constraint X before going downstream
• Genuine consensus detection — is multi-path agreement real, or trivially identical?
• Hallucination signals — structured detection, not just "does it sound right"
• Trust propagation — confidence degrades through chained tool calls; nothing tracks it
• Causal reasoning — explicit cause→effect graphs with pathway queries
• Multi-perspective deliberation — structured disagreement scoring across viewpoints
• Cost intelligence — token tracking and compression throughout long sessions

ChimeraLang provides a practical constraint layer sitting between Claude and its tools. The language runtime is the strongest guarantee surface; the higher-level cognition and safety helpers are best treated as lightweight first-pass checks unless you pair them with stronger external evidence.

---

Example prompts

Gate a value before a critical action:

"Before you submit that form, use chimera_confident to verify you're >= 0.95 confident the data is correct."

Consensus across reasoning paths:

"Generate 3 different answers, then use chimera_quantum_vote to collapse to the most reliable one."

Hallucination scan on output:

"After you get that search result, run chimera_detect with semantic strategy to check for absolute-certainty markers."

Full constraint pipeline:

"Use chimera_constrain on that tool result with min_confidence 0.85 and detect_strategy semantic."

Integrity proof for audit:

"Run this reasoning with chimera_prove so we have a tamper-evident trace."

End-to-end reasoning pipeline:

"Work through 'Should AI be used in autonomous medical diagnosis?' using chimera_plan_goals → chimera_causal → chimera_deliberate → chimera_quantum_vote → chimera_safety_check → chimera_ethical_eval → chimera_prove → chimera_audit."

---

ChimeraLang Quick Reference

Variable Declaration

Both val and let are supported:

val answer = Confident("Paris", 0.97)
let hypothesis = Explore("maybe dark matter is...", 0.4)

Probabilistic Types

emit Confident("verified fact", 0.97)   // >= 0.95 required
emit Explore("hypothesis", 0.60)        // hallucination explicitly permitted

Assertions

assert Confident(0.78) > Confident(0.45)

Gate Declaration

gate verify(claim: Text) -> Converge<Text>
  branches: 3
  collapse: weighted_vote
  threshold: 0.80
  return claim
end

Logical Operators

Both keyword and symbolic forms are supported:

// keyword form
if a > 0.5 and b > 0.5
  emit Confident("both pass", 0.9)
end

// symbolic form (also valid)
if a > 0.5 && b > 0.5
  emit Confident("both pass", 0.9)
end

Hallucination Detection

detect temperature_check
  strategy: "range"
  on: temperature
  valid_range: [-50.0, 60.0]
  action: "flag"
end

If / Else

if confidence > 0.80
  emit Confident("high confidence result", 0.9)
else
  emit Explore("low confidence — needs review", 0.5)
end

For Loop

for item in items
  emit Explore(item, 0.6)
end

Match

match verdict
| "pass" => emit Confident("approved", 0.95)
| "fail" => emit Explore("rejected", 0.70)
| _      => emit Explore("unknown", 0.50)
end

---

Changelog

0.3.2

• Preserve structured JSON values through chimera_confident, chimera_explore, and chimera_constrain instead of stringifying them
• Fix multimodal message token estimation fallback so chimera_cost_estimate, chimera_budget, and chimera_csm do not undercount text-array content
• Make chimera_fracture stop dropping history once the budget is satisfied instead of over-pruning to the minimum message floor
• Fix chimera_mode full to report the real live tool inventory and align README documentation with the current 38-tool surface

0.2.7

• Fixed UnboundLocalError in chimera_cost_track caused by log variable shadowing the module-level logger in the chimera_audit handler
• Added let as a keyword alias for val in variable declarations
• Added && and || as lexer tokens (aliases for and / or)
• Expanded tool count to 33 in README

0.2.5

• Initial AGI component suite: causal reasoning, deliberation engine, quantum vote, safety layer, ethical reasoner
• Knowledge base, world model, session memory
• Cost tracking, budget management, dashboard
• Self-model and metacognition tools

---

Links

• ChimeraLang core: github.com/fernandogarzaaa/ChimeraLang
• OpenChimera: github.com/fernandogarzaaa/OpenChimera_v1

---

License

MIT © Fernando Garza