Skip to Content
Introduction

auxilia

auxilia is an open-source web MCP client for hosting MCP-powered AI assistants. Built for enterprise deployment, it lets teams share AI agents backed by remote Model Context Protocol  servers.

Why auxilia?

Most MCP clients today are desktop apps tied to a single user. auxilia is different:

  • Web-based — accessible from any browser, no desktop app required
  • Multi-user — share agents across teams and organization members
  • Remote MCP only — designed for production server-to-server MCP connections, not local stdio processes
  • Self-hosted — deploy on your own infrastructure

Architecture

auxilia is composed of three services:

ServiceTechnologyPurpose
BackendFastAPI + LangGraphAgent runtime, MCP client, API
WebNext.js + ReactUser interface
DatabasePostgreSQL + RedisPersistence and token storage
┌─────────────┐ ┌─────────────┐ ┌──────────────────┐ │ Browser │────▶│ Next.js │────▶│ FastAPI │ │ (React) │◀────│ (proxy) │◀────│ (LangGraph) │ └─────────────┘ └─────────────┘ └────────┬─────────┘ ┌────────▼─────────┐ │ Remote MCP │ │ Servers │ └──────────────────┘

Key Concepts

Agents

An agent is an AI assistant configured with a system prompt and a set of MCP server bindings. Each agent can use tools from multiple MCP servers simultaneously.

MCP Servers

auxilia connects to remote MCP servers over HTTP. You can register official pre-configured servers or add custom ones with your own URLs and credentials.

Tool Settings

Each tool exposed by an MCP server can be configured per-agent with one of three states: always allow, needs approval, or disabled.

Supported LLM Providers

ProviderModels
AnthropicClaude Haiku / Sonnet / Opus
OpenAIGPT-4o mini
GoogleGemini 3 Flash / Pro
DeepSeekDeepSeek Chat / Reasoner
LiteLLMAny model via proxy
Last updated on