Preloop

by preloop

334 downloads
Not rated
GitHub

About

Preloop is the MCP Governance Layer. Add approval gates to AI tool calls. Intercept risky actions, collect human decisions, and keep an audit trail.

Details

Author
preloop
Downloads
334
Categories
Cloud Service, Automation, AI, Other, Security

- Event-driven automation with AI agents responding to tool events
- Human-in-the-loop safety intercepting sensitive operations for approval
- Built-in MCP server with 6 tools and JWT authentication
- Tool management and proxying of external MCP servers
- Issue tracker integration (Jira, GitHub, GitLab) with continuous sync
- Vector search and automated duplicate detection
- Compliance metrics and improvement recommendations
- Modern web UI built with Lit, Vite, and Shoelace Web Components

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Preloop
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, create a Python virtual environment (3.11+), install dependencies, set up PostgreSQL 14+ with PGVector, and configure environment variables in .env. Start the API server with ./start.sh and the sync service with preloop-sync scan all. Alternatively, deploy with Docker Compose or a Helm chart for Kubernetes.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "preloop": {
            "preloop": {
                "url": "https://preloop.ai/mcp/v1",
                "transport": "http-streaming",
                "headers": {
                    "Authorization": "Bearer YOUR_API_KEY_HERE"
                }
            }
        }
    }
}

McpServers

{
    "preloop": {
        "url": "https://preloop.ai/mcp/v1",
        "transport": "http-streaming",
        "headers": {
            "Authorization": "Bearer YOUR_API_KEY_HERE"
        }
    }
}

Preloop Logo Preloop - The MCP Governance Layer

License
Python 3.11+

Overview

Preloop is an open-source, event-driven automation platform with built-in human-in-the-loop safety. AI agents respond to events across your tools automatically. When agents call sensitive operations, Preloop intercepts the request and routes it for human approval.

Preloop acts as an MCP proxy and can be integrated in existing workflows without any infrastructure changes.

Key Features

Core Platform (Open Source)

- Event-Driven Automation: AI agents respond to events across your tools automatically
- Human-in-the-Loop Safety: Intercept sensitive operations and route for human approval
- MCP Server: Standards-based Model Context Protocol (MCP) server
- 6 built-in tools: get_issue, create_issue, update_issue, search, estimate_compliance, improve_compliance
- JWT authentication with per-user tool visibility
- StreamableHTTP transport for Claude Code and other MCP clients
- Tool Management: Configure and manage tool access
- Support for external MCP servers and tool proxying
- Basic approval workflows (single-user) with email + mobile app notifications
- Agentic Flows: Event-driven workflows triggered by issue tracker events
- Issue Tracker Integration: Jira, GitHub, GitLab support with continuous sync
- Vector Search: Intelligent similarity search using embeddings
- Duplicate Detection: Automated detection of duplicate and overlapping issues
- Compliance Metrics: Evaluate issue compliance and get improvement recommendations
- Web UI: Modern interface built with Lit, Vite, and Shoelace Web Components

> Looking for Enterprise features? Preloop Enterprise Edition adds RBAC, team-based approvals, advanced audit logging, and more. See Enterprise Features below.

Open Source vs Enterprise (important)

- Open Source: single-user approvals with email + mobile app notifications.
- Enterprise: adds advanced conditions (CEL), team-based approvals (quorum), escalation, and Slack & Mattermost notifications.
- Mobile & Watch apps: the iOS/Watch and Android apps can be used with self-hosted / open-source Preloop deployments.

Supported Issue Trackers

- Jira Cloud and Server
- GitHub Issues
- GitLab Issues
- (More to be added in future releases, including Azure DevOps and Linear)

Architecture

Preloop is designed with a modular architecture:

1. Preloop (./backend/preloop): The main RESTful HTTP API server that provides access to issue tracking systems and vector search capabilities.
2. Preloop Models (./backend/preloop/models): Contains the database models (using SQLAlchemy and Pydantic) and CRUD operations for interacting with the PostgreSQL database, including vector embeddings via PGVector.
3. Preloop Sync (./backend/preloop/sync): A service responsible for polling configured issue trackers, indexing issues, projects, and organizations in the database, and updating issue embeddings.
4. Preloop Console (./frontend): A web application built using Lit, Vite, TypeScript, and Shoelace Web Components.

This structure allows:
- Clear separation of concerns between the API layer, data models, and synchronization logic.
- Independent development and versioning of the core components.

Preloop Console

The Preloop Console is in the frontend directory. It is built using modern web technologies to provide a fast, responsive, and feature-rich user experience.

- Technology Stack: Lit, Vite, TypeScript, and Material Web Components.

Installation

Prerequisites

- Python 3.11+
- PostgreSQL 14+
- PGVector extension for PostgreSQL (for vector search capabilities)

Local Setup

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.