Agentic Firewall

An intelligent firewall system with agent-based decision making

Agentic Firewall is a lightweight security wrapper that intercepts and validates Model Context Protocol (MCP) tool calls before they reach AI agents like Claude. Think of it as a firewall for your AI coding environment—providing granular access control and visibility into what your AI agents are doing.

The Problem

Recent security research revealed a critical vulnerability in AI coding environments: autonomous AI agents can be compromised when they’re allowed to connect to unverified tools and execute thousands of requests without human oversight. The attack succeeded because there was no “human-in-the-loop” to verify intent before execution.

The Solution

Agentic Firewall prevents these attacks by acting as a security checkpoint. It provides the governance layer needed to safely leverage AI assistance without sacrificing control over your development environment.

Key Features

  • Tool Whitelisting: Only approved tools can be executed
  • Sandbox Enforcement: Restrict file operations to specific directories
  • Path Traversal Protection: Blocks ../ and absolute path attacks
  • Audit Logging: Complete visibility into allowed/blocked requests
  • Zero Latency: Transparent proxying with minimal overhead
  • Policy-Driven: Configure security rules via simple JSON

Architecture

┌─────────────────┐             
│ Claude Desktop  │             
└────────┬────────┘             
         │ JSON-RPC             
         ▼                      
┌─────────────────────────┐     
│ Agentic Firewall        │     
│ (mcp_governor.py)       │     
│                         │     
│  ┌─────────────────┐    │     
│  │ Policy Engine   │    │     
│  │ - Whitelist     │    │     
│  │ - Validation    │    │     
│  │ - Sandbox Check │    │     
│  └─────────────────┘    │     
│         │               │     
│  ┌─────────────────┐    │     
│  │ Audit Logger    │────┼──► threat_log.txt
│  └─────────────────┘    │     
└────────┬────────────────┘     
         │ Filtered Requests    
         ▼                      
┌─────────────────────────┐     
│ MCP Server              │     
│ (filesystem/weather)    │     
└─────────────────────────┘     

Technologies Used

  • Language: Python
  • Protocol: Model Context Protocol (MCP), JSON-RPC
  • Core Concepts: Agent-based Systems, Network Security, Sandboxing