# Supernova MCP Gateway & Shield

> Supernova MCP Gateway & Shield is an open-source MCP server for security. Open-source local firewall and daily spend cap for MCP servers used in Claude, Cursor. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API, macOS, Windows, Linux
- **Website:** https://supernova.cool/open
- **Repository:** https://github.com/ghazwanalemara/supernova-shield
- **MCP Registry name:** io.github.GhazwanAlemara/supernova
- **Categories:** [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-19

## About

The README describes supernova-shield as a Node-based proxy that sits between an AI client and any MCP server it wraps, inspecting traffic on stdio before it reaches the tool. Its stated checks cover prompt-injection patterns, SSRF attempts against cloud metadata endpoints, and secret leakage, alongside a daily budget circuit breaker that stops runaway tool calls.

The project is aimed at developers who run MCP servers locally and want guardrails without sending prompts or tool arguments to a third party. Configuration is a single command wrapper in the client's mcp.json file, and the tool also offers a scan command for testing individual payloads and a demo command that runs its built-in attack tests.

The same brand also runs a hosted gateway and a creator marketplace on supernova.cool, which offer paid features such as deeper screening, team audit logs and per-call billing. The free community key adds marketplace credits and threat rule sync, and those services are separate from the open-source package.

## Features

- **Local prompt injection blocking:** Screens prompts and tool arguments for injection patterns before they reach the wrapped MCP server.
- **SSRF and secret leak detection:** Flags attempts to reach cloud metadata endpoints and payloads containing secrets such as .env values.
- **Daily spend-cap circuit breaker:** Halts tool calls once a configured daily budget in USD is reached.
- **Hash-chained audit log:** Records events to a local JSONL file where each entry is SHA-256 linked to the previous one.
- **One-line client wrapping:** Wraps any stdio MCP server through a single npx command placed in the client configuration.

## Good for

- Protecting a filesystem MCP server in Claude Desktop from reading private key files
- Capping daily spend when an agent in Cursor calls paid tools in a loop
- Testing how a payload would be handled before enabling a new MCP server
- Keeping prompts and tool arguments on a developer machine for privacy reasons

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http supernova https://supernova.cool/api/v1/mcp/
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://supernova.cool/api/v1/mcp/
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "supernova": {
      "url": "https://supernova.cool/api/v1/mcp/"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "supernova": {
      "type": "http",
      "url": "https://supernova.cool/api/v1/mcp/"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "supernova": {
      "serverUrl": "https://supernova.cool/api/v1/mcp/"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://supernova.cool/api/v1/mcp/
```

Enter a Name (for example "Supernova MCP Gateway & Shield"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "supernova": {
      "type": "http",
      "url": "https://supernova.cool/api/v1/mcp/"
    }
  }
}
```

## FAQ

### Does the open-source package send data to a cloud service?

The README says it runs 100% locally and that prompts and tool arguments never leave the machine. The audit log is stored locally at ~/.supernova-shield/audit.jsonl.

### What license is supernova-shield released under?

The README's comparison table lists supernova-shield as Apache-2.0.

### Which clients are named as supported?

The README names Claude Desktop, Cursor, Windsurf and LangChain as the clients it runs in front of.

### What does the free community key add?

According to the README, the free community key adds $5 in marketplace credits and live threat rule sync, while the local checks remain unlimited without it.

### Is Supernova MCP Gateway & Shield free?

Yes. Supernova MCP Gateway & Shield is open source, so you can use and self-host it for free.

### How do I add Supernova MCP Gateway & Shield to Claude Code?

Run this command in your terminal: claude mcp add --transport http supernova https://supernova.cool/api/v1/mcp/

### What are the best alternatives to Supernova MCP Gateway & Shield?

The closest alternatives to Supernova MCP Gateway & Shield are Enterprise MCP Gateway, MCP Behave, MCP security checks — WARDEN and HISTOR, mcp-audit and Dmcps.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Enterprise MCP Gateway](https://ai-powered.com/mcp/enterprise-mcp-gateway): Enterprise MCP Gateway is a freemium MCP server for security.
- [MCP Behave](https://ai-powered.com/mcp/mcp-behave): MCP Behave is an open-source MCP server for security.
- [MCP security checks — WARDEN and HISTOR](https://ai-powered.com/mcp/mcp-security-checks-warden-and-histor): MCP security checks — WARDEN and HISTOR is a free MCP server for security.
- [mcp-audit](https://ai-powered.com/mcp/mcp-audit-4): mcp-audit is an MCP server for security.
- [Dmcps](https://ai-powered.com/mcp/dmcps): Dmcps is an open-source MCP server for security.
- [Wass MCP](https://ai-powered.com/mcp/wass-mcp): Wass MCP is an open-source MCP server for security.
- [KillerSkills](https://ai-powered.com/mcp/killerskills): KillerSkills is a freemium MCP server for security.
- [mcp-keyscan](https://ai-powered.com/mcp/mcp-keyscan): mcp-keyscan is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/supernova-mcp-gateway-and-shield
