# Kevros

Runtime intelligence for autonomous AI agents. Kevros verifies every agent action before execution, issues cryptographic release tokens, and records every decision in a hash-chained provenance ledger.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add ndl-systems/kevros

# Browse available tools
npx -y @smithery/cli@latest tool list ndl-systems/kevros

# Get full schema for a tool
npx -y @smithery/cli@latest tool get ndl-systems/kevros verify

# Call a tool
npx -y @smithery/cli@latest tool call ndl-systems/kevros verify '{}'
```

## Direct MCP Connection

Endpoint: `https://kevros--ndl-systems.run.tools`

**Optional config:**
- `apiKey` (header) — Your Kevros API key (kvrs_...). Leave blank to auto-provision a free-tier key on first call.

## Tools (9)

- `verify` — Verify an action against policy bounds before executing it. Returns ALLOW (proceed), CLAMP (proceed with modified value…
- `attest` — Create a hash-chained provenance record for an action you've taken. Each attestation extends the append-only evidence c…
- `bind` — Declare an intent and cryptographically bind it to a command. Proves that the command was issued in service of the decl…
- `verify-outcome` — Verify that an executed action achieved its declared intent. Closes the loop: intent -> command -> action -> outcome ->…
- `bundle` — Generate a certifier-grade compliance evidence bundle. Contains hash-chained provenance, intent bindings, PQC attestati…
- `health` — Check the governance gateway health status. Free.
- `status` — Check your current usage and quota: calls used, calls remaining, tier, rate limits, and billing status. Free.
- `check-peer` — Check another agent's trust score and governance history. Returns trust score (0-100), chain length, attestation count,…
- `verify-token` — Verify a release token from another agent. Confirms the token is authentic and was issued by the Kevros gateway. Free, …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get ndl-systems/kevros <tool-name>
```

## Resources

- `kevros://agent-card` — A2A agent card for the Kevros Runtime Intelligence Gateway.
- `kevros://trust-status` — Current governance chain status.

## Prompts (2)

- `verify-before-act` (action_type, action_description, agent_id) — Pre-flight governance check. Generates a verify request for an action before executing it.
- `governance-audit` (agent_id, time_range_start, time_range_end) — Generate a compliance audit bundle for an agent's actions over a time range.