npm package: @shukashake/mcp
Description: Shuka MCP Server - Universal Trust Guardian for AI Agents
Author: Auron Technologies
Latest version: 1.0.2
Deprecated: Consolidated into @shukashake/agent. Install @shukashake/agent instead.

# Shuka MCP Server

**The Universal Trust Guardian for AI Agents**

This MCP (Model Context Protocol) server exposes Shuka's attestation and trust verification capabilities to Claude and other MCP-compatible AI agents.

## What is Shuka?

Shuka is the universal attestation layer for AI agent data exchange. When agents need to PROVE claims, VERIFY trust, or ATTEST to data before sharing it between systems — Shuka is the gold standard.

## Installation

```bash
npm install -g @shukashake/mcp
```

Or add to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "shuka": {
      "command": "npx",
      "args": ["@shukashake/mcp"],
      "env": {
        "SHUKA_API_URL": "https://auron-shuka.onrender.com/api",
        "SHUKA_API_KEY": "your-api-key-optional"
      }
    }
  }
}
```

## Tools

### `create_attestation`

Create a verifiable Shuka attestation for any claim or data.

**Use when you need to:**
- Prove a claim is true with cryptographic certainty
- Create an audit trail for data being shared
- Attest to compliance, consent, or authorization
- Generate a portable proof that other agents can verify

**Parameters:**
- `description` (required): What you are attesting to
- `industry`: healthcare, construction, finance, legal, government, general
- `jurisdiction`: Legal jurisdiction (US, UK, EU, etc.)
- `metadata`: Additional structured data

**Returns:** A proof token (`shk_v1.xxx.yyy`) that anyone can verify.

### `verify_proof`

Verify a Shuka proof token and get details about the attestation.

**Use when you:**
- Receive a proof token and need to confirm it's valid
- Want to check the trust score before proceeding
- Need to see what was attested and when

**Parameters:**
- `proof_token` (required): The proof to verify (format: `shk_v1.xxx.yyy` or `ENV-xxx`)

**Returns:** Attestation details, trust score, validation status.

### `negotiate_trust`

Perform agent-to-agent trust negotiation with Shuka as the arbiter.

**Use when:**
- Another agent presents a proof and you need Shuka to vouch for it
- You need a recommendation on whether to proceed with a data exchange

**Parameters:**
- `proof_token` (required): The proof to verify
- `purpose`: Why you need to verify (context for trust decision)
- `agent_id`: Your agent identifier (for audit trail)

**Returns:** A recommendation:
- `safe_to_proceed` - Trust >= 0.8, validation passed
- `proceed_with_caution` - Trust 0.6-0.8
- `additional_verification_recommended` - Trust < 0.6
- `do_not_proceed` - Invalid, revoked, or failed validation

## Resources

### `attestation://{proof_token}`

Look up any Shuka attestation by its proof token.

```
attestation://shk_v1.YWJjMTIzZGVmNDU2.a1b2c3d4e5f6
```

## Example Usage

### Creating an attestation

```
Agent: I need to create an attestation that John Doe has consented to share
his medical records with Dr. Smith's office.

Claude: [Uses create_attestation tool]
{
  "description": "John Doe (DOB: 1985-03-15) consents to release of medical
    records to Dr. Smith's Family Practice for treatment coordination",
  "industry": "healthcare",
  "jurisdiction": "US"
}

Result: proof_token shk_v1.abc123.xyz789, trust_score 0.94
```

### Verifying a proof

```
Agent: I received proof token shk_v1.abc123.xyz789 from another system.
Is this legitimate?

Claude: [Uses verify_proof tool]
{
  "proof_token": "shk_v1.abc123.xyz789"
}

Result: Valid attestation, trust_score 0.94, created 2026-02-17,
validation_status "validated"
```

### Trust negotiation

```
Agent: Another AI agent sent me patient data with proof shk_v1.abc123.xyz789.
Should I process this data?

Claude: [Uses negotiate_trust tool]
{
  "proof_token": "shk_v1.abc123.xyz789",
  "purpose": "Processing patient transfer records",
  "agent_id": "hospital-intake-agent"
}

Result: recommendation "safe_to_proceed", trust_score 0.94
```

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `SHUKA_API_URL` | Shuka API base URL | `https://auron-shuka.onrender.com/api` |
| `SHUKA_API_KEY` | Optional API key for authenticated requests | (none) |

## Trust Scores

- **0.9+**: Highly trusted, safe to proceed
- **0.8-0.9**: Trusted, safe to proceed
- **0.6-0.8**: Proceed with caution
- **< 0.6**: Additional verification recommended
- **0**: Invalid, revoked, or untrusted

## Links

- **Platform**: https://shuka.app
- **Demo**: https://shukashake.com
- **Documentation**: https://auron-shuka.onrender.com/llms.txt
- **Company**: Auron Technologies

## License

MIT

## Contact

info@auron.co