# Tracekit MCP gateway

Tracekit MCP gateway checks agent tool calls, signs each decision, and stores a verifiable record for every run. Use it when the agent’s own log is not enough.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 798 repo stars
- Author: Cygnux-Labs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Cygnux-Labs/Tracekit
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tracekit-mcp-gateway

## What it does

Tracekit MCP gateway sits between an agent and its tool calls. A Tracekit signer decides whether each call may run, then adds the decision and call to a hash-linked record. Every run produces a `.tkb` file that can be checked offline, with verifiers available in Python and TypeScript.

Deploy the gateway first; the agent sends a token with each run. Claude Code connects through `claude mcp add`, while Codex, Cursor, GitHub Copilot, and Gemini CLI use their own MCP settings. In development mode the signer runs as the agent’s user, so the agent could read the key and sign an altered log; a protected setup places the signer beyond the agent’s reach and uses a witness.

## Requirements
- Remote server: `https://{tracekit_gateway}/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http tracekit-mcp-gateway https://{tracekit_gateway}/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add tracekit-mcp-gateway --url https://{tracekit_gateway}/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tracekit-mcp-gateway": {
            "url": "https://{tracekit_gateway}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tracekit-mcp-gateway": {
            "type": "http",
            "url": "https://{tracekit_gateway}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http tracekit-mcp-gateway https://{tracekit_gateway}/mcp
```

## When to use it
- check tool calls before execution
- sign agent decisions into a hash chain
- save one `.tkb` record per run
- verify a run without the agent
- detect edits to recorded events

## Example prompts
- Check every tool call before it runs and record the decision.
- Deny the dangerous call, then show the signed run record.
- Verify the latest `.tkb` file offline.

## Similar
- [competition-prompt-injection](https://affpapa.org/en/nevibecode/skills/competition-prompt-injection.md) — skill · 109 installs
- [HOL Guard](https://affpapa.org/en/nevibecode/mcp/hol-guard.md) — MCP server · ★ 1118 repo stars
- [agent-custody](https://affpapa.org/en/nevibecode/mcp/agent-custody.md) — MCP server · ★ 116 repo stars
- [cascading-failure-detection](https://affpapa.org/en/nevibecode/skills/cascading-failure-detection.md) — skill · ★ 7607 repo stars
- [sanctuary-framework](https://affpapa.org/en/nevibecode/plugins/sanctuary-framework.md) — plugin · ★ 10 repo stars
- [agent-owasp-compliance](https://affpapa.org/en/nevibecode/skills/agent-owasp-compliance.md) — skill · 1500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
