Skip to main content
Glama
README.md
# Kavach KYA (`io.github.srigenmedia/kavach-kya`)

[![mcptry](https://mcptry.com/badge/io.github.srigenmedia/kavach-kya)](https://mcptry.com/servers/io.github.srigenmedia/kavach-kya)

**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

```json
{
  "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](docs/402-in-a-box-connector.md) for the complete 5-minute HTTP & webhook integration guide and [SECURITY.md](SECURITY.md) for our fail-closed security architecture.