Skip to main content
Glama
jdhart81

QuantaOptima

by jdhart81

QuantaOptima

Auditable AI Actions — cryptographic audit trails for AI agent workflows.

QuantaOptima authenticates explicitly logged AI agent action records. It ships as an MCP server that any LLM agent can call, and as a Python library that any MCP server developer can embed. Explicitly recorded actions are authenticated with HMAC-SHA256 and linked in a hash chain. Verification detects changes to authenticated record contents; it does not establish that an action occurred or that all actions were recorded.

pip install https://github.com/jdhart81/quantaoptima/releases/download/v0.4.0/quantaoptima-0.4.0-py3-none-any.whl

The package is distributed through GitHub Releases; it is not currently listed on PyPI.

Release status and migration

Version 0.4.0 is an alpha release. The MCP server now persists its audit chain under ~/.quantaoptima/audit (override with QUANTAOPTIMA_AUDIT_DIR). Back up both the database and its private audit key. Imported JSON is unverified until checked with that key; HTML itself is not cryptographic evidence.

Paid licenses now use Ed25519. Existing HMAC licenses must be reissued, and clients need the issuer's trusted public PEM. No production issuer key is bundled in this checkout. See operations and migration, release notes, and security limitations.

Related MCP server: agent-gate

Why This Exists

Agent tracing tools help developers inspect workflow activity. QuantaOptima provides a local integrity layer for explicitly recorded actions: authenticate records, check the stored chain, and export it for inspection.

A valid chain authenticates recorded contents under its key; it does not prove actor identity, real-world execution, or completeness. Detecting a removed suffix requires an independent checkpoint. See the security model.

The MCP server exposes these operations:

  • quantaoptima_log_action — Log any action with before/after state to the audit chain

  • quantaoptima_verify_chain — Verify the HMAC-SHA256 chain integrity

  • quantaoptima_export_chain — Export the full audit trail as JSON

  • quantaoptima_chain_status — View chain statistics and health

Plus a built-in quantum-inspired optimizer that demonstrates the audit chain in action:

  • quantaoptima_optimize — Run optimization with every step automatically audited

  • quantaoptima_explain — Human-readable explanation of what the optimizer did

  • quantaoptima_benchmark — Compare against scipy's classical methods [PRO]

  • quantaoptima_observe — Inspect entropy, interference, phase transitions [PRO]

  • quantaoptima_audit — Verify the optimizer's audit trail [PRO]

What Makes It Different

1. Every Action Is Tamper-Evident

Every logged action produces an HMAC-SHA256 signature chained to the previous action. Modifying signed contents makes chain verification fail. This authenticates recorded data; it does not prove actions occurred, authenticate actor names, or detect a deleted suffix without an independent checkpoint. See the security model.

2. Built for AI Agents (MCP-Native)

Ships as an MCP server. After installing the package and configuring a compatible client, an agent can explicitly log actions, verify the chain, and export records. Other agent actions are not automatically captured merely because this server is connected.

3. Works as a Library Too

Other MCP server developers can embed QuantaOptima's audit chain in their own tools:

from quantaoptima import AuditChain, auditable

chain = AuditChain(scope="my-mcp-server")

# Log actions explicitly
chain.log("query", {"question": "What's the revenue?"}, {"answer": "$4.2M", "source": "db"})
chain.log("decision", {"options": ["A", "B"]}, {"chosen": "A", "reason": "lower risk"})

# Or use the decorator to auto-audit any function
@auditable(chain, action_type="calculation")
def compute_risk(portfolio: dict) -> dict:
    return {"risk_score": 0.42}

result = compute_risk({"stocks": ["AAPL", "GOOG"]})

# Verify and export
assert chain.verify()
chain.export_json("audit_trail.json")

4. Built-In Optimizer Demo

The quantum-inspired optimizer shows the audit chain at work. Every optimization step is cryptographically signed, producing a complete provenance record from start to finish. The optimizer features:

  • Quantum-inspired Measurement-Collapse Pruner algorithm

  • Built-in interpretability: entropy trajectories, interference metrics, phase transitions

  • Six built-in benchmark objectives; convergence quality depends on the problem and budget

Quick Start

MCP Server (for Claude, GPT, or any MCP-compatible agent)

pip install https://github.com/jdhart81/quantaoptima/releases/download/v0.4.0/quantaoptima-0.4.0-py3-none-any.whl
quantaoptima-server

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "quantaoptima": {
      "command": "quantaoptima-server"
    }
  }
}

Then ask Claude:

  • "Log a decision to the audit chain: I chose option A because it had lower risk."

  • "Verify the audit chain and show me the status."

  • "Optimize the Rastrigin function in 10 dimensions, then verify the audit trail."

  • "Export the full audit chain to audit_trail.json."

Python Library (for MCP server developers)

from quantaoptima import AuditChain

# Create a chain for your server
chain = AuditChain(scope="my-server", actor="my-agent")

# Log any action
chain.log(
    action_type="api_call",
    state_before={"endpoint": "/users", "method": "GET"},
    state_after={"status": 200, "count": 42},
    metadata={"duration_ms": 150},
)

# Verify chain integrity
print(chain.verify())        # True
print(chain.summary())       # Stats and health
print(chain.verify_detailed())  # Per-block verification

# Export
chain.export_json("trail.json")

Decorator Pattern

from quantaoptima import AuditChain, auditable

chain = AuditChain(scope="data-pipeline")

@auditable(chain, action_type="transform")
def clean_data(raw: list) -> list:
    return [x for x in raw if x is not None]

@auditable(chain, action_type="analysis")
def compute_stats(data: list) -> dict:
    return {"mean": sum(data) / len(data), "count": len(data)}

# Both calls are automatically logged to the audit chain
clean = clean_data([1, None, 3, None, 5])
stats = compute_stats(clean)

assert chain.verify()
print(f"Audit trail: {len(chain)} blocks, verified")

Pricing

Community (Free)

Pro ($29/mo)

Enterprise

Audit Chain

Unlimited

Unlimited + analytics

Custom

Log Actions

Verify Chain

Export Chain

✓ + formats

✓ + custom

Optimizer Objectives

3

All 6

All + custom

Max Dimensions

10

100

Unlimited

Max Iterations

100

5,000

Unlimited

Benchmark vs scipy

Observability

Support

Community

Email

Priority + SLA

Install Free

Get Pro

Contact

Annual Pro: $199/year (save 43%)

How the Audit Chain Works

Action 1                    Action 2                    Action 3
┌─────────────────┐         ┌─────────────────┐         ┌─────────────────┐
│ action: "query"  │         │ action: "decide" │         │ action: "execute"│
│ before: {...}    │         │ before: {...}    │         │ before: {...}    │
│ after: {...}     │         │ after: {...}     │         │ after: {...}     │
│ sig: HMAC(       │──chain──│ sig: HMAC(       │──chain──│ sig: HMAC(       │
│   prev_sig +     │         │   prev_sig +     │         │   prev_sig +     │
│   data           │         │   data           │         │   data           │
│ )                │         │ )                │         │ )                │
└─────────────────┘         └─────────────────┘         └─────────────────┘

Each block's signature depends on the previous block's signature. Verification checks each block’s content signature, block number, and link to its predecessor. A content change fails verification. A key holder can re-sign history; completeness requires an independently retained checkpoint.

How the Optimizer Works

The built-in quantum-inspired optimizer runs a loop of four steps:

  1. Encode — Map population fitness to complex amplitudes via Boltzmann weighting

  2. Evolve — Apply three quantum-inspired operators: Rotation R(θ), Entanglement E(λ), Scrambling S(γ)

  3. Collapse — PCA-derived measurement basis + Born rule probabilities + entropy constraint = adaptive selection

  4. Audit — Every step is HMAC-SHA256 signed and hash-chained

Project Structure

quantaoptima/
├── audit.py           # Core: AuditChain, AuditBlock, @auditable decorator
├── core.py            # Quantum state encoder + evolution operators
├── mcp_algorithm.py   # Measurement-Collapse Pruner
├── optimizer.py       # Full optimizer orchestration
├── licensing.py       # Ed25519 license issuance and public-key verification
├── storage.py         # Durable SQLite audit chain and separate HMAC key
├── server.py          # MCP server (10 tools)

Patent Status

US Provisional Patent Application filed May 25, 2025. Covers:

  • Cryptographic audit trail for AI agent actions

  • Quantum-inspired optimization with measurement collapse

  • Entropy-constrained adaptive selection

  • Foundation model integration architecture

Citation

@software{hart2025quantaoptima,
  author = {Hart, Justin},
  title = {QuantaOptima: Auditable AI Actions},
  year = {2025},
  url = {https://github.com/jdhart81/quantaoptima}
}

License

Apache 2.0 — use it freely, including commercially. The patent covers the specific algorithm implementation; the Apache license grants you a patent license for use of this software.

Available Tools

10 tools
quantaoptima_auditA

[PRO] Verify the cryptographic audit trail from the last optimization.

Each step is HMAC-SHA256 signed and hash-chained. Any tampering invalidates subsequent signatures.

Requires Pro license. Get one at https://buy.stripe.com/8x24gze0edtu1FwgSUfYY04

Args: export_path: Optional file path to export audit JSON.

ParametersJSON Schema
NameRequiredDescriptionDefault
export_pathNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses HMAC-SHA256 hash-chaining, tamper-evident behavior ('any tampering invalidates subsequent signatures'), and the Pro license requirement, which is substantial behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose, then cryptographic detail, license, and args. The Stripe URL is lengthy but necessary for the license requirement; overall efficient and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Has an output schema, so return values need not be explained. The description covers purpose, behavior, prerequisites, and the sole parameter, though it omits sibling differentiation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0% with one parameter. The description explains export_path as an optional file path to export audit JSON, adding clear meaning beyond the schema's type-only definition.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb 'Verify' and resource 'cryptographic audit trail from the last optimization', but does not differentiate from the sibling quantaoptima_verify_chain. An agent can understand the purpose, though sibling ambiguity remains.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'from the last optimization' implies use after an optimization, and the Pro license requirement is a prerequisite. However, there is no explicit guidance on when to choose this over alternatives like verify_chain or chain_status.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_benchmarkA

[PRO] Compare QuantaOptima against classical optimizers on the same problem.

Runs QuantaOptima, Differential Evolution, and Dual Annealing with the same evaluation budget. Returns side-by-side comparison.

Requires Pro license. Get one at https://buy.stripe.com/8x24gze0edtu1FwgSUfYY04

Args: objective: Built-in function (sphere, rastrigin, rosenbrock, ackley, griewank, levy). dimensions: Problem dimensionality (2-50). max_evals: Total function evaluation budget (1000-50000).

ParametersJSON Schema
NameRequiredDescriptionDefault
max_evalsNo
objectiveNorastrigin
dimensionsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It does disclose genuine behavioral context: three specific optimizers are run, they share the same evaluation budget, and results are returned side-by-side, plus a Pro-license access requirement. However, it omits runtime cost, whether it is compute-heavy or long-running, and any rate or resource implications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and mechanism are front-loaded in the first three sentences, followed by a compact Args block. The embedded Stripe purchase URL is slightly promotional noise, but it is relevant to the stated Pro-license requirement, so little is wasted overall.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, and the description adequately covers purpose, mechanism, and all three parameters with ranges. The main gap is the absence of usage routing against siblings and any runtime/behavioral expectations for a multi-optimizer run.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate, and it largely does: objective enumerates the valid built-in functions (sphere, rastrigin, rosenbrock, ackley, griewank, levy), dimensions gives the 2-50 range, and max_evals gives the 1000-50000 budget range. This adds meaning the bare schema lacks, though defaults (rastrigin/10/5000) are not restated.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Compare QuantaOptima against classical optimizers on the same problem,' naming the exact algorithms (QuantaOptima, Differential Evolution, Dual Annealing) and the equal-budget constraint. This distinguishes it from the sibling quantaoptima_optimize, which presumably runs a single optimizer rather than a head-to-head comparison.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies a benchmarking use case and notes a Pro-license precondition, but never explicitly says when to choose this over quantaoptima_optimize or when a comparison is warranted. Usage is inferable from the word 'Compare' but not spelled out with exclusions or a named alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_chain_statusB

View audit chain statistics and health.

Shows the current state of the session's audit chain: how many actions are logged, verification status, action type breakdown, and actors.

Available on all tiers (Community, Pro, Enterprise).

Returns: JSON with chain statistics.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden. 'View' implies a read-only operation and it discloses the returned content and tier availability, but it never states there are no side effects, no auth requirements, or any pagination/rate-limit behavior. Adequate but with clear gaps for an unannotated tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded in the first sentence and the body is short and scannable. The trailing 'Returns: JSON with chain statistics' partly restates the opening line, a minor redundancy but not significant bloat.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value detail need not be spelled out; the description nonetheless summarizes the fields shown and notes tier availability. For a zero-argument read tool this is essentially complete, with only the missing sibling routing keeping it from a 5.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so there is nothing for the description to clarify beyond what the empty schema already shows. Baseline 4 applies for a no-arg tool.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (View) and resource (audit chain statistics and health) and enumerates what is shown: action count, verification status, action type breakdown, and actors. It is clearly not the same as verify_chain or export_chain, though it never explicitly names those siblings, so differentiation is inferable rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description says it is 'available on all tiers,' which is an availability note, not usage guidance. It gives no indication of when to call this versus quantaoptima_verify_chain, quantaoptima_status, or quantaoptima_audit, leaving the agent to guess from names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_explainB

Human-readable explanation of the last optimization run.

Describes what happened, how quantum operators contributed, and whether the result is likely optimal.

Available on all tiers (Community, Pro, Enterprise).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does disclose the shape of the explanation and that it concerns the most recent run. However it never states this is a read-only operation, nor the precondition that a prior optimization run must exist. Coverage is adequate but incomplete for an unannotated tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the one-line purpose, then two clarifying lines, with no filler prose. The tier-availability sentence is marginal but short and useful to some callers.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a parameterless read tool with a full output schema, the description supplies enough: it frames the content as a human-readable narrative about the last run. The missing precondition (a completed optimize run) is the only notable gap, and the output schema covers return details.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so there is no parameter semantics to explain; the baseline for a 0-param schema is 4. Nothing in the description misrepresents the argument surface.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb (explain) and resource (last optimization run) and enumerates what the explanation covers: what happened, how quantum operators contributed, and whether the result is likely optimal. This distinguishes it from siblings like optimize/benchmark/observe/audit, though it does not explicitly name an alternative.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to call this versus quantaoptima_audit, observe, or status, all of which could plausibly overlap. The only usage-adjacent statement is a tier availability note ('Available on all tiers'), which is licensing info, not invocation guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_export_chainA

Export the full audit chain as JSON or as an interactive HTML viewer.

The exported file contains every block with its HMAC-SHA256 signature, timestamps, before/after state, and chain linkage.

JSON exports can be independently verified by anyone with the HMAC key. HTML exports produce a self-contained interactive timeline that anyone can open in a browser — perfect for sharing with stakeholders, compliance officers, or collaborators.

Available on all tiers. Pro adds: advanced analytics and compliance reports.

Args: filepath: File path to save the export. If empty, returns data inline. For HTML format, use a .html extension (e.g., "audit_trail.html"). format: "json" (default) or "html" (interactive timeline viewer).

Returns: JSON with the exported chain data or confirmation of file save.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNojson
filepathNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations the description carries the full burden and does well: it discloses what the export contains (HMAC-SHA256 signatures, timestamps, before/after state, chain linkage), that JSON is independently verifiable with the HMAC key, that HTML is self-contained, and the tier availability. It omits permissions/rate-limit context, so not a full 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first line, followed by contents, verification modes, tier note, and structured Args/Returns. Mostly earns its length, though some stakeholder-oriented marketing phrasing and the Pro-tier aside are marginal filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return-value detail is not required, and the description still notes inline vs file-save behavior. Both parameters, contents, and verification paths are covered; only safety/permission context is thin, which is minor for an export operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so the description must compensate, and it largely does: it documents format's values and default, filepath's empty-string inline behavior, and the .html extension requirement. The only gap is not enumerating format values formally, but the semantics for an agent are complete.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (export) and resource (the full audit chain) plus the two output forms, so the action is unmistakable. It does not explicitly differentiate itself from siblings like verify_chain or chain_status, so it lands at clear-but-no-sibling-routing rather than a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied through benefit statements ('perfect for sharing with stakeholders, compliance officers, or collaborators') and the JSON-verification note, but there is no explicit when-to-use/when-not guidance and no named alternative tool for the adjacent tasks (verify, status). Adequate but leaves routing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_log_actionA

Log any action to the cryptographic audit chain.

Every logged action is HMAC-SHA256 signed and hash-chained to the previous action. Tampering with any entry invalidates the entire chain from that point forward.

Use this to make any AI agent workflow auditable:

  • Decisions and their reasoning

  • API calls and responses

  • File operations

  • Data transformations

  • Queries and answers

  • Tool invocations

Available on all tiers (Community, Pro, Enterprise).

Args: action_type: What happened (e.g., "query", "decision", "file_write", "api_call", "calculation", "approval"). state_before: JSON string of state/input before the action. state_after: JSON string of state/output after the action. metadata: JSON string of extra context (tags, parameters, etc.). actor: Who performed the action (default: "ai-agent").

Returns: JSON with block details including signature and chain position.

ParametersJSON Schema
NameRequiredDescriptionDefault
actorNoai-agent
metadataNo{}
action_typeYes
state_afterNo{}
state_beforeNo{}

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations are absent, so the description carries the full behavioral burden and does so well: it discloses the signing algorithm, the hash-chain linkage, tamper-evidence semantics (tampering invalidates the chain from that point forward), and tier availability. It omits failure modes, auth requirements, and whether logging is synchronous, but the core behavioral profile is unusually explicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the purpose and the security guarantee before the Args/Returns sections, and the two-sentence chain explanation earns its place. The six-item bullet list of loggable things is somewhat padded but functions as concrete usage examples.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need no further explanation, and the Args section covers every input. The remaining gap is workflow context – no prerequisites, auth model, or relationship to the sibling verify/export/status tools for a 5-param mutating tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate, and it does: each of the five parameters gets an explanation (action_type with concrete example values, state_before/state_after as JSON of input/output, metadata as extra tags/params, actor defaulting to "ai-agent"). This adds real meaning beyond the bare titles and types in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (log) and resource (action to the cryptographic audit chain), and the mechanism (HMAC-SHA256 signed, hash-chained) immediately tells the agent this is the write/append tool in a family that otherwise verifies, exports, and reports status. An agent can distinguish it from quantaoptima_verify_chain and quantaoptima_export_chain without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Use this to make any AI agent workflow auditable" plus an explicit enumeration of what to log (decisions, API calls, file operations, transformations, queries, tool invocations) gives clear context for when to reach for it. It stops short of naming alternatives or exclusions – nothing says when NOT to log, or how this relates to quantaoptima_audit/verify_chain in a workflow.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_observeA

[PRO] Inspect the optimization landscape from the last run.

Returns interpretability data: how the optimizer explored the search space, where entropy concentrated, which dimensions carried the most information, and how interference shaped the selection trajectory.

This is the AI safety / interpretability tool — it reveals what the black-box optimizer is "thinking" by exposing its quantum measurement structure.

Requires Pro license. Get one at https://buy.stripe.com/8x24gze0edtu1FwgSUfYY04

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden. It discloses the Pro-license gate (a real access constraint) and describes the interpretability payload, and 'Inspect'/'Returns' implies a read-only operation. It does not confirm read-only status, whether a prior run must exist and what happens if none does, or any rate/credit behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The opening line is front-loaded with the verb, resource, and scope, and the return-value summary is efficient. The middle 'AI safety / interpretability' paragraph is somewhat rhetorical ('what the black-box optimizer is thinking') but still informative, and the Stripe link is a minor promotional intrusion.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so the description need not enumerate return fields, and it helpfully still characterizes the data. With no parameters and a Pro gate disclosed, the main omission is routing relative to the explain/audit/status siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters (empty schema, 100% coverage), so per the baseline there is nothing for the description to compensate for. It correctly adds no spurious parameter guidance.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Inspect the optimization landscape from the last run', plus the returns ('how the optimizer explored the search space, where entropy concentrated...'). It is clearly distinct from mutation-oriented siblings like quantaoptima_optimize. However it never names or contrasts with the closest informational siblings (quantaoptima_explain, quantaoptima_audit), so a 4 rather than a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'from the last run' implies the tool is used after an optimization run, and the Pro-license note is stated. But there is no explicit statement of when to prefer this over quantaoptima_explain, quantaoptima_audit, or quantaoptima_status, and no when-not guidance. Usage is implied rather than specified.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_optimizeA

Run quantum-inspired optimization using the Measurement-Collapse Pruner.

Uses interference-enhanced selection to solve black-box optimization problems with built-in cryptographic auditing and interpretability telemetry.

Every optimization step is automatically logged to the audit chain.

FREE tier: sphere, rastrigin, rosenbrock | 10 dims | 100 iters PRO tier: all 6 objectives | 100 dims | 5000 iters

Args: objective: Built-in function name (sphere, rastrigin, rosenbrock, ackley, griewank, levy). The optimizer MAXIMIZES, so built-ins are negated. dimensions: Number of variables (2-100). bounds_low: Lower bound for all variables. bounds_high: Upper bound for all variables. max_iterations: Maximum iterations (10-5000). population_size: Candidate solutions per iteration (10-200). temperature: Boltzmann temperature. Higher = more exploration. seed: Random seed for reproducibility.

Returns: JSON with best_solution, best_fitness, quantum_metrics, and audit status.

ParametersJSON Schema
NameRequiredDescriptionDefault
seedNo
objectiveNosphere
bounds_lowNo
dimensionsNo
bounds_highNo
temperatureNo
max_iterationsNo
population_sizeNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full behavioral burden. It discloses that every step is logged to the audit chain, that built-ins are negated because the optimizer MAXIMIZES, and that cryptographic auditing/telemetry are included. It doesn't state runtime cost or whether tier limits cause errors vs. silent truncation, but the operational semantics are unusually well covered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the purpose, then tiers, then args, then returns. The tier block and Args list are efficient; the marketing phrasing ('interference-enhanced', 'quantum-inspired') is a bit redundant but short. Overall well-structured and skimmable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Output schema exists so return values are covered, yet the description still names the return fields (best_solution, best_fitness, quantum_metrics, audit status). With no annotations, param coverage filled by the description, and tier constraints explained, an agent has everything needed to invoke correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate, and it does: it documents all 8 parameters with valid ranges (dimensions 2-100, max_iterations 10-5000, population_size 10-200), objective names, MAXIMIZES/negation behavior, and temperature semantics (higher = more exploration). Ranges and semantics go beyond what the bare schema provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb-and-resource pair ('Run quantum-inspired optimization using the Measurement-Collapse Pruner' with interference-enhanced selection) plus an explicit scope of built-in objectives. The 'optimize' framing and audit-chain logging distinguish it from siblings like benchmark, observe, and explain.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clear context on when to use (black-box optimization with auditing) and a tier table indicating which objectives/dimensions/iters apply to FREE vs PRO. No explicit when-not-use guidance or named alternatives, but the tier constraints implicitly route the agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_statusB

Check your QuantaOptima license status and available features.

Shows current tier, limits, available tools, and upgrade options.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It indicates this is a read-only informational check (implied by 'status' and 'shows'), but doesn't explicitly state it's non-mutating or that it requires authentication. It does describe what is returned (tier, limits, available tools, upgrade options), which is helpful. However, an output schema exists, so explaining return values is redundant. The description could note whether this requires an active license or network call, but it's adequate for a simple status check.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences, front-loaded with the primary purpose and followed by a concise list of what's shown. Every sentence earns its place with no filler. It's appropriately sized for a simple status tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no parameters, and an existing output schema, the description covers the basics but misses some contextual details. It doesn't clarify how this differs from quantaoptima_chain_status, nor does it mention any prerequisites (e.g., authentication) or behavioral traits like rate limits or caching. For a status tool, it's minimally adequate but lacks the sibling differentiation that would make it complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so parameter semantics are not applicable. According to the rules, 0 params gives a baseline of 4. The description doesn't need to discuss parameters, and it doesn't.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb+resource combination: checking QuantaOptima license status and available features. It clearly describes what the tool does, and the second sentence adds what information is shown (tier, limits, tools, upgrades). However, it doesn't explicitly differentiate this status tool from the sibling quantaoptima_chain_status, which could confuse an agent about which 'status' to call.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit guidance about when to use this tool versus quantaoptima_chain_status or other status-related siblings. The description implies it's for checking license status, but doesn't say when an agent should invoke it (e.g., before attempting optimizations, after a failed call due to licensing). No exclusions or alternatives are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

quantaoptima_verify_chainA

Verify the cryptographic integrity of the audit chain.

Checks every HMAC-SHA256 signature and hash link. If any block has been tampered with, verification fails from that point forward.

Available on all tiers (Community, Pro, Enterprise).

Args: detailed: If true, return per-block verification results.

Returns: JSON with verification status and chain statistics.

ParametersJSON Schema
NameRequiredDescriptionDefault
detailedNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does reasonably well: it discloses the crypto mechanism, the all-or-nothing failure semantics ('verification fails from that point forward'), and tier availability. It stops short of stating whether the operation is read-only, what permissions it needs, or cost/latency traits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the core action and mechanism, then the failure behavior, then tier and args. The Args/Returns scaffolding is slightly verbose for a single parameter but every sentence still carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so the description need not explain the return payload in detail, and it points to it ('JSON with verification status and chain statistics'). For a one-parameter, no-annotation tool this is largely complete, missing only permission/read-only and cross-tool routing detail.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the schema alone leaves 'detailed' opaque; the description compensates by explaining 'If true, return per-block verification results.' That is the only parameter and it is now documented, so the gap is closed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('verify') and resource ('the cryptographic integrity of the audit chain'), and adds the mechanism (HMAC-SHA256 signatures and hash links). This lets an agent distinguish it from siblings like quantaoptima_chain_status and quantaoptima_export_chain without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the purpose — you run this to validate the chain — but there is no explicit when-to-use guidance, no mention of how it differs from quantaoptima_chain_status, and no note on prerequisites or when to prefer the 'detailed' mode. Adequate but leaves the routing decision to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 10 tool updatesv0.4.0
    • First observedquantaoptima_audit
    • First observedquantaoptima_benchmark
    • First observedquantaoptima_chain_status
    • First observedquantaoptima_explain
    • First observedquantaoptima_export_chain
    • First observedquantaoptima_log_action
    • First observedquantaoptima_observe
    • First observedquantaoptima_optimize
    • First observedquantaoptima_status
    • First observedquantaoptima_verify_chain

TDQS

A3.7/5.0

Scored across 10 tools

Disambiguation3/5

Most tools have distinct purposes, but there is real overlap between quantaoptima_verify_chain (verify chain integrity) and quantaoptima_audit (verify audit trail from last optimization), as well as between quantaoptima_chain_status and quantaoptima_status. Similarly, observe and explain both inspect the last run, which could cause misselection.

Naming Consistency4/5

All tools share the quantaoptima_ prefix and snake_case, which is predictable. There is minor mixing between verb_noun forms (log_action, verify_chain, export_chain, chain_status) and bare verbs (optimize, benchmark, observe, explain, audit, status), but it remains readable.

Tool Count5/5

10 tools is well within the ideal range and each earns its place, splitting cleanly between optimization (optimize, benchmark, observe, explain) and audit (log_action, verify_chain, export_chain, chain_status, audit) plus a license status check.

Completeness4/5

The optimization and audit lifecycles are well covered: run, compare, inspect, explain, log, verify, export, and report. Minor gaps exist around retrieving/listing past runs or re-inspecting older results, since observe/explain/audit only target the last run.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    An MCP server that enforces fail-closed deterministic checks, independent refute-first review, and tamper-evident hash-chained receipts for AI agent outputs before claiming completion.
    4
    3
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Tamper-evident audit logging for AI agents. Append-only, hash-chained, optionally Ed25519-signed log. The MCP server lets an agent keep and verify a record of what it actually did.
    7
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server providing immutable audit logging, policy enforcement, and compliance reporting for AI agent workflows, enabling regulatory compliance and chain integrity verification.
    MIT