# akf

An MCP server with 10 AKF tools: the agent checks whether a file is safe to build on, then stamps what it verified.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20
- Author: HMAKT99
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HMAKT99/AKF/tree/HEAD/packages/mcp-server-akf
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/akf

## What it does

Ten tools for the Agent Knowledge Format come in over MCP. `check_file` answers in one line whether a file is OK, LOW, STALE or UNSTAMPED, so an agent can decide to rely on it instead of re-reading the whole thing. `stamp_file` attaches the trust metadata across 20+ formats, and `extract_file` with `embed_file` move that metadata in and out of DOCX, PDF, HTML and images.

The economics are the pitch. A stamp costs roughly 15 tokens, re-verifying the same file costs 15,000. Whoever did the work records it, the next agent reads the state. `audit_file` checks a file against EU AI Act, SOX, HIPAA, GDPR, NIST or ISO 42001, while `detect_threats` runs 10 checks built around agent behaviour.

Requirements are Python 3.10 or newer plus `akf` 1.0.0 and `mcp` 1.0.0. On an older interpreter it won't start at all, so an outdated project fails at launch. Install with `pip install mcp-server-akf`, or register it for Claude Code with `claude mcp add akf -- uvx mcp-server-akf`. File state rides in `_meta` under `dev.akf/trust` on mcp 2.x, and a client that has never heard of the key drops it.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add akf -- uvx mcp-server-akf
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-akf <command>

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server-akf -- uvx mcp-server-akf
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-akf <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server-akf": {
            "command": "uvx",
            "args": [
                "mcp-server-akf"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-akf <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server-akf": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-server-akf"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-akf <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-server-akf uvx mcp-server-akf
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-akf <command>

## When to use it
- decide whether a file is safe to build on without opening it
- stamp a reviewed `report.docx` with trust metadata
- pull AKF metadata out of a PDF or a screenshot
- run a compliance pass against GDPR and HIPAA
- catch threats written for AI agents

## Example prompts
- Run `check_file` on `src/api.py` and tell me if it's safe to build on.
- Stamp `report.docx` with AKF metadata, confidence 0.9, evidence: quarterly review done.
- Audit `contract.pdf` against GDPR with `audit_file` and show me the report.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

From the same set: [hmakt99/akf](https://affpapa.org/en/nevibecode/by/hmakt99/akf.md) — 2 cards

---
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