ChimeraLang MCP Server — probabilistic types, consensus gates, and hallucination detection as Claude tools
Project description
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 33 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 — 33 ChimeraLang tools are now available.
Tools
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_safety_check |
Validate content against a safety policy |
chimera_ethical_eval |
Evaluate an action against ethical principles |
Hallucination Detection
| Tool | What it does |
|---|---|
chimera_detect |
Hallucination detection — 5 strategies: range, dictionary, semantic, cross_reference, temporal |
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 |
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 |
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
| Tool | What it does |
|---|---|
chimera_compress |
Compress text using abbreviation/shorthand strategies |
chimera_optimize |
Aggressive text extraction (structural + entity + frequency) |
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 |
Meta & Audit
| Tool | What it does |
|---|---|
chimera_audit |
Session-level call log and confidence summary |
chimera_evolve |
Evolve and adapt reasoning strategies |
chimera_meta_learn |
Meta-learning across reasoning episodes |
chimera_transfer_learn |
Transfer learning across domains |
chimera_fracture |
Full compression pipeline with quality gate |
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 fills exactly these gaps as a constraint layer sitting between Claude and its tools.
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.2.6
- Fixed
UnboundLocalErrorinchimera_cost_trackcaused bylogvariable shadowing the module-level logger in thechimera_audithandler - Added
letas a keyword alias forvalin variable declarations - Added
&&and||as lexer tokens (aliases forand/or) - Expanded tool count to 33
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file chimeralang_mcp-0.2.7.tar.gz.
File metadata
- Download URL: chimeralang_mcp-0.2.7.tar.gz
- Upload date:
- Size: 68.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa089a9ba350c9d6cbbec200829807200d5200e65f5d166ed04b289f6df0c852
|
|
| MD5 |
b169482e5cda64266e55b92cb0abfef2
|
|
| BLAKE2b-256 |
23e9269d6975af629ff243d4ddfa55c15c55572c937806234937e962a03bbbca
|
Provenance
The following attestation bundles were made for chimeralang_mcp-0.2.7.tar.gz:
Publisher:
publish.yml on fernandogarzaaa/chimeralang-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
chimeralang_mcp-0.2.7.tar.gz -
Subject digest:
fa089a9ba350c9d6cbbec200829807200d5200e65f5d166ed04b289f6df0c852 - Sigstore transparency entry: 1368910201
- Sigstore integration time:
-
Permalink:
fernandogarzaaa/chimeralang-mcp@c58e4cb2eae1f12594395d47d16bab0cf468547d -
Branch / Tag:
refs/heads/main - Owner: https://github.com/fernandogarzaaa
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c58e4cb2eae1f12594395d47d16bab0cf468547d -
Trigger Event:
push
-
Statement type:
File details
Details for the file chimeralang_mcp-0.2.7-py3-none-any.whl.
File metadata
- Download URL: chimeralang_mcp-0.2.7-py3-none-any.whl
- Upload date:
- Size: 66.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b25b5118c677751e33cb48cfc58df3802258a0e240beaa77c7bba3ee54a0597a
|
|
| MD5 |
e30cee8fe0acab456656c76c0ecd411d
|
|
| BLAKE2b-256 |
fa706fe7ff68f58d3b05ec32da54c33840ab1a498fd24fa3ee9ceb8a4dc312ee
|
Provenance
The following attestation bundles were made for chimeralang_mcp-0.2.7-py3-none-any.whl:
Publisher:
publish.yml on fernandogarzaaa/chimeralang-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
chimeralang_mcp-0.2.7-py3-none-any.whl -
Subject digest:
b25b5118c677751e33cb48cfc58df3802258a0e240beaa77c7bba3ee54a0597a - Sigstore transparency entry: 1368910367
- Sigstore integration time:
-
Permalink:
fernandogarzaaa/chimeralang-mcp@c58e4cb2eae1f12594395d47d16bab0cf468547d -
Branch / Tag:
refs/heads/main - Owner: https://github.com/fernandogarzaaa
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c58e4cb2eae1f12594395d47d16bab0cf468547d -
Trigger Event:
push
-
Statement type: