# Shuka

> Shuka is an MCP server for security. Create and verify trust proofs for AI agent data exchanges, for partner accounts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Contact sales
- **Platforms:** API, CLI
- **Repository:** https://github.com/cdonoyan/shuka-agent
- **MCP Registry name:** io.github.cdonoyan/shuka
- **Categories:** [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

The package pairs a TypeScript SDK with an MCP server built around the idea of a "shake": an idempotent attestation, so the same input always gives the same shake. From there the README walks a flow of terms (modifiable rules on the handshake), a license offering, a grant bought by a counterparty, and a public registry proof that traces the ledger chain.

Proof tokens look like `shk_v1.xxx.yyy` and come with a trust score from 0 to 1. The README reads 0.8 and above as safe to proceed, 0.6 to 0.8 as proceed with caution, and lower as needing more verification. Agents can also ask Shuka to vouch for a token received from another agent and get a recommendation back.

Creating shakes, terms and marketplace operations needs an SDK key issued to verified partners; the README says the package installs without one but will not work. Verification is free and needs no key.

## Features

- **Idempotent attestations:** The same entity data always yields the same shake.
- **Proof tokens:** Portable tokens that anyone with API access can verify.
- **Terms layer:** Attach modifiable usage rules to an immutable handshake.
- **License marketplace:** Issue offerings anchored to a shake and let buyers purchase grants.
- **Agent trust negotiation:** Ask for a recommendation on a proof token received from another agent.

## Good for

- Attest a consent record before sharing it with another agent
- Verify a proof token on incoming data
- License a brand identity with a verifiable ledger trail
- Check contractor or compliance attestations across jurisdictions

## Install

### Claude Code (Terminal)

```sh
claude mcp add shuka --env SHUKA_API_KEY='<SHUKA_API_KEY>' -- npx -y @shukashake/agent
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shuka": {
      "command": "npx",
      "args": [
        "-y",
        "@shukashake/agent"
      ],
      "env": {
        "SHUKA_API_KEY": "<SHUKA_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "shuka": {
      "command": "npx",
      "args": [
        "-y",
        "@shukashake/agent"
      ],
      "env": {
        "SHUKA_API_KEY": "<SHUKA_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "shuka": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shukashake/agent"
      ],
      "env": {
        "SHUKA_API_KEY": "<SHUKA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "shuka": {
      "command": "npx",
      "args": [
        "-y",
        "@shukashake/agent"
      ],
      "env": {
        "SHUKA_API_KEY": "<SHUKA_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "shuka": {
      "command": "npx",
      "args": [
        "-y",
        "@shukashake/agent"
      ],
      "env": {
        "SHUKA_API_KEY": "<SHUKA_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I need a key?

Creating shakes, terms and marketplace operations needs an SDK key; verification works without one.

### How do I get a key?

Partners are verified by the vendor; the README gives an email address and a website for applying.

### What do the trust scores mean?

0.8 and above is safe to proceed, 0.6 to 0.8 proceed with caution, below 0.6 needs more verification.

### How much does Shuka cost?

Shuka does not publish prices. Contact the company for a quote.

### How do I add Shuka to Claude Code?

Run this command in your terminal: claude mcp add shuka --env SHUKA_API_KEY='<SHUKA_API_KEY>' -- npx -y @shukashake/agent

### What are the best alternatives to Shuka?

The closest alternatives to Shuka are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Cisa Kev](https://ai-powered.com/mcp/cisa-kev): Cisa Kev is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/shuka
