Skip to main content
Glama

Quesen Deterministic Agent Decision Layer

Server Details

Deterministic decision layer for autonomous agents. Reproducible PROCEED, REVIEW, SKIP verdicts.

Ownership verified
Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
Shxnque/quesen
GitHub Stars
0

Available Tools

5 tools
quesen.healthAInspect

Liveness probe. Returns engine_version and transport.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations provided, the description carries the behavioral disclosure burden. It communicates that this is a lightweight health check and names the expected return fields, implying a safe read-only probe. It does not discuss auth or rate limits, but the probe semantics make significant hidden behavior unlikely.

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 phrases, front-loading the operation type and immediately stating the return values. Every word earns its place with no repetition or filler.

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?

The tool takes no inputs, so no parameter guidance is needed. It names the return fields ('engine_version and transport'), and since there is no output schema, this gives the agent sufficient information about what to expect. Nothing essential is missing.

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 input schema has zero parameters and the schema description coverage is 100%, so the description does not need to explain parameters. This matches the baseline of 4 for no-parameter tools.

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 identifies the tool as a 'Liveness probe' and specifies what it returns ('engine_version and transport'), making its purpose clear and differentiating it from report/simulate/validate/version siblings. It lacks an explicit verb+resource construction but the health-probe framing is unambiguous.

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?

The phrase 'Liveness probe' provides clear context for when to use this tool: checking that the service is alive. It does not explicitly mention alternatives or exclusions, but the purpose is distinct enough that an agent can infer appropriate usage.

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

quesen.reportAInspect

Post-decision outcome feedback. Accepts request_id + outcome (RUG/LOSS/OK/WIN/UNKNOWN) plus optional post-trade metadata. Aggregated deterministically for SKIP-rate vs realized-outcome correlation.

ParametersJSON Schema
NameRequiredDescriptionDefault
notesNoOptional free-text notes about the outcome (post-mortem, context, references). Stored verbatim for audit.
venueNoVenue or platform where the trade/signal was executed (e.g. 'raydium', 'jupiter', 'uniswap-v3'). Free-form label for downstream grouping.
outcomeYesReal-world outcome once known. RUG = rug-pull / total loss; LOSS = negative PnL; OK = neutral / no material result; WIN = positive PnL; UNKNOWN = outcome not yet observable.
request_idYesThe `request_id` returned by a prior quesen.validate call. Ties the reported outcome back to the exact decision that produced it.
signal_hashNoOptional hash/fingerprint of the original signal (URL, token address, message id) so outcomes can be joined across systems that don't share Quesen request_ids.
realized_pnlNoRealized profit/loss in the caller's chosen unit (e.g. USD, SOL, ETH). Sign convention: positive = profit, negative = loss. Fed into the aggregate `pnl_mean` counter.
elapsed_secondsNoSeconds elapsed between the original quesen.validate decision and the observation of this outcome. Non-negative.
client_request_idNoOptional caller-side trace id. Echoed verbatim in the response for cross-system correlation.

TDQS

A3.6/5.0
Behavior2/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 of behavioral disclosure. It states 'Aggregated deterministically for SKIP-rate vs realized-outcome correlation', which hints at deterministic processing, but it doesn't disclose whether the call is idempotent, reversible, or what happens on duplicate submissions. For a write-operation tool (posting outcome feedback), missing information about side effects, idempotency, and error handling is a significant gap. The description is too thin on behavioral 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?

The description is two sentences, tightly written, with the essential purpose front-loaded. The first sentence states what it does and what it accepts; the second mentions the deterministic aggregation purpose. Every sentence contributes value with no filler. It could arguably be split into a structured list for the outcome enum, but it remains concise and readable.

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?

For a tool with 8 parameters and no output schema, the description adequately covers the core purpose but omits workflow context beyond what the schema provides (e.g., the dependency on a prior quesen.validate call is only in the schema, not the description). It also doesn't mention error scenarios or return behavior. Given the schema covers parameter semantics thoroughly, the description is acceptable but not comprehensive. A bit more workflow guidance would improve it.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all 8 parameters, including the outcome enum values and the requirement that request_id come from a prior quesen.validate call. The description adds a little context by mentioning the aggregation correlation (linking outcome and realized_pnl), but it doesn't provide meaningful semantics beyond what the schema already states. Baseline 3 is appropriate given high coverage.

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?

The description opens with 'Post-decision outcome feedback', which clearly states the verb and resource (reporting outcomes after a decision). It explicitly lists the required inputs (request_id + outcome) and the accepted outcome enum, which distinguishes it from siblings like quesen.validate (which produces decisions) and quesen.simulate (which predicts outcomes). The purpose is unambiguous and specific.

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?

The phrase 'Post-decision outcome feedback' clearly implies the tool is used after a decision has been made and the outcome is known, which is a clear context. It doesn't explicitly name alternatives or exclusions, but the sibling tool names (validate, simulate) make the use case obvious without needing explicit 'when not to use' statements. The absence of explicit alternatives is a minor gap, but the context is clear enough for an agent to select it correctly.

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

quesen.simulateAInspect

Counterfactual scoring. Compare the baseline decision against a simulated decision under caller-supplied weights_override / thresholds_override. Free sales asset — not charged against key.

ParametersJSON Schema
NameRequiredDescriptionDefault
domain_age_daysNoAge of the target domain in days. Same feature as quesen.validate; combined with the (possibly overridden) weights to produce a counterfactual risk score.
engagement_ratioNoEngagement ratio in [0, 1]. Same feature as quesen.validate; used with the (possibly overridden) weights during simulation.
weights_overrideNoOptional per-feature weight override used ONLY for this simulation. When null (or omitted) the engine uses its production weights. Does NOT mutate global state.
client_request_idNoOptional caller-side trace id. Echoed verbatim in the response for cross-system correlation.
scam_keyword_countNoCount of known scam keywords detected. Same feature as quesen.validate; used with the (possibly overridden) weights.
thresholds_overrideNoOptional decision-threshold override used ONLY for this simulation. When null the engine uses its production thresholds. Does NOT mutate global state.

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 disclosure burden. It does reveal that calls are free/not key-charged and that this is a simulation rather than a production decision, but it omits output shape, side-effect behavior, and where the baseline decision comes from.

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?

Three short declarative statements with no filler. The core action is front-loaded, and the billing note is useful additional context placed at the end.

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

Completeness2/5

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

The schema richly documents parameters, but there is no output schema and the description never says what the response contains. It also leaves the 'baseline decision' undefined. For a simulation tool an agent may need more context to verify the result is the expected counterfactual comparison.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all six parameters. The description adds that weights_override and thresholds_override are the mechanism for the counterfactual simulation, but this largely echoes the parameter descriptions. No significant new parameter-level meaning is added.

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?

The description leads with 'Counterfactual scoring' and a specific action: compare the baseline decision against a simulated decision under caller-supplied weight/threshold overrides. This clearly identifies what the tool does and separates it from the validate/report/health/version siblings.

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 'Free sales asset — not charged against key' line gives billing context, and 'counterfactual scoring' implies when it should be used. However, it never explicitly names alternatives (e.g., quesen.validate for real decisions) or states when not to use this tool.

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

quesen.validateAInspect

Deterministic pre-decision risk validation for autonomous agents. Returns PROCEED / REVIEW / SKIP plus risk_score, confidence, and named conflict triggers. Same input -> same output; every response embeds engine_version + weights + thresholds for full replay.

ParametersJSON Schema
NameRequiredDescriptionDefault
domain_age_daysNoAge of the target domain in days.
engagement_ratioNoEngagement ratio in [0, 1].
client_request_idNoOptional caller-side trace id (echoed in response).
scam_keyword_countNoCount of known scam keywords detected.

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations, the description carries the behavioral burden. It discloses determinism ('Same input -> same output'), replayability via embedded engine_version/weights/thresholds, and the nature of outputs. It does not explicitly state side effects, but 'validation' strongly implies a read-only operation.

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?

Two tight sentences front-load the core purpose and then provide deterministic/replay guarantees. Every sentence adds distinct information, with no filler or repetition.

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?

The description sufficiently explains what the tool returns given there is no output schema: the decision, risk score, confidence, conflict triggers, and replay metadata. It does not cover error behavior or exact response structure, but for a validation tool with all-optional parameters this is a minor gap.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema fully documents all four parameters. The description adds no parameter-level meaning, which is acceptable but not value-adding; baseline 3 applies.

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?

Description states a clear purpose: deterministic pre-decision risk validation. It also specifies the exact output categories (PROCEED / REVIEW / SKIP) and supporting signals, which differentiates it from siblings like health, report, simulate, and version.

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?

The phrase 'pre-decision risk validation for autonomous agents' gives a clear usage context: call before making a decision. It does not explicitly name alternatives or when not to use the tool, but the context is strong enough to guide selection.

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

quesen.versionAInspect

Full engine configuration — weights, thresholds, versions.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

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

With no annotations, the description carries the burden; it does disclose the configuration domains (weights, thresholds, versions) and, by having no inputs, suggests a read-only inspection. It does not explicitly state that invocation has no side effects or describe the returned structure, which leaves some ambiguity.

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?

One compact sentence with no filler; the key scoping phrase 'Full engine configuration' is front-loaded and the examples that follow clarify scope.

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, no-output-schema tool with no annotations, the description is mostly sufficient: an agent knows what resource is exposed and what categories of data it contains. It would be stronger if it explicitly said whether it returns/sets configuration, but the context makes that unlikely.

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?

There are zero parameters, and the schema enforces an empty object, so the description does not need to explain parameter behavior. Baseline 4 applies.

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?

Description identifies the resource as the full engine configuration and enumerates contents (weights, thresholds, versions), which clearly separates it from health/report/simulate/validate siblings. It stops short of an explicit verb, but the empty input schema implies this is a retrieval operation.

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 the tool is used when the current engine configuration is needed, and the sibling names provide obvious contrast. However, it does not state when not to use it, mention prerequisites, or name an alternative.

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. Dates show when Glama detected each change.

  1. 2 tool updates
    • Changedquesen.report8 fields changed
      • addedInput schema / properties / client_request_id / description
        Added value: +"Optional caller-side trace id. Echoed verbatim in the response for cross-system correlation."
      • addedInput schema / properties / elapsed_seconds / description
        Added value: +"Seconds elapsed between the original quesen.validate decision and the observation of this outcome. Non-negative."
      • addedInput schema / properties / notes / description
        Added value: +"Optional free-text notes about the outcome (post-mortem, context, references). Stored verbatim for audit."
      • addedInput schema / properties / outcome / description
        Added value: +"Real-world outcome once known. RUG = rug-pull / total loss; LOSS = negative PnL; OK = neutral / no material result; WIN = positive PnL; UNKNOWN = outcome not yet observable."
      • addedInput schema / properties / realized_pnl / description
        Added value: +"Realized profit/loss in the caller's chosen unit (e.g. USD, SOL, ETH). Sign convention: positive = profit, negative = loss. Fed into the aggregate `pnl_mean` counter."
      • addedInput schema / properties / request_id / description
        Added value: +"The `request_id` returned by a prior quesen.validate call. Ties the reported outcome back to the exact decision that produced it."
      • addedInput schema / properties / signal_hash / description
        Added value: +"Optional hash/fingerprint of the original signal (URL, token address, message id) so outcomes can be joined across systems that don't share Quesen request_ids."
      • addedInput schema / properties / venue / description
        Added value: +"Venue or platform where the trade/signal was executed (e.g. 'raydium', 'jupiter', 'uniswap-v3'). Free-form label for downstream grouping."
    • Changedquesen.simulate11 fields changed
      • addedInput schema / properties / client_request_id / description
        Added value: +"Optional caller-side trace id. Echoed verbatim in the response for cross-system correlation."
      • addedInput schema / properties / domain_age_days / description
        Added value: +"Age of the target domain in days. Same feature as quesen.validate; combined with the (possibly overridden) weights to produce a counterfactual risk score."
      • addedInput schema / properties / engagement_ratio / description
        Added value: +"Engagement ratio in [0, 1]. Same feature as quesen.validate; used with the (possibly overridden) weights during simulation."
      • addedInput schema / properties / scam_keyword_count / description
        Added value: +"Count of known scam keywords detected. Same feature as quesen.validate; used with the (possibly overridden) weights."
      • addedInput schema / properties / thresholds_override / description
        Added value: +"Optional decision-threshold override used ONLY for this simulation. When null the engine uses its production thresholds. Does NOT mutate global state."
      • addedInput schema / properties / thresholds_override / properties / review / description
        Added value: +"Risk score at or above which the counterfactual decision becomes REVIEW (below `skip`)."
      • addedInput schema / properties / thresholds_override / properties / skip / description
        Added value: +"Risk score at or above which the counterfactual decision becomes SKIP."
      • addedInput schema / properties / weights_override / description
        Added value: +"Optional per-feature weight override used ONLY for this simulation. When null (or omitted) the engine uses its production weights. Does NOT mutate global state."
      • addedInput schema / properties / weights_override / properties / domain_age / description
        Added value: +"Weight applied to the domain_age_days feature during counterfactual scoring."
      • addedInput schema / properties / weights_override / properties / engagement / description
        Added value: +"Weight applied to the engagement_ratio feature during counterfactual scoring."
      • addedInput schema / properties / weights_override / properties / scam_keywords / description
        Added value: +"Weight applied to the scam_keyword_count feature during counterfactual scoring."
  2. 5 tool updates
    • First observedquesen.health
    • First observedquesen.report
    • First observedquesen.simulate
    • First observedquesen.validate
    • First observedquesen.version

Frequently Asked Questions

Discussions

No comments yet. Be the first to start the discussion!

Related MCP Connectors

Related MCP Servers

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4/5.0
Disambiguation5/5

Each tool has a clearly distinct role: health for liveness, validate for pre-decision risk, report for post-decision feedback, simulate for counterfactual scoring, and version for configuration. Even the minor overlap between health and version is resolved by their descriptions (liveness probe vs. full config).

Naming Consistency4/5

All tools share a consistent 'quesen.' prefix and lowercase single-word naming, which is predictable. However, the suffix words are not uniformly verbs or nouns (health, version vs. validate, simulate), so the semantic pattern is mildly inconsistent.

Tool Count5/5

Five tools is well-scoped for a decision-layer server. Each tool covers a distinct core concern without redundancy or excessive surface area.

Completeness4/5

The set covers the core decision lifecycle: validate pre-decision, report post-decision, simulate counterfactuals, and inspect configuration. The main minor gap is that aggregated report results are described but there is no tool to retrieve them.