Repository avatar
AI Tools
v0.1.0
active

kavach-kya

io.github.srigenmedia/kavach-kya

Zero-custody agentic spend firewall with <50ms kill-switch, 1-tap 2FA holds & audit hash chains.

Documentation

Kavach KYA (io.github.srigenmedia/kavach-kya)

mcptry

Sovereign Agentic Spend Firewall & Streamable HTTP MCP Guard (https://kavach.srigenmedia.com)

Kavach KYA is a zero-custody (₹0.00 customer funds held) horizontal B2B Know-Your-Agent (KYA) spend firewall for autonomous AI agents, 402-in-a-Box gateways, and Model Context Protocol (MCP) tool servers.


Core Capabilities

  • Streamable HTTP /mcp Endpoint (https://kavach.srigenmedia.com/mcp):
    • kavach_check_spend_policy — Evaluates canonical 5-tuples [asset_or_currency, kya_agent_id, merchant_vpa_or_recipient, amount_minor_or_units, eligibility_flag] against velocity limits, merchant allowlists, and prompt-injection guards.
    • kavach_get_agent_status — Inspects live eligibility_flag (0/1), daily velocity spend, and pending 2FA holds.
    • kavach_trigger_kill_switch — Atomically flips eligibility_flag = 0 in < 50ms via Cloudflare SQLite Durable Objects (KyaSpendCoordinatorDO) and propagates revocation to 402-in-a-Box (PUT /api/admin/kya/agents/:id/eligibility).
  • Hibernatable 15-Minute 2FA Holds & 1-Tap Webhooks: Velocity/amount breaches enter AWAITING_HUMAN_2FA with 15-minute Durable Object alarm() expiry and constant-time HMAC-SHA256 verified Slack (X-Slack-Signature) and WhatsApp Business (X-Hub-Signature-256) 1-tap callbacks.
  • Tamper-Evident Audit Hash Chain: Every decision appends a SHA-256 hash-chained receipt (prev_receipt_hash -> receipt_hash) with verified bank/gateway UTR/RRN proofs and zero raw PII.
  • Zero-Custody & Indian Regulatory Safe-Harbor: Holds ₹0.00 customer funds; B2B SaaS plans are billed under SAC 998315 (18% GST INR) or 0% Export LUT (USD).

Quick MCP Client Configuration

{
  "mcpServers": {
    "kavach-kya": {
      "type": "streamable-http",
      "url": "https://kavach.srigenmedia.com/mcp",
      "headers": {
        "Authorization": "Bearer ${KAVACH_OPERATOR_JWT}"
      }
    }
  }
}

See docs/402-in-a-box-connector.md for the complete 5-minute HTTP & webhook integration guide and SECURITY.md for our fail-closed security architecture.