suprawall

The security gateway for AI agents. Enforce authentication, rate limiting, and policy controls between users and AI agents — in one line of code.

Install

npm install suprawall-sdk

Quickstart

Get your free API key at https://www.supra-wall.com/

import { withSupraWall } from "suprawall-sdk";

const secured = withSupraWall(myAgent, {
  apiKey: "ag_your_key_here",
});

// Use exactly like before — every tool call is now policy-checked
await secured.executeTool("delete_file", { path: "/etc/passwd" });

MCP middleware

import { createSupraWallMiddleware } from "suprawall";

const gate = createSupraWallMiddleware({ apiKey: "ag_your_key_here" });

server.setRequestHandler(CallToolRequestSchema, async (req) => {
  return gate(req.params.name, req.params.arguments, () =>
    myToolHandler(req)
  );
});

Fail-open vs Fail-closed

// Development default — allow if SupraWall unreachable
withSupraWall(agent, { apiKey: "ag_xxx", onNetworkError: "fail-open" });

// Production recommended — block if SupraWall unreachable
withSupraWall(agent, { apiKey: "ag_xxx", onNetworkError: "fail-closed" });

Policy decisions

| Decision | Behaviour | | -------- | --------- | | ALLOW | Tool executes normally | | DENY | Tool blocked, error returned to agent | | REQUIRE_APPROVAL | Tool paused, human approves in dashboard |

Layer 2: AI Semantic Analysis

If your organization is on Team tier or above, the evaluate response may include additional fields from SupraWall's AI semantic analysis layer. Layer 2 runs server-side and requires no SDK changes.

| Field | Type | Tier | Description | | ----- | ---- | ---- | ----------- | | semanticScore | number (0-1) | Team+ | AI-assessed threat score | | semanticFlag | boolean | Team+ | True if flagged but allowed | | semanticReasoning | string | Team+ | LLM explanation of assessment | | anomalyScore | number (0-1) | Business+ | Behavioral deviation from baseline |

SupraWall Connect (multi-tenant)

If you are a SaaS platform managing agents for your customers, use Connect sub-keys (agc_ prefix) to enforce per-customer policies.

Links

Dashboard: https://www.supra-wall.com/ GitHub: https://github.com/wiserautomation/suprawall Issues: https://github.com/wiserautomation/suprawall/issues