Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

README.md

@zkdna/mcp-server

MCP server with zkDNA identity-based authentication for AI agent tool calls.

Quick Start

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "zkdna": {
      "command": "npx",
      "args": ["tsx", "/path/to/zkDNA/packages/mcp-server/src/index.ts"]
    }
  }
}

Standalone

npx tsx packages/mcp-server/src/index.ts

Available Tools

Tool Required Capability Description
web_search search:web Search the web for information
read_document read:documents Read a document by ID
write_report write:reports Write a report
agent_info (none) View agent identity, capabilities, and audit log

How It Works

  1. Server starts with a principal DID (human identity)
  2. A default agent is registered with scoped capabilities
  3. Each tool call is authenticated (verify agent credential) and authorized (check capability policy)
  4. All actions are logged in a verifiable audit trail
  5. Unauthorized tool calls are blocked with clear error messages

Resources

  • zkdna://agent/identity — Current agent's DID, capabilities, and credential info