Command Palette

Search for a command to run...

UnylyUnyly
Homehow-to120sintermediateUpdated: Aug 10, 2026

How to Deploy an MCP Server or AI Agent from GitHub

Host an MCP server or an AI agent straight from a GitHub repo at <slug>.unyly.org. Auto-deploy on push, bring your own model key as an env var, streaming and long timeouts included. No VPS, no Dockerfile.

▸ TL;DR

The simplest path: open Unyly catalog, find the MCP you need, and hit the one-click install button — no JSON editing required. Unyly auto-detects your client and generates the right config.

Steps

  1. 01

    Push your agent or MCP to GitHub

    Any Node or Python project works: an MCP server (stdio is fine) or an AI agent / chat app that calls a model. No Dockerfile needed — Unyly generates one.

  2. 02

    Connect the repo on Unyly Deploy

    Open deploy.unyly.org, pick the repo (private repos work after connecting GitHub) and choose the type: "mcp" for an MCP server, "site" for an app. Or let an AI agent do it — see the last FAQ.

  3. 03

    Add your model key as an env var

    In project settings add your own provider key, e.g. ANTHROPIC_API_KEY or OPENAI_API_KEY. It is passed only to your container. Unyly does not proxy models — you bring your own access.

  4. 04

    It goes live at slug.unyly.org

    The build runs, the healthcheck confirms the server answers, and your project is live. An MCP server is reachable at slug.unyly.org/mcp for any client; every push redeploys automatically.

What Unyly builds for each project type

You do not write a Dockerfile (though a repo Dockerfile is respected if present). Unyly detects the stack and generates one. For an MCP server on Node it installs deps and wraps the stdio entry (bin > main > index.js) with supergateway, exposing streamable HTTP at /mcp. Python is the same with a python:3.12 base. For a site it uses nginx:alpine for plain static, an npm build that ships dist/build/out, or a Node runtime for Next.js. Monorepos: set a Root Directory (web/, app/, …) or let autodetect find it.

# The generated Dockerfile for a Node MCP server (simplified)
FROM node:22-slim
WORKDIR /app
COPY package*.json ./
RUN npm install --omit=dev
COPY . .
RUN npm install -g supergateway
EXPOSE 3000
CMD supergateway --stdio 'node index.js' \
    --outputTransport streamableHttp --port 3000 --streamableHttpPath /mcp

Model keys, streaming and timeouts for AI apps

Unyly is not a model gateway. Your app calls the provider directly with your own key, set as a project env var (ANTHROPIC_API_KEY, OPENAI_API_KEY, …) — it is injected only into your container. The reverse proxy does not buffer responses, so SSE token streaming reaches the client as it is produced, and it holds a single request open for up to 10 minutes, which covers slow completions and multi-step agent tool loops. Containers get 384 MiB RAM and half a CPU on the current plan.

Deploying by talking to an AI agent

Unyly Deploy is exposed as an MCP server itself. Connect https://deploy.unyly.org/mcp in Claude, Cursor or ChatGPT (auth with a token from unyly.org/account/gateway, or Authorize via OAuth in claude.ai/ChatGPT) and the agent gets tools: deploy_project, list_projects, get_project, get_logs, redeploy, rollback, set_env, add_domain. So "deploy github.com/me/my-agent as an mcp and set ANTHROPIC_API_KEY" becomes a single instruction the agent carries out end to end.

Why through Unyly

  • 93,000+ MCPs in catalog, updated every 6 hours
  • Semantic search — type what you want, not exact name
  • Auto-verified for security — we scan for leaked secrets
  • Version pinning + update notifications
  • One-click for Claude Desktop, Cursor, Claude Code, VS Code
  • Side-by-side comparison pages (compare two MCPs)
  • Hosted runners — run MCPs in the cloud if you don't want them local

FAQ

What can I deploy?

Static sites, npm builds, Next.js apps, and MCP servers in Node or Python. A stdio MCP server is automatically wrapped into streamable HTTP, so it connects to Claude, ChatGPT and Cursor.

Does streaming work for AI apps?

Yes. Responses are not buffered and the proxy holds long requests up to 10 minutes, so token streaming (SSE) and multi-step agent tool loops work without being cut off.

Who pays for the model calls?

You do, on your own provider key that you set as an env var. Unyly is not a model gateway — it hosts and routes your app; the model access is yours.

Can an AI agent deploy it for me?

Yes. Unyly Deploy is itself an MCP server: connect https://deploy.unyly.org/mcp in Claude, Cursor or ChatGPT and say "deploy this repo". The agent creates the project, watches the build, sets env and rolls back.

More guides