Skip to content

tools.md

Latest commit

 

History

History
414 lines (337 loc) · 7.67 KB

tools.md

File metadata and controls

414 lines (337 loc) · 7.67 KB
Raw

Tool Reference

14 tools, generated from tools/registry.py - the same data MCP clients see via tools/list. See README.md for a one-line-per-tool overview and ROADMAP.md for what's shipped per phase.

Core

core.health — Health Check

Return rich server diagnostics: adapter availability, loaded tools/resources/prompts, and recent successful calls.
Category core
Prerequisites none
Expected duration instant
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

core.session_state — Session State

Inspect the artifacts and call history accumulated in a session.
Category core
Prerequisites none
Expected duration instant
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Session to read/write shared state under. Defaults to 'default'."
    }
  },
  "additionalProperties": false
}

core.verify — Verify Integrations

Check connectivity to agenticlens, agentic-chaos, agentic-sidecar, and ai-operations-spec, and report readiness.
Category core
Prerequisites none
Expected duration instant
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

core.version — Server Version

Return the current server package version.
Category core
Prerequisites none
Expected duration instant
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

AgenticLens (lens.*)

lens.analyze_workflow — Analyze Workflow

Analyze an AgenticLens-compatible workflow artifact.
Category lens
Prerequisites agenticlens
Expected duration fast
Mutates session yes

Input schema:

{
  "type": "object",
  "properties": {
    "artifact": {
      "type": "object"
    },
    "session_id": {
      "type": "string",
      "description": "Session to read/write shared state under. Defaults to 'default'."
    }
  },
  "required": [
    "artifact"
  ],
  "additionalProperties": false
}

lens.audit_report — Audit Report

Return case-by-case evaluation detail for an audit trail.
Category lens
Prerequisites agenticlens
Expected duration fast
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {
    "report": {
      "type": "object"
    },
    "include_html": {
      "type": "boolean"
    },
    "session_id": {
      "type": "string",
      "description": "Session to read/write shared state under. Defaults to 'default'."
    }
  },
  "required": [
    "report"
  ],
  "additionalProperties": false
}

lens.compare_runs — Compare Runs

Compare baseline and candidate trace runs for regressions. 'baseline'/'candidate' may be omitted to reuse the session's stored runs.
Category lens
Prerequisites agenticlens
Expected duration fast
Mutates session yes

Input schema:

{
  "type": "object",
  "properties": {
    "baseline": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "candidate": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "regression_threshold": {
      "type": "number"
    },
    "session_id": {
      "type": "string",
      "description": "Session to read/write shared state under. Defaults to 'default'."
    }
  },
  "additionalProperties": false
}

lens.report_summary — Workflow Report Summary

Render a Markdown workflow report and recommendation summary. 'artifact' may be omitted to reuse the session's stored workflow.
Category lens
Prerequisites agenticlens
Expected duration fast
Mutates session yes

Input schema:

{
  "type": "object",
  "properties": {
    "artifact": {
      "type": "object"
    },
    "session_id": {
      "type": "string",
      "description": "Session to read/write shared state under. Defaults to 'default'."
    }
  },
  "additionalProperties": false
}

lens.slo_summary — SLO Summary

Apply release-gate style SLO thresholds to an evaluation report.
Category lens
Prerequisites agenticlens
Expected duration fast
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {
    "report": {
      "type": "object"
    },
    "thresholds": {
      "type": "object"
    },
    "session_id": {
      "type": "string",
      "description": "Session to read/write shared state under. Defaults to 'default'."
    }
  },
  "required": [
    "report"
  ],
  "additionalProperties": false
}

Agentic Chaos (chaos.*)

chaos.list_faults — List Chaos Faults

List the supported fault types for chaos experiments.
Category chaos
Prerequisites agentic_chaos
Expected duration instant
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

chaos.run_experiment — Run Chaos Experiment

Run a workspace-sandboxed target script under selected chaos faults and report the resulting events.
Category chaos
Prerequisites agentic_chaos
Expected duration slow
Mutates session yes
Executes external code yes — see SECURITY.md

Input schema:

{
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "description": "Script path, resolved inside the workspace root."
    },
    "faults": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "timeout_seconds": {
      "type": "number"
    },
    "session_id": {
      "type": "string",
      "description": "Session to read/write shared state under. Defaults to 'default'."
    }
  },
  "required": [
    "script",
    "faults"
  ],
  "additionalProperties": false
}

Agentic Sidecar (sidecar.*)

sidecar.module_inventory — Sidecar Module Inventory

List the current scaffolded modules, framework adapters, and integration placeholders present in agentic-sidecar.
Category sidecar
Prerequisites agentic_sidecar
Expected duration instant
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

sidecar.status — Sidecar Status

Report whether agentic-sidecar is importable and whether its decision runtime is actually ready yet.
Category sidecar
Prerequisites agentic_sidecar
Expected duration instant
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

AI Operations Specification (spec.*)

spec.validate_artifact — Validate AI Operations Artifact

Validate a workflow or run artifact against the AI Operations v0.4 draft.
Category spec
Prerequisites ai_operations_spec
Expected duration fast
Mutates session no

Input schema:

{
  "type": "object",
  "properties": {
    "artifact": {
      "type": "object"
    }
  },
  "required": [
    "artifact"
  ],
  "additionalProperties": false
}