Atlas / MCP servers / vitron-ai / alethia-mcp

alethia-mcpCAUTION

mcp/vitron-ai/alethia-mcp

Execution and verification infrastructure for AI-powered software development. Alethia helps agents test what they build.

Verdict
CAUTION
Grade
C
Trust score
79 /100
Exposed tools
15 8r · 6w · 1d
Transport
—
License
NOASSERTION
Stars
2
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

AI agents can write software. Vitron makes sure it works.

Vitron is building execution and verification infrastructure for AI-powered software development. Alethia connects an AI agent to an application so it can run workflows, check behavior, inspect results, and iterate with evidence.

Alethia is available to MCP-compatible clients as a local server. Give your agent plain-English instructions such as “open the sign-in page, submit the test account, and confirm the dashboard appears.” The agent receives step results and can continue based on what happened.

[](https://www.npmjs.com/package/@vitronai/alethia) [](./LICENSE) [](https://github.com/vitron-ai/alethia-mcp)

Get started

Install for Claude Code

The Claude Code plugin installs the MCP server and its workflow skill:

~~~text /plugin marketplace add vitron-ai/alethia-mcp /plugin install alethia@vitronai ~~~

Restart Claude Code or run /reload-plugins.

To install only the skill, use alethia-mcp --install-skill after installing the package, or follow the manual skill instructions.

Install for another MCP client

Alethia requires Node.js 18 or later. Install the bridge:

~~~sh npm install -g @vitronai/alethia ~~~

Add it to your MCP client's configuration:

~~~json { "mcpServers": { "alethia": { "command": "alethia-mcp" } } } ~~~

For a temporary or always-current install, configure the client to run npm's package binary:

~~~json { "mcpServers": { "alethia": { "command": "npx", "args": ["-y", "@vitronai/alethia@latest"] } } } ~~~

The bridge checks for compatible updates in

Read from source at commit 3d59858880eeOBSERVED · 2026-10-11
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.

claude-code
claude mcp add alethia -- npx -y @vitronai/[email protected]
claude-desktop
{
  "mcpServers": {
    "alethia": {
      "command": "npx",
      "args": [
        "-y",
        "@vitronai/[email protected]"
      ]
    }
  }
}
03

Exposed tools (15)

8 read · 6 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

ToolRiskDescription
alethia_activate_kill_switchdestructiveHalt all current and queued automation immediately. The per-step VITRON-EA1 policy gate stays armed;
alethia_assert_safetywriteNavigate to a URL, discover every destructive / write-high action on the page, and verify the
alethia_audit_nistwriteRun a NIST SP 800-53 Rev. 5 web application security controls audit on the current page.
alethia_audit_wcagwriteRun a WCAG 2.1 AA accessibility audit on the current page, powered by axe-core. Checks
alethia_compilereadCompile natural-language test instructions to Alethia Action IR text, without executing anything.
alethia_evalreadEvaluate a JavaScript expression in the page under test and return the result.
alethia_export_sessionreadExport the full session recording as a signed evidence pack. Contains every tool call
alethia_hide_cockpitreadHide the Alethia cockpit window. The runtime keeps running and continues to accept tool calls;
alethia_propose_testsreadNavigate to a URL, scan the page for interactive elements (headings, buttons, forms, links,
alethia_screenshotreadCapture a PNG screenshot of the current page and return it as a base64-encoded image.
alethia_serve_demowriteStart a local HTTP server for the built-in Alethia demo pages and return the base URL.
alethia_show_cockpitreadShow the Alethia cockpit window — the oversight surface where the target app is driven and each
alethia_statusreadHealth and identity probe. Returns runtime version, the default VITRON-EA1 policy profile in effect,
alethia_tellwriteExecute natural-language E2E test instructions against the page Alethia is currently driving.
alethia_tell_parallelwriteRun multiple test flows concurrently — each against a different URL.
04

Trust audit

CAUTIONgrade C · trust 79/100 Install with care. The audit found things worth knowing before you trust its output.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codePASS
L2Instruction surface (what it tells the agent)FAIL
L3Class-specific surfaceWARN
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (1 observation(s))
Network
declared (2 observation(s))
Shell
none-observed
Dependencies
not all pinned
Secrets in source
none-found

Findings (13)

HIGHPrompt injection · prompt.override · CWE-94, CWE-1427
README.md:200
**A destructive action is blocked.** Review the policy result and test against an application and data you control. Do not try to bypass a safety decision through a different prompt.
Why it matters. asks the agent to drop prior instructions or safety
Fix. remove the instruction
MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59
alethia_activate_kill_switch
Why it matters. 1 tool(s) can delete or overwrite
Fix. prefer a read-only mode or scoped tokens; the page states the blast radius
LOWInventory / provenance · inv.hidden_file · CWE-1104
.mcpbignore
.mcpbignore
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
demo/README.md:163
Suite URLs point at `http://127.0.0.1:47432/demo/` — the runtime's own demo server, so they work as soon as the cockpit is running with no separate server to start.
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
demo/suites/tests/01-console-structure.alethia:2
navigate to http://127.0.0.1:47432/demo/dispatch-console.html
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
demo/suites/tests/02-queue-filters.alethia:2
navigate to http://127.0.0.1:47432/demo/dispatch-console.html
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
demo/suites/tests/03-select-different-order.alethia:2
navigate to http://127.0.0.1:47432/demo/dispatch-console.html
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
demo/suites/tests/04-assign-technician.alethia:2
navigate to http://127.0.0.1:47432/demo/dispatch-console.html
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@types/node, @vitronai/themis, typescript
Why it matters. 3 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
docs/agent-cookbook.md:19
Use Alethia to smoke test my dev server at http://localhost:3000. Navigate to it, confirm the page loads, and run a quick sign-in flow with email "[email protected]" and password "demo". Tell me what w
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
INFOInventory / provenance · inv.oversize · CWE-1104
src/assets/alethiaLogo.png
src/assets/alethiaLogo.png
Why it matters. 2314048 bytes not read
INFOPrompt injection · prompt.authority_framing · CWE-94, CWE-1427
demo/admin-panel.html:392
<tr><td>Program Director</td><td>All Systems</td><td class="status-active">Full Access</td><td>2026-03-14</td><td class="actions"><button class="btn-view">Review</button></td></tr>
INFOPrompt injection · prompt.credential_read · CWE-94, CWE-1427
demo/admin-panel.html:438
<p>This action is irreversible. Lt. Marcus Webb's access credentials, audit history, and associated records will be permanently removed.</p>
Why it matters. asks the agent to read credentials

Gates applied: instruction_override, no_behavioural_pass.

Audited 2026-10-11 · audit v0.4.1 · source sha 3d59858880eefull audit observations/trust-audit/mcp-server/vitron-ai__alethia-mcp.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-113d59858880eeCAUTIONC79first audit
06

Questions

What is the alethia-mcp MCP server?

Execution and verification infrastructure for AI-powered software development. Alethia helps agents test what they build.

What tools does alethia-mcp expose?

15 in total: 8 read-only, 6 that write, and 1 that can delete or overwrite (alethia_activate_kill_switch). Every one is listed on this page with its risk.

Is alethia-mcp safe to connect to an agent?

With care. The audit graded it C (79/100) and found 13 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.

What credentials does alethia-mcp need?

No credential environment variables were found in its source, so it appears to need none.

How current is this page?

The grade is for one exact copy of the source (3d59858880ee), read on 2026-10-11. The repository is watched and re-audited when it changes.

Advertisement