InsForge: A Backend Semantic Layer for Claude Code Agents

InsForge is an open-source project that provides a backend semantic layer for Claude Code agents. It addresses the problem where agents can generate application logic but struggle with messy backend infrastructure across multiple services.

How It Works

The project exposes backend infrastructure as six primitives that Claude agents can interact with through MCP (Model Context Protocol):

• Authentication (users, sessions, auth flows)
• Postgres database
• S3-compatible storage
• Edge/serverless functions
• Model gateway across LLM providers
• Site deployment

Agent Capabilities

With this structured access, Claude Code agents can:

• Fetch backend documentation and available operations
• Configure backend primitives directly
• Inspect backend state and logs
• Reason about how services connect together

Instead of guessing how the backend works, the agent can pull backend context first and then configure infrastructure step by step.

Architecture

The system follows this flow:

Claude Code agent
↓
backend semantic layer
↓
backend primitives (auth / db / storage / functions / deploy)

Example Usage

The creator tested with this prompt to Claude Code:

Set up a backend for a SaaS app with authentication, a Postgres database, file storage, and deployment. Use the available backend primitives and connect them together.

Claude can fetch the backend instructions via MCP and start configuring the system.

Getting Started

To run the project locally:

git clone https://github.com/insforge/insforge.git
cd insforge
cp .env.example .env
docker compose -f docker-compose.prod.yml up

Then connect Claude Code to the MCP server so the agent can access the backend primitives.

The project is open source and available on GitHub at https://github.com/InsForge/InsForge.