# runelay > runelay is an open-source, self-hosted MCP gateway. It gives Claude Code, Codex, Cursor, Grok and any MCP client the same connected accounts, skills and shared memory through one endpoint (`/v1/mcp`). It runs as a desktop app (Mac, Windows, Linux) or as one Docker container with SQLite. MIT licensed, free, no third-party cloud. ## Get started - [Download the desktop app](https://runelay.com/download/): Mac (Apple silicon and Intel), Windows and Linux AppImage. Runs the server on `127.0.0.1:4312`. - [Set up step by step](https://runelay.com/setup/): install the server with `curl -fsSL runelay.com/install | sh`, then the CLI with `curl -fsSL runelay.com/cli | sh`, then `runelay login`, `runelay migrate` and `runelay connect`. - [Agent setup prompt](https://runelay.com/setup/): a ready prompt that lets an agent install and connect runelay for you. ## Features - [Connections](https://runelay.com/features/connections/): connect an account once from the catalog (one-click OAuth), a remote MCP URL, a local command or an OpenAPI spec; every agent uses it and credentials stay encrypted on your server. - [Skills](https://runelay.com/features/skills/): `SKILL.md` folders served on demand with `read_skill` and `read_skill_file`, a switch per skill, and `runelay pull` writing enabled skills to `~/.claude/skills`. - [Shared memory](https://runelay.com/features/memory/): notes with `[[links]]`, versions, health checks and pinned memories that go into every agent's instructions. - [Agents](https://runelay.com/features/agents/): one endpoint (`/v1/mcp`) and one API key per agent, audited and revocable on its own. ## Benchmark - [runelay vs Executor, measured](https://runelay.com/benchmark/): same 11 MCP servers (125 tools), self-hosted Docker. runelay uses 1,045 context tokens at connect vs 2,729, tool calls are 10x faster (6.6 ms vs 68 ms median), search is 60x faster, idle RAM is 8.4x lower. Since runelay 0.3.3 the Docker image is a 66 MB download vs 80 MB for Executor. ## Guides - [Self-hosted MCP gateway, the practical guide](https://runelay.com/self-hosted-mcp-gateway/): what an MCP gateway does, why self-host it, what to check before picking one and how to run runelay in a minute. - [Open-source, self-hosted Composio alternative](https://runelay.com/composio-alternative/): runelay vs Composio side by side, when each one fits and how to switch with `runelay migrate`. - [MCP gateway vs MCP server](https://runelay.com/mcp-gateway-vs-mcp-server/): the difference in context cost, credentials, revocation and audit, and when you need a gateway. ## Agent guides - [Share MCP servers across agents](https://runelay.com/guides/share-mcp-across-agents/): one login per account and one endpoint for Claude Code, Cursor and Codex, with `runelay migrate` and `runelay connect`. - [Claude Code](https://runelay.com/guides/claude-code/): add the runelay endpoint with `claude mcp add --transport http`. - [Cursor](https://runelay.com/guides/cursor/): add the runelay endpoint to `~/.cursor/mcp.json`. - [Codex](https://runelay.com/guides/codex/): add the runelay endpoint to `~/.codex/config.toml`. - [Antigravity](https://runelay.com/guides/antigravity/): add the runelay endpoint to Antigravity's `mcp_config.json` with `serverUrl` and `headers`; `runelay connect` does not wire Antigravity. - [Grokbot](https://runelay.com/guides/grokbot/): add the runelay endpoint to `~/.grok/config.toml`; `runelay connect` and `runelay migrate` handle it. - [Hermes Agent](https://runelay.com/guides/hermes-agent/): add the runelay endpoint under `mcp_servers` in `~/.hermes/config.yaml` with an `Authorization` header, then `/reload-mcp`. - [OpenClaw](https://runelay.com/guides/openclaw/): save the runelay endpoint with `openclaw mcp set` as a `streamable-http` server, then `openclaw gateway restart`. - [MausBot](https://runelay.com/guides/mausbot/): paste a `claude mcp add` command for the runelay endpoint in Plugins → MCP servers → Add server. - [OpenCode](https://runelay.com/guides/opencode/): add the runelay endpoint under `mcp` in `~/.config/opencode/opencode.json` as `type: "remote"` with `oauth: false` and an `Authorization` header. - [OpenBot](https://runelay.com/guides/openbot/): add the runelay endpoint in MCP servers → Connect a custom MCP, with an `Authorization` header. - [Kimi Code](https://runelay.com/guides/kimi-code/): add the runelay endpoint under `mcpServers` in `~/.kimi-code/mcp.json` with `url` and an `Authorization` header, then open a new session. - [agentes.chat](https://runelay.com/guides/agentes-chat/): add the runelay endpoint as an MCP by URL in the MCPs section of Settings with the `rnl_` key; it needs a public https address (Tailscale Funnel or a domain). - [runelay migrate](https://runelay.com/docs/migrate/): what the command imports, which accounts arrive connected and the related CLI commands. ## Integrations - [Integrations catalog](https://runelay.com/integrations/): the MCP servers in the catalog with their auth mode, plus any remote MCP, local MCP or OpenAPI spec. - [Custom connectors](https://runelay.com/custom-connectors/): add any MCP server or API that isn't in the catalog by remote MCP URL, local command or OpenAPI spec, with auth detection and your own OAuth client for providers without dynamic client registration. - Each catalog entry has its own page at `https://runelay.com/integrations//` (for example [Linear](https://runelay.com/integrations/linear/), [GitHub](https://runelay.com/integrations/github/), [Gmail](https://runelay.com/integrations/gmail/)): connect once, use from every agent. ## Compare - [Executor alternative](https://runelay.com/executor-alternative/): runelay vs Executor on hosting, official pricing, memory and measured numbers (runelay 0.3.2 vs Executor 2.0.0-beta.51). - [Docker MCP Gateway alternative](https://runelay.com/docker-mcp-gateway-alternative/): runelay vs Docker MCP Gateway and the MCP Toolkit for people who want an MCP gateway without Docker Desktop: where each runs, how servers run, OAuth, license and memory. - [Obot alternative](https://runelay.com/obot-alternative/): runelay vs Obot on hosting (desktop app or one container vs Kubernetes), editions and pricing, sign-in, skills and memory. - [MCPHub alternative](https://runelay.com/mcphub-alternative/): runelay vs MCPHub on hosting (desktop app or one container vs a Docker hub with a web dashboard), license and pricing, how servers connect, sign-in, skills and memory. - [ContextForge alternative](https://runelay.com/contextforge-alternative/): runelay vs IBM ContextForge (MCP Gateway) on hosting, license, protocols (MCP, A2A, REST and gRPC), sign-in and SSO, skills and memory. - [agentgateway alternative](https://runelay.com/agentgateway-alternative/): runelay vs agentgateway, the Linux Foundation proxy for MCP, A2A and LLM traffic: where each runs, license, auth and policies, skills and memory. - [Runelay vs Runlayer](https://runelay.com/vs/runlayer/): runelay is an open-source MCP gateway by Anderson Medeiros and is not related to Runlayer, an enterprise AI governance platform. ## Docs - [README](https://raw.githubusercontent.com/Andsu-dev/runelay/main/README.md): full documentation, configuration, environment variables, security model, MCP tools and REST API. - [Changelog](https://runelay.com/changelog/): what changed in each release. - [Releases](https://github.com/Andsu-dev/runelay/releases): installers, CLI binaries and `compose.yaml`. ## MCP tools - `list_connections`, `search_tools`, `call_tool`, `execute`: find and call tools from every connected account; `execute` chains calls in a sandboxed JavaScript runtime. - `search_context`, `read_memory`, `write_memory`, `read_skill`, `read_skill_file`: shared memory and skills across agents. ## Legal - [Privacy Policy](https://runelay.com/privacy/): runelay is self-hosted, so accounts, tokens, memories and skills stay encrypted on your own instance; the OAuth broker at auth.runelay.com stores nothing; Google user data follows the Google API Services User Data Policy, including Limited Use. - [Terms of Service](https://runelay.com/terms/): MIT license, provided as is; the OAuth broker is free and best-effort, only for runelay. ## Optional - [Source code](https://github.com/Andsu-dev/runelay): Bun, Hono, SQLite, React. - [Página em português](https://runelay.com/pt-br/)