Skip to main content

MCP server for AKF — check, stamp, and audit trust metadata on any file

Project description

mcp-server-akf

mcp-name: io.github.HMAKT99/akf

MCP (Model Context Protocol) server that exposes 10 AKF tools to AI agents. Any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Windsurf, etc.) can check, stamp, validate, audit, and scan files using the Agent Knowledge Format.

A stamp costs ~15 tokens. Re-verifying costs 15,000. Agents stamp what they verify; the next agent calls check_file and builds on it instead of redoing the work.

Installation

pip install mcp-server-akf

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "akf": {
      "command": "python",
      "args": ["-m", "mcp_server_akf"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "akf": {
      "command": "python",
      "args": ["-m", "mcp_server_akf"]
    }
  }
}

Tools

Tool Description
check_file One-line trust check — can an agent build on this file without re-verifying? (OK / LOW / STALE / UNSTAMPED)
create_claim Create an AKF claim with trust metadata
validate_file Validate an .akf file against the spec
scan_file Security scan any file for AKF metadata
trust_score Compute effective trust score for a claim
stamp_file Stamp trust metadata onto any file (20+ formats)
audit_file Compliance audit (EU AI Act, SOX, HIPAA, GDPR, NIST, ISO 42001)
embed_file Embed AKF metadata into DOCX, PDF, HTML, images, etc.
extract_file Extract AKF metadata from any supported format
detect_threats Run 10 AI-specific security detections

Quick usage

Once configured, ask your AI agent:

"Stamp report.docx with AKF trust metadata, confidence 0.9, evidence 'quarterly review complete'"

The agent will call stamp_file through MCP and attach provenance automatically.

You can also run the server directly for testing:

python -m mcp_server_akf

Multi-Agent Support

The MCP server works seamlessly with multi-agent orchestration platforms:

  • Agent Identity: Create and verify agent cards via akf agent create / akf agent verify
  • A2A Protocol: Export/import agent cards for cross-platform discovery via akf agent export-a2a
  • Team Certification: Use akf certify --team for per-agent trust breakdowns in CI
  • Delegation: Trust ceilings cap delegate output when agents hand off work
  • Team Streaming: Multi-agent sessions with per-agent claim attribution

Supports: Claude Agent Teams, Copilot Cowork, Codex multi-agent, and any A2A-compatible platform.

Requirements

  • Python >= 3.10
  • akf >= 1.0.0
  • mcp >= 1.0.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_akf-1.5.0.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_server_akf-1.5.0-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file mcp_server_akf-1.5.0.tar.gz.

File metadata

  • Download URL: mcp_server_akf-1.5.0.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for mcp_server_akf-1.5.0.tar.gz
Algorithm Hash digest
SHA256 4052d39a524bfe465833cd616afb13e7e6cec84d18abac4b15b7db1b76bdc4e6
MD5 7f09e832dc45e14bbe3f319ef4715b9f
BLAKE2b-256 a6717c30b837bbcbcbce5464ad42c677e79a059ecf5c4bb4726431b449ba3b47

See more details on using hashes here.

File details

Details for the file mcp_server_akf-1.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_server_akf-1.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9141e384dbaf772e3fb9896eca3498c02aa7f391c609ee58ab19288ed4c2e84f
MD5 ce7ce8ae087b18e22cd2466a18dae438
BLAKE2b-256 40e7be9e2457c2d94043ce275e40f006cb0110266d53d5adef80fad35342f6fe

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page