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

npm install -g @shukashake/mcp

Or add to your Claude Desktop configuration:

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

[email protected]