Introduction

Self-hosted Agent Protocol server. Your infrastructure, your rules.

Aegra is an open-source, self-hosted Agent Protocol server that lets you run AI agents on your own infrastructure. It’s a drop-in replacement for LangSmith Deployments — same SDK, same APIs, no vendor lock-in. Read why teams choose Aegra over managed platforms, or jump straight to the migration guide if you’re switching.

Before you begin

Using an AI coding tool? Copy the prompt below to add the Aegra skill and MCP server for better results when building with Aegra.

Show Install the Aegra skill and MCP server

Install the Aegra skill to get context on project structure, configuration, and best practices:

npx skills add https://docs.aegra.dev

Then add the Aegra MCP server for access to documentation search. Follow the setup instructions for your tool:

Claude Code

claude mcp add --transport http aegra-docs https://docs.aegra.dev/mcp

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "aegra-docs": {
      "url": "https://docs.aegra.dev/mcp"
    }
  }
}

VS Code

Add to your .vscode/mcp.json:

{
  "servers": {
    "aegra-docs": {
      "type": "http",
      "url": "https://docs.aegra.dev/mcp"
    }
  }
}

llms.txt

Feed https://docs.aegra.dev/llms.txt to any LLM for full docs context.

What Aegra does

Aegra gives you a production-ready server for running LangGraph agents with full persistence, streaming, and authentication. You bring your own PostgreSQL database and keep complete control over your data.

Agent Protocol

Works with Agent Chat UI, LangGraph Studio, and CopilotKit out of the box.

Self-hosted

Run on your own infrastructure with your own PostgreSQL database. No external dependencies.

Same SDK

Use the LangGraph SDK you already know. Switch from LangSmith Deployments with zero code changes.

Open source

Apache 2.0 licensed. Inspect, modify, and contribute to the codebase.

How it compares

	LangSmith Deployments	Aegra
Deploy agents	Local dev only (Free), paid cloud (Plus)	Free, unlimited
Custom auth	Not available (Free), available (Plus)	Python handlers (JWT/OAuth/Firebase)
Self-hosted	Enterprise only (license key required)	Always (Apache 2.0)
Own database	Managed only (Free/Plus), bring your own (Enterprise)	Bring your own Postgres
Tracing	LangSmith only	Any OTLP backend (Langfuse, Phoenix, etc.)
Data residency	LangChain cloud (Free/Plus), your infrastructure (Enterprise)	Your infrastructure
SDK	LangGraph SDK	Same LangGraph SDK

Based on LangChain pricing as of February 2026. An enterprise tier with self-hosting is also available at custom pricing. See the full feature support matrix for what Aegra supports today.

Key features

• Human-in-the-loop — Approval gates and user intervention points
• Streaming — Real-time responses with network resilience
• Persistent state — PostgreSQL checkpoints via LangGraph
• Configurable auth — JWT, OAuth, Firebase, or none
• Observability — Fan-out tracing via OpenTelemetry to multiple backends
• Semantic store — Vector embeddings with pgvector
• Custom routes — Add your own FastAPI endpoints alongside the Agent Protocol API

Next steps

Quickstart

Get a running server in under 5 minutes.

Build your first agent

Hands-on tutorial from zero to a working agent.

Installation

All the ways to install and run Aegra.

Why Aegra

Cost comparison and feature highlights.

Migrate from LangSmith

Step-by-step guide to switching from LangSmith Deployments.