# TrigGuard (npm · @trigguard/mcp-server)

Execution authorization for AI agents and automated systems.

- Trust score: 64/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-20

## Components

- npm · `@trigguard/mcp-server`: 64/100 (this document), [markdown](https://verifymcp.io/servers/trigguard-ai-trigguard/trigguard-mcp-server.md), [page](https://verifymcp.io/servers/trigguard-ai-trigguard/trigguard-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@trigguard/mcp-server`
- Version: `1.2.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-20.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 98 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 0 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 80/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 659 tokens (~65/item across 10 items; 10 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add trigguard-ai-trigguard -- npx -y @trigguard/mcp-server
```

### Codex

```bash
codex mcp add trigguard-ai-trigguard -- npx -y @trigguard/mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "trigguard-ai-trigguard": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@trigguard/mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add trigguard-ai-trigguard --command npx --arg -y --arg @trigguard/mcp-server
```

### Hermes

```yaml
mcp_servers:
  trigguard-ai-trigguard:
    command: "npx"
    args: ["-y", "@trigguard/mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "trigguard-ai-trigguard": {
      "command": "npx",
      "args": [
        "-y",
        "@trigguard/mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-20 (score 64)

First indexed and scored.

## MCP tools (10)

### `authorize_action` (~130 tokens)

Request TrigGuard authority for an action. Returns PERMIT, DENY, SILENCE, or ESCALATE with execution receipt metadata and v1.1 explanation fields (reason_code, escalation_*, policy_version, evaluation_id). SILENCE is withhold/no-commitment; ESCALATE is an approval lifecycle. Neither is PERMIT. Requires TRIGGUARD_API_KEY (gateway API key).

Input parameters:

- `context` (object): Execution context (repository, environment, etc.)
- `subject` (string): Optional subject digest
- `surface` (string, required): Execution surface (e.g. deploy.release)

### `verify_receipt` (~85 tokens)

Verify a TrigGuard execution receipt by execution id. Optional include_receipt (default false) returns the receipt body. Requires gateway API key for authenticated lookup when the gateway enforces auth.

Input parameters:

- `execution_id` (string, required): Execution id (exec_…)
- `include_receipt` (boolean): When true, include the receipt document in the response (v1.1)

### `explain_decision` (~82 tokens)

Explain a TrigGuard authority decision using an execution_id and/or a prior authorize_result payload. Returns structured reason_code, missing requirements, and next actions. Read-only — does not authorize.

Input parameters:

- `authorize_result` (object): Optional prior authorize / gateway response object still in context
- `execution_id` (string): Execution id (exec_…) from authorize_action

### `get_surface` (~34 tokens)

Read execution surface registry metadata for one surface id (read-only, no policy evaluation).

Input parameters:

- `surface` (string, required): Surface id

### `list_surfaces` (~60 tokens)

List registered execution surfaces from the gateway well-known registry (or local registry override). Read-only discovery.

Input parameters:

- `limit` (number): Max surfaces to return (default 50, max 200)
- `prefix` (string): Optional surface id prefix filter

### `get_policy` (~55 tokens)

Read human-readable policy metadata for a surface from the bundled policy artifact. Does NOT evaluate live org policy — call authorize_action for PERMIT/DENY/SILENCE/ESCALATE.

Input parameters:

- `surface` (string, required): Surface id

### `list_org_policies` (~52 tokens)

List org policies from the TrigGuard control plane Policy Platform. Requires TRIGGUARD_SESSION_TOKEN + TRIGGUARD_ORG_ID (session JWT rail — not gateway API key alone). Read-only.

### `list_pending_policy_changes` (~37 tokens)

List pending policy change requests awaiting approval. Requires TRIGGUARD_SESSION_TOKEN + TRIGGUARD_ORG_ID. Read-only.

### `preview_policy_intent` (~67 tokens)

Compile-only preview of a policy intent against the Policy Platform. Requires TRIGGUARD_SESSION_TOKEN + TRIGGUARD_ORG_ID. Does not persist. Not a substitute for authorize_action.

Input parameters:

- `intent` (object, required): Policy intent JSON (same shape as tg policy --file)

### `health_check` (~57 tokens)

Check TrigGuard gateway reachability, policy engine status, registry hash, and whether API key / session JWT env vars are present (values are never returned).

Input parameters:

- `detailed` (boolean): When true, include raw /health body under details

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/trigguard-ai-trigguard/trigguard-mcp-server#diagnostics

## Score history

- 2026-08-20: 64

## Links

- npm package: https://www.npmjs.com/package/@trigguard/mcp-server
- Socket report: https://socket.dev/npm/package/@trigguard/mcp-server
- Website: https://trigguardai.com/
- Changelog RSS feed: https://verifymcp.io/servers/trigguard-ai-trigguard/trigguard-mcp-server.xml
- Changelog JSON feed: https://verifymcp.io/servers/trigguard-ai-trigguard/trigguard-mcp-server.json
- HTML version of this page: https://verifymcp.io/servers/trigguard-ai-trigguard/trigguard-mcp-server