Skip to main content
Glama
vitron-ai

alethia-mcp

Official
by vitron-ai

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ALETHIA_HOSTNoHost of the Alethia runtime127.0.0.1
ALETHIA_PORTNoPort of the Alethia runtime47432
ALETHIA_DEBUGNoSet to 1 for debug logging on stderr
ALETHIA_VISIBLENoDeprecated — set to 0 as a legacy alias for ALETHIA_HEADLESS=1. Removed in a future release.
ALETHIA_HEADLESSNoSet to 1 to hide the cockpit window. Default is visible. CI environments auto-hide.
ALETHIA_BRIDGE_SRINoRequire any auto-downloaded bridge tarball to match this sha512-<base64> integrity string.
ALETHIA_HIGHLIGHTSNoPer-step highlights on the target. Default ON since 0.8.3. Set to 0 to disable for headless / max-speed runs.1
ALETHIA_TIMEOUT_MSNoPer-request timeout in milliseconds60000
ALETHIA_RUNTIME_DIRNoWhere the auto-installed runtime lives. Override for sandboxing or to stash multiple installs.~/.alethia/runtime
ALETHIA_BRIDGE_VERSIONNoPin the bridge itself to a specific version (e.g. 0.8.0). Skips the npm auto-update check.
ALETHIA_RUNTIME_VERSIONNoPin the bridge to a specific runtime version (e.g. 0.4.0).
ALETHIA_SKIP_AUTO_UPDATENoSet to 1 to disable the bridge's npm registry check entirely.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
alethia_tellA

Execute natural-language E2E test instructions against the page Alethia is currently driving. Returns per-step results, policy audit records, and a SHA-256 integrity hash. Destructive actions (delete, purchase, transfer, etc.) are blocked unconditionally. Sensitive input (passwords, credit cards, SSN) is blocked unless allowSensitiveInput is true. ~13 ms per step on average.

alethia_compileA

Compile natural-language test instructions to Alethia Action IR text, without executing anything. Returns the compiled IR, per-line confidence scores (0-1), and warnings for any lines the compiler could not parse. Use this to preview what tell() will run, debug coverage gaps, or generate reproducible IR scripts for CI pipelines.

alethia_statusA

Health and identity probe. Returns runtime version, the default VITRON-EA1 policy profile in effect, kill switch state, driver statistics (queued plans, run count, audit count), the current page domain, and runtime capabilities. Use this for liveness checks before sending tell() calls, and to verify the runtime is in a known-good state at the start of an agent loop.

alethia_activate_kill_switchA

Halt all current and queued automation immediately. The per-step VITRON-EA1 policy gate stays armed; subsequent tell() calls will be blocked with reason KILL_SWITCH_ACTIVE until reset. Use this when an agent appears to be acting unsafely, when human review is required, or to enforce a hard boundary at the end of a controlled test run.

alethia_screenshotA

Capture a PNG screenshot of the current page and return it as a base64-encoded image. Use this to visually verify what the browser is showing after running test steps with alethia_tell.

alethia_evalA

Evaluate a JavaScript expression in the page under test and return the result. Runs in the context of the navigated page, not the Alethia host UI. Use this for queries the NLP compiler cannot express — counting elements, reading computed styles, checking localStorage, or any DOM inspection that needs raw JS.

alethia_audit_wcagA

Run a WCAG 2.1 AA accessibility audit on the current page, powered by axe-core. Checks alt text, form labels, keyboard access, color contrast, ARIA usage, heading structure, and the rest of the axe-core ruleset — not a fixed checklist. Call after navigating with alethia_tell. Returns findings with rule IDs, impact levels, and issue counts.

alethia_audit_nistA

Run a NIST SP 800-53 Rev. 5 web application security controls audit on the current page. Checks 8 controls across 3 families: AC (login lockout, security banners, session timeout), IA (unmasked passwords, weak password constraints, MFA indicators), SI (input validation, error information leakage). Call after navigating with alethia_tell. Returns findings with control IDs and severity levels.

alethia_export_sessionA

Export the full session recording as a signed evidence pack. Contains every tool call made during this session with timestamps, inputs, outputs, policy decisions, and a SHA-256 integrity hash. Use at the end of an agent loop to produce cryptographic proof of everything the agent did. Designed for compliance review and chain-of-custody.

alethia_tell_parallelA

Run multiple test flows concurrently — each against a different URL. Takes an array of test specs, spawns a browser instance per spec, runs them in parallel, and returns all results together. Use this to verify multiple pages simultaneously.

alethia_serve_demoA

Start a local HTTP server for the built-in Alethia demo pages and return the base URL. Use this to serve demo pages on localhost so they appear in preview panels (Claude Code, VS Code, etc.). The server runs on a random available port on 127.0.0.1. Call this before alethia_tell to get a localhost URL instead of a file:// path. Returns the base URL and a list of available demo pages.

alethia_propose_testsA

Navigate to a URL, scan the page for interactive elements (headings, buttons, forms, links, destructive actions), and generate a candidate NLP test suite ready to pass to alethia_tell. Returns an array of plain-English test blocks, including an auto-generated "EA1 Safety Gate Verification" block that uses "expect block: " for every destructive control on the page. Use this to bootstrap test coverage for a new page or to discover what the safety gate should be watching.

alethia_assert_safetyA

Navigate to a URL, discover every destructive / write-high action on the page, and verify the VITRON-EA1 policy gate blocks each one. Returns a per-action report with block/allow status. This is the automated policy-verification primitive — proves the safety gate works on a real page without the agent or human having to click each destructive button manually. Use it as a compliance check before releasing an agent-driven workflow against a customer environment.

alethia_show_cockpitA

Show the Alethia cockpit window — the oversight surface where the target app is driven and each step is highlighted live (green = pass, blue = type, red = EA1 block). Use this to pop the UI into view during a headless-launched session for demos, review, or partner walkthroughs.

alethia_hide_cockpitA

Hide the Alethia cockpit window. The runtime keeps running and continues to accept tool calls; only the visible window is dismissed.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vitron-ai/alethia-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server