aigate MCP server
Commit Nov 5, 2026Provides a self-hosted AI platform with an OpenAI-compatible endpoint for inference, browser automation, code execution, and media processing.
Also known as psyb0t/aigate
- Stars
- 18
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 5, 2026
- License
- WTFPL
What is aigate MCP?
aigate provides a self-hosted AI platform with an OpenAI-compatible endpoint for inference, browser automation, code execution, and media processing.
Summary generated from the project's README
About aigate MCP server
Running a self-hosted AI ecosystem with a single command is what aigate enables for developers needing an all-in-one infrastructure. It provides an OpenAI-compatible endpoint at localhost:4000 that connects to various model providers, including local hardware via Ollama or vllm-wrap and cloud services like Groq or OpenRouter. The platform acts as a central hub where any function-calling model can autonomously orchestrate complex workflows using a wide array of integrated tools.
Users can deploy specific capabilities through opt-in containers, such as a stealth browser cluster for bypassing bot detectors, sandboxed code execution via Piston, or advanced media processing. The system includes specialized tools for audio production with audiolla, video editing with flickies, and time-series forecasting with predictalot. It also manages communication through a Telegram client and an email gateway. This setup is designed for those who want to combine local privacy with high-level agentic capabilities like web searching, image generation, and typed decision-making.
What you can do with it
- 1Automated web researchAsk a model to research a topic by having it open a browser, read pages, and summarize findings.
- 2Deterministic code computationUse the execute_code tool to perform complex calculations or data transformations in a secure sandbox.
- 3Advanced audio and video editingInstruct an agent to perform stem separation, face restoration, or lip-syncing on media files.
- 4Predictive data analysisHand off time-series data to the platform to generate forecasts using foundation models.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablepsyb0t/aigate is public and reachablegithub.com/psyb0t/aigate ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)WTFPL is not OSI-approvedspdx.org/licenses/WTFPL.html ↗Finding
- Commit or release in the last yearLast commit or release 2026-11-05github.com/psyb0t/aigate ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubaigate
A self-hosted AI platform. One docker-compose up.
Everything an AI-powered workflow needs, inference, tool use, browser automation, image generation, speech synthesis, transcription, object storage, agentic code execution, web search, an email gateway, a Telegram client, time-series forecasting, typed decisions, an async job queue, and a web UI, behind a single OpenAI-compatible endpoint at http://localhost:4000. Point any existing client at it and it works.
Models and routing
Models across multiple providers. Five providers offer free tiers (Groq, OpenRouter, HuggingFace, Mistral, Cohere). Free means rate-limited and capped, not unlimited. Cerebras needs a paid plan as of the last audit. See free-tier reality check for exact RPM/RPD/monthly caps before relying on a tier. Local providers run on your own hardware, CPU or NVIDIA GPU, with no network calls, rate limits, or usage costs. They include Ollama, talkies for ASR and TTS, vllm-wrap for text LLMs and embeddings, llama.cpp for Surya OCR 2 and Qwen3-8B embeddings, stable-diffusion.cpp, audiolla, predictalot, and decidealot. The gateway tries providers in priority order and falls back when one rate-limits or fails.
Tools and capabilities
MCP tools across multiple servers. Any model with function calling can invoke them autonomously — the model orchestrates, you just prompt.
- Stealth browser cluster — 5 Camoufox replicas behind HAProxy, real OS-level mouse and keyboard input, zero CDP exposure. Passes Cloudflare, CreepJS, BrowserScan, and every other bot detector we've thrown at it.
- Two agentic coding agents — full shell access, persistent workspaces, file I/O, tool use. Claude Code (your subscription or API key) and pi-coding-agent pointed at z.ai for GLM models. Both expose REST API, OpenAI-compatible endpoint, and MCP server.
- Sandboxed code execution — piston at
/piston/. Multi-language code execution in nsjail-isolated sandboxes (own user namespace, chroot, seccomp, cgroups, no network). Default install: Python + Node. Add Bash / Deno / Go / Rust / TypeScript / 40+ other languages viaPISTON_LANGUAGES+ rebuild. REST API +execute_codeMCP tool any function-calling LLM can call to compute deterministic results (hashes, parses, transforms) instead of guessing. - Object storage — S3-compatible, public-read uploads, presigned URLs, auto-expiry. Plain HTTP and boto3.
- Image generation — FLUX, DALL-E, Stable Diffusion (cloud + local CPU/CUDA via stable-diffusion.cpp) via MCP tools that return persistent URLs, not base64 blobs. Local CPU: sd-turbo, sdxl-turbo. Local CUDA adds: sdxl-lightning, flux-schnell, juggernaut-xi.
- Text-to-speech — Kokoro (CPU + CUDA-ONNX, English+Chinese, voice presets), Qwen3-TTS (CUDA, voice cloning + voice-design + emotion control via the
instructionsfield), OpenAI TTS. - Transcription — Whisper (cloud + local CPU/CUDA), Parakeet (~3400× real-time on CPU).
- Web search — SearXNG self-hosted meta-search (Google, Bing, DuckDuckGo, Wikipedia) via MCP
search_webtool. - Telegram client — Telethon at
/telethon/. Send/read/edit/delete messages, list dialogs, forward, send files from URL, manage group membership. REST API + MCP tools. - Email gateway, mailbox at
/mailbox/. IMAP+SMTP across N accounts from one YAML config, unified inbox, per-account list/search/CRUD, SMTP send. REST API + flat MCP tool set (mailboxparameter selects account). - Time-series forecasting + tabular ML — predictalot at
/predictalot/. Five foundation forecasters (chronos-2, timesfm-2.5, moirai-2, toto-1, sundial-base-128m) across six forecast types (univariate, multivariate, past/future covariates, samples) with per-type weighted ensembles at/v1/timeseries/<type>/…+ a sibling/v1/tabular/*family in v1.0.0 — 9 supervised backends (lightgbm, xgboost, hist-gbt, random-forest, logistic, mlp, svm-rbf, knn, naive-bayes) and 3 meta-learners (calibrated / stacking / diversified). REST API for both families + 27 MCP tools (foundation-model forecasting plusunload_models, tabular is REST-only). CPU or CUDA. - Typed decisions: decidealot at
/decidealot/. Local Laya, Von, and CLM are enabled by default. Hosted TypeSafe Jev enables when its key is configured. Send astateplus namedchoice,score, ornoulquestions and get typed answers with model probabilities, so the caller sets its own threshold. Laya routes between English and multilingual checkpoints and has a checkpoint tuned for policy, routing, and triage decisions. Von is English-only, for short questions with clear criteria. CLM calls AIGate's internal Qwen3-8B embeddings route;make run-bgstarts its CUDA encoder automatically. SetDECIDEALOT_CLM_ENABLED=falseto remove that GPU dependency. REST API, batch decisions, and 4 MCP tools. CPU or CUDA. - Audio production — audiolla at
/audiolla/. Stem separation (Demucs / UVR), restoration (UVR de-reverb / de-echo / de-noise), mastering (matchering / pedalboard chains + curated presets likemaster-for-spotify,podcast-cleanup,vocal-cleanup), MIR analysis (BPM / key / LUFS / beats / onsets / melody / chords / segments), DSP transforms (sox + ffmpeg), loudness normalization, speech enhancement (DeepFilterNet), VAD (silero), diarization (pyannote), CLAP embeddings + zero-shot classification, AudioSet tagging (AST), audio→MIDI (basic-pitch), MIDI compose / inspect / transform / render via fluidsynth, text-to-audio generation (stable-audio-open / musicgen / riffusion / audioldm2 — CUDA only), ad-hoc op-chain pipelines, async jobs + webhooks. REST API + MCP tools. v1.0+ contract: JSON body on every audio endpoint, raw bytes only atPUT /v1/files/{path},output_pathxoroutput_urlmandatory for any audio-producing call. - Video toolkit — flickies at
/flickies/. Lipsync via LatentSync 1.5 (ByteDance, Apache-2.0, ~8 GB VRAM, default on CUDA) and Wav2Lip / Wav2Lip-GAN (LRS2 non-commercial, gated). Face restore via GFPGAN v1.4. ffmpeg ops — trim, concat, transcode (incl. gif + fps + codec change), scale, mux audio, extract audio, thumbnail grid. ffprobe info. Async jobs + webhooks. REST API + 11 MCP tools. Same JSON-body +output_pathxoroutput_urlcontract as audiolla. GFPGAN + LatentSync 1.5 are CUDA-only; CPU image runs ffmpeg ops + slow Wav2Lip-CPU.
Ask a Groq model to research something and it opens a browser, reads pages, screenshots them, uploads to storage, and comes back with a summary and links. The model decides what tools to use and in what order.
Web UI
LibreChat at /librechat/ — pre-configured with all models and MCP tools, conversation history, file uploads, WebSocket streaming. Email/password auth, first user becomes admin.
Infrastructure
Multiple containers. Nginx reverse proxy. PostgreSQL + MongoDB for persistence. Two Redis instances (cache + browser session sync). Async job queue for long-running inference. Cloudflare Tunnel for public exposure with zero open ports.
Security
Network-isolated by default — internal services have no host ports. Every endpoint requires auth. Application containers carry no-new-privileges:true (genuine carve-outs: piston needs privileged:true for nsjail; tailscale needs NET_ADMIN for the userspace tun device). File path pre-flight validation on startup.
Everything is opt-in
Enable what you want in .env, ignore what you don't. The core stack (nginx, LiteLLM, PostgreSQL, Redis, proxq) is always on. Every provider, local model, MCP server, and extra service is a flag flip away.
make run-bg. That's the whole install.
Architecture
client
▼
cloudflared (CLOUDFLARED=1) │ tailscale (TAILSCALE=1, tailnet-only)
▼
nginx :4000 ┌──────────── always on ────────────┐
├─► /claudebox/ → claudebox │ nginx, LiteLLM, PostgreSQL, Redis │
├─► /pibox-zai/ → pibox-zai │ proxq — everything else is opt-in │
├─► /pibox/ → pibox │ │
├─► /stealthy-auto-browse/ → HAProxy → [browser ×5]└───────────────────────────────────┘
├─► /storage/ → hybrids3
├─► /q/ → proxq → LiteLLM (async, returns job ID)
├─► /librechat/ → LibreChat (web UI, LIBRECHAT=1)
├─► /searxng/ → SearXNG (meta-search, SEARXNG=1)
├─► /telethon/ → Telethon (Telegram client, TELETHON=1)
├─► /predictalot/ → predictalot (time-series forecasting, CPU, PREDICTALOT=1)
├─► /predictalot-cuda/ → predictalot (time-series forecasting, NVIDIA GPU, PREDICTALOT_CUDA=1)
├─► /decidealot/ → decidealot (typed decisions REST + MCP, CPU, DECIDEALOT=1)
├─► /decidealot-cuda/ → decidealot (typed decisions REST + MCP, NVIDIA GPU, DECIDEALOT_CUDA=1)
├─► /audiolla/ → audiolla (audio-production REST + MCP, CPU, AUDIOLLA=1)
├─► /audiolla-cuda/ → audiolla (audio-production REST + MCP, NVIDIA GPU, AUDIOLLA_CUDA=1)
├─► /flickies/ → flickies (video toolkit REST + MCP, CPU, FLICKIES=1)
├─► /flickies-cuda/ → flickies (video toolkit REST + MCP, NVIDIA GPU, FLICKIES_CUDA=1)
├─► /mailbox/ → mailbox (IMAP+SMTP gateway, MAILBOX=1)
├─► /piston/ → piston (sandboxed multi-language code execution, PISTON=1)
└─► / → LiteLLM (sync)
├─ Groq (free: 30 RPM, 1K-14.4K RPD per model, GROQ=1)
├─ Cerebras (paid plan required, CEREBRAS=1)
├─ OpenRouter (free: 50 RPD $0 / 1K RPD with $10+, OPENROUTER=1)
├─ HuggingFace (free: $0.10/mo credits — eval only, HUGGINGFACE=1)
├─ Mistral (free "Experiment" tier — exact limits not published, MISTRAL=1)
├─ Cohere (trial: 1K calls/MONTH — runs out fast, COHERE=1)
├─ Ollama CPU (local, OLLAMA=1)
├─ Ollama CUDA (local, NVIDIA, OLLAMA_CUDA=1)
├─ Talkies CPU (local, unified ASR + Kokoro TTS, TALKIES=1)
├─ Talkies CUDA (local, NVIDIA, full ASR + Kokoro + Qwen3-TTS voice cloning, TALKIES_CUDA=1)
├─ sd.cpp CPU (local, image gen, SDCPP=1)
├─ sd.cpp CUDA (local, image gen, SDCPP_CUDA=1)
├─ vLLM CPU (local, text LLM + embeddings, VLLM=1)
├─ vLLM CUDA (local, NVIDIA, text LLM + embeddings, VLLM_CUDA=1)
├─ llama.cpp CPU (local, GGUF + vision-VLM incl. Surya OCR 2, LLAMACPP=1)
├─ llama.cpp CUDA (local, NVIDIA, Surya OCR 2 + Qwen3-8B embeddings, LLAMACPP_CUDA=1)
├─ claudebox (subscription, CLAUDEBOX=1)
├─ pibox-zai (subscription, PIBOX_ZAI=1)
├─ pibox (this stack's own models, PIBOX=1)
├─ Anthropic (pay-per-token, ANTHROPIC=1)
└─ OpenAI (pay-per-token, OPENAI=1)
MCP servers (all optional):
├─ stealthy_auto_browse — run_script: multi-step browser automation (BROWSER=1)
├─ hybrids3 — file upload, download, list, delete, presign (HYBRIDS3=1)
├─ claudebox — agentic Claude Code via OAuth or API key (CLAUDEBOX=1)
├─ pibox_zai — agentic pi-coding-agent via z.ai/GLM (PIBOX_ZAI=1)
├─ mcp_tools — generate_image + generate_tts + search_web + execute_code (auto-enabled when HuggingFace, OpenAI, talkies[-cuda], sd.cpp[-cuda], or SearXNG is active — PISTON=1 alone does NOT enable it; execute_code only appears once mcp_tools is already active for one of those other reasons)
├─ telethon — Telegram send/read/edit messages, dialogs, files, group management (TELETHON=1)
├─ predictalot — time-series forecasting via 5 foundation models × 6 type-routed endpoints + per-type ensemble (PREDICTALOT=1 and/or PREDICTALOT_CUDA=1)
├─ decidealot typed decisions with Laya, Von, CLM, and hosted Jev via system_one, system_one_batch, list_models, unload_models (DECIDEALOT=1 and/or DECIDEALOT_CUDA=1)
├─ audiolla — audio-production: stem separation, restoration, mastering, MIR, DSP, loudness, speech enhancement, diarization, MIDI compose + render, workflow presets + ad-hoc pipelines (AUDIOLLA=1 / AUDIOLLA_CUDA=1)
├─ flickies — video toolkit: lipsync (LatentSync 1.5 + Wav2Lip), face restore (GFPGAN), ffmpeg ops — trim/concat/transcode/scale/mux_audio/extract_audio/thumbnail_grid (FLICKIES=1 / FLICKIES_CUDA=1)
├─ mailbox — IMAP+SMTP gateway: inbox, list/search/send across N accounts (MAILBOX=1)
└─ piston (via mcp_tools) — execute_code: sandboxed multi-language code execution via nsjail (requires PISTON=1 AND mcp_tools already active per above — hosted by the mcp_tools aggregator, not a standalone MCP server)
Most persistent data lives under .data/ by default (bind mounts). Override the base with DATA_DIR or per-service with DATA_DIR_* env vars (e.g. DATA_DIR_OLLAMA=/mnt/nas/ollama), see .env.example for the full list. The default directory structure is tracked in git via .gitkeep files so the right directories exist on a fresh clone, contents are gitignored.
Default writable locations:
Mailbox also uses the mailbox-state named volume for its SQLite audit log, send limits, checkpoints and webhook delivery state. Back up that volume alongside the account config. Read the Mailbox migration notes and browser migration notes before upgrading older deployments.
| Path | Used by | Notes |
|---|---|---|
.data/claudebox/config/.always-skills/ |
claudebox | Drop <name>/SKILL.md files here — injected into every Claude session automatically |
.data/claudebox/workspace/ |
claudebox | Persistent task workspaces |
.data/pibox-zai/config/ |
pibox-zai | pi config dir (telegram.yml, cron history, etc.) |
.data/pibox-zai/workspace/ |
pibox-zai | Persistent workspace root (subdirs per task) |
.data/pibox/config/ |
pibox | pi config dir for the stack-backed agent |
.data/pibox/workspace/ |
pibox | Persistent workspace root (subdirs per task) |
.data/hybrids3/ |
hybrids3 | Object storage data |
.data/nginx/ |
nginx-auth-init | Generated htpasswd (from LITELLM_UI_BASIC_AUTH) |
.data/ollama/ |
ollama, ollama-cuda | Downloaded model weights (shared — CPU and CUDA instances read the same blobs) |
.data/talkies/ |
talkies, talkies-cuda | HuggingFace cache for all talkies models (Whisper × 3, Parakeet, Canary × 3, Kokoro). Shared between CPU and CUDA; CPU image loads a subset, CUDA loads the full set. |
.data/talkies-voices/ |
talkies-cuda | User-supplied Qwen3-TTS reference voices — drop <name>.wav (10-30s clean speech) and use as voice=<name> on /v1/audio/speech (nested paths supported) |
.data/sdcpp/models/ |
sdcpp, sdcpp-cuda | Downloaded stable-diffusion model weights (shared between CPU and CUDA) |
.data/librechat/ |
librechat, librechat-mongodb | Conversation data (MongoDB), file uploads |
.data/cloudflared/ |
cloudflared | Tunnel config and credentials (if using named tunnel) |
.data/tailscale/ |
tailscale | Tailscale node state (machine key, DERP info) — auto-created on first run |
.data/predictalot/models/ |
predictalot, predictalot-cuda | Downloaded HuggingFace snapshots for the 5 forecasters (~1.4GB total) |
.data/decidealot/models/ |
decidealot, decidealot-cuda | Enabled Laya, Von, and CLM model bundles, downloaded on first start. Must be owned by DECIDEALOT_UID/GID (default 1000) |
.data/audiolla/ |
audiolla, audiolla-cuda | Demucs weights (~6GB) + UVR models + torch hub + staged files (bind-mounted as /data; CPU and CUDA variants share the same cache) |
.data/flickies/ |
flickies, flickies-cuda | Model weights (~6GB total: S3FD + Wav2Lip ×2 + GFPGAN v1.4 + LatentSync 1.5) + staged file uploads (bind-mounted as /data; CPU and CUDA variants share the same cache) |
.data/vllm/models/<org>/<repo>/ |
vllm, vllm-cuda, vllm-pull | Flat HF-repo layout (no blobs/snapshots dedup) — vllm-pull populates via huggingface-cli download --local-dir. Shared by CPU and CUDA wrappers and by any other service that mounts the same dir. Default: Nomic embed v2 + Qwen3-0.6B. |
.data/mailbox/ |
mailbox | Recommended host path for the mailbox YAML config (config.yaml — gitignored, holds plaintext IMAP/SMTP creds) |
aigate MCP questions
Does it support local models?
Yes, it supports local providers like Ollama, vLLM, and llama.cpp running on your own CPU or NVIDIA GPU.
Can I use it with existing AI clients?
Yes, it provides an OpenAI-compatible endpoint that allows you to point any existing client at it.
Is the browser automation detectable?
No, it uses a stealth browser cluster with real OS-level input that passes major bot detectors.