Stacksona Docs / Live package
Live package

@stacksona/agent-tools

Deterministic utility tools for agents, available through CLI, TypeScript imports, request files, and MCP mode.

Fast path: deterministic helper tools

  1. 1
    Install or run with npx.

    npm install -g @stacksona/agent-tools

  2. 2
    Call one utility.

    Use tools for risk checks, policy evaluation, hashing, schema validation, table validation, URL checks, redaction, and proof envelopes.

  3. 3
    Feed outputs into approval context.

    Use deterministic tool output as reviewer context before a Stacksona decision request.

Package

FieldValue
Name@stacksona/agent-tools
Version documented1.0.3
RuntimeNode.js 18 or later
Binarystacksona-agent-tools
Use whenYou want deterministic tool outputs, explanations, hashes, redacted proofs, and replay-friendly audit context.
bash
npm install -g @stacksona/agent-tools
npx @stacksona/agent-tools list

Run as MCP server

bash
stacksona-agent-tools mcp
json
{
  "mcpServers": {
    "stacksona-agent-tools": {
      "command": "stacksona-agent-tools",
      "args": ["mcp"]
    }
  }
}

Tool categories

CategoryTools
Calculation and securitycalculator.evaluate, password.policy_check, security.hash, security.hmac
Proof and dataproof.create, proof.verify, json.format, json.diff, schema.validate, JSON path tools
Text and output qualitytext.redact_sensitive, text.extract, text.slugify, output.check_constraints, template.render
Risk and decision supportrisk.requires_approval, action.fingerprint, http.request_inspect, time.window_check, policy tools, URL tools, table tools
Files, images, provenancefile.checksum, file.inspect, image.metadata, image.annotate_boxes, ocr.extract_text, provenance.c2pa_check

Examples

bash
stacksona-agent-tools call action.fingerprint '{"action":{"type":"refund","amount":2500,"currency":"usd","customer_id":"cus_123"}}'

stacksona-agent-tools call http.request_inspect '{"method":"POST","url":"https://api.stripe.com/v1/refunds","headers":{"Authorization":"Bearer sk_live_redacted"},"body":{"charge":"ch_123","amount":2500}}'

stacksona-agent-tools call policy.evaluate '{"facts":{"action":"refund","amount":250},"rules":[{"id":"refund_threshold","if":{"action":"refund","amount":{"gte":100}},"then":{"requires_approval":true,"reason":"refund_above_threshold"}}]}'