// agents · AmoyLab/Unla

Unla

Unla MCP Gateway: turn existing APIs and MCP servers into MCP endpoints with zero code changes.

★ 2.2k stars⑂ 185 forksMITupdated 2026-08
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Unla is an open-source ai agents project by AmoyLab (AmoyLab/Unla on GitHub). It has 2,240 GitHub stars and 185 forks, is released under the MIT license, and was last updated on GitHub on 27 August 2026.

Repository
AmoyLab/Unla
GitHub stars
2,240
Forks
185
License
MIT
Last updated on GitHub
27 August 2026
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Inventory the APIs or MCP servers you want to expose through one gateway endpoint.

  2. Get the project

    Deploy Unla with Docker, setting the JWT secret and super-admin credentials as environment variables.

  3. Install and configure

    Log in to the management UI and add an MCP server or API by pasting a YAML configuration; no code changes are needed on the source service.

  4. Run your first task

    Point your MCP client at the gateway's SSE or Streamable HTTP endpoint and start calling the converted tools.

// features

Why people love it

REST-to-MCP conversion

Legacy RESTful APIs become MCP servers through YAML configuration, following the client to gateway to API path.

MCP proxying

Existing MCP servers can be proxied and aggregated behind the gateway with the same endpoint model.

Multiple MCP transports

Serves MCP over SSE and Streamable HTTP, with responses that can include text, images, and audio.

Sessions and multi-tenancy

Persistent, recoverable sessions and multi-tenant support for serving several teams or customers.

Configuration management

Config persists to disk, SQLite, PostgreSQL, or MySQL, with hot-reloading, version control, and sync via signals, HTTP, or Redis PubSub.

Management UI and flexible deployment

A built-in web UI simplifies setup, and the gateway deploys via Docker, Kubernetes, and Helm, with multi-replica support and OAuth pre-authentication.

Advertisement
// run it

Run it yourself

  1. Clone the project (for source or configs)

    Example configurations live in the repository, including a proxy mock server config.

    git clone https://github.com/AmoyLab/Unla.git
    cd Unla
  2. Launch the all-in-one Docker container

    Set the admin and JWT environment variables first, as shown in the README.

    docker run -d --name unla -p 8080:80 -p 5235:5235 -e ENV=production ghcr.io/amoylab/unla/allinone:latest # set APISERVER_JWT_SECRET_KEY and SUPER_ADMIN_* first, per README
  3. Add a server and connect a client

    Open http://localhost:8080, add an MCP server config, then point your client at the gateway endpoint.

    # MCP Streamable HTTP endpoint: http://localhost:5235/mcp/user/mcp
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains it?

It is maintained by AmoyLab on GitHub.

Is it free to use?

Yes, Unla is MIT-licensed and free to self-host, including with Docker and Kubernetes.

Does it need a paid API key?

No LLM API key is required by the gateway itself; your MCP client and the APIs you expose use their own credentials.

How does it compare to a well-known alternative?

Hand-written MCP servers require code for every API; Unla converts and proxies services through configuration at the gateway layer instead.

How do I get started?

Run the all-in-one Docker image, open the management UI on port 8080, add a server configuration, and connect your client to the /mcp endpoint.

// keep exploring

Similar tools

AI Agents

metamcp

MCP aggregator, orchestrator, middleware and gateway in one Docker — compose many servers into one endpoint

★ 2.7k starsMIT
View guide →
AI Agents

mcphub

Self-hosted MCP gateway and control plane — connect, control and operate all your MCP servers from one place

★ 2.5k starsApache-2.0
View guide →
AI Agents

composio

Over a thousand tool integrations so agents can turn intent into action.

★ 30.5k starsMIT
View guide →
Agents

Paper2Any

Turn papers, text, or topics into editable research figures and slides.

★ 2.8k starsApache-2.0
View guide →
AI Agents

fastmcp

The fast, Pythonic way to build MCP servers and clients.

★ 28.0k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if Unla is not the right fit.

Get Unla

Free and open — grab the source, star the repo, and start creating.