Layero MCP server
Commit Nov 8, 2026Lets an AI client deploy websites, manage custom domains, and interact with Postgres databases via a Data API.
Also known as LayeroInfra/layero-agents, layero-agents
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.4.0
- Last commit
- Nov 8, 2026
- License
- MIT
What is Layero MCP?
Layero lets an AI client deploy websites, manage custom domains, and interact with Postgres databases via a Data API.
Summary generated from the project's README
About Layero MCP server
Deploying websites and managing cloud infrastructure directly from an AI agent is what Layero enables. Developers can connect a code repository or a local directory to launch sites on a project-specific subdomain, manage custom domains, and handle branch previews. The platform also supports runtime applications and provides Postgres databases equipped with a Data API for easy data interaction.
This remote MCP server connects to clients like Claude Code and Cursor via Streamable HTTP. While tools such as search_docs, check_copy, and refactor_site are available without signing in, managing infrastructure requires authentication through OAuth or a LAYERO_TOKEN for automated environments. The setup is designed to work within CI/CD pipelines and headless environments by using the token in the Authorization header.
Users can integrate these capabilities using specific commands for different clients, such as adding the LayeroInfra/layero-agents skill or using the npx add-mcp command. The system is built to follow strict behavioral principles, ensuring agents ask for permission before performing sensitive actions like rolling back deployments or accessing data.
Written from the project's README. Every use case is checked against a quote from it.
How to install Layero MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Layero MCP in Claude Code
$ claude mcp add --transport http layero-agents https://mcp.layero.ru/mcpInstall Layero MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"layero-agents": {
"url": "https://mcp.layero.ru/mcp"
}
}
}Install Layero MCP in VS Code
.vscode/mcp.json
{
"servers": {
"layero-agents": {
"type": "http",
"url": "https://mcp.layero.ru/mcp"
}
}
}Install Layero MCP in VS Code CLI
$ code --add-mcp '{"name":"layero-agents","type":"http","url":"https://mcp.layero.ru/mcp"}'Install Layero MCP in Codex
$ codex mcp add layero-agents --url https://mcp.layero.ru/mcpInstall Layero MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.layero-agents] url = "https://mcp.layero.ru/mcp"
Install Layero MCP in Gemini CLI
$ gemini mcp add -s user --transport http layero-agents https://mcp.layero.ru/mcpInstall Layero MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"layero-agents": {
"url": "https://mcp.layero.ru/mcp",
"type": "http"
}
}
}Configuration
LAYERO_TOKEN
| Name | Description | |
|---|---|---|
| LAYERO_TOKEN | — |
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 reachablelayeroinfra/layero-agents is public and reachablegithub.com/layeroinfra/layero-agents ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/layeroinfra/layero-agents ↗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 handshakeinitialize answered with protocol 2025-06-18 in 1600 msPass
README
View on GitHubLayero для агентов
English · Русский
Layero — платформа хостинга и деплоя с серверами сборки в России. Репозиторий или папка с кодом → сайт на
<проект>.layero.app; кастомные домены, превью-ветки, runtime-приложения, базы Postgres с Data API.
🌐 Сайт: https://layero.ru · 📚 Документация: https://docs.layero.ru/agents/ · 📦 npm: https://www.npmjs.com/package/layero
Этот репозиторий — канон того, как AI-агенты работают с Layero: один
навык (skills/layero), одно описание подключения MCP (mcp.json) и одна
таблица команд установки (agents-install.json). Всё остальное — плагины
для Claude Code и Cursor, запись в реестре MCP, блок установки ниже —
генерируется из канона скриптом и сверяется гейтом.
Установка
MCP: https://mcp.layero.ru/mcp (сервер layero, транспорт http) · навык: LayeroInfra/layero-agents
| Клиент | Команда |
|---|---|
| CLI | npx layero@latest deploy |
| Agent Skill | npx skills add LayeroInfra/layero-agents |
| Agent MCP | npx -y add-mcp https://mcp.layero.ru/mcp |
| Claude Code | claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero |
| Cursor | npx -y add-mcp https://mcp.layero.ru/mcp · одной кнопкой |
| Codex CLI | codex mcp add layero --url https://mcp.layero.ru/mcp |
CI и бездисплейные среды — токен в LAYERO_TOKEN:
LAYERO_TOKEN=… npx layero@latest deploy --project <slug> --json --yes
Три канала, выбирайте по клиенту:
- Навык —
npx skills add LayeroInfra/layero-agentsставитskills/layeroв любой агент, понимающий стандарт Agent Skills (.agents/skills). Навык учит агента трём путям: push в подключённый репозиторий, деплой папки черезnpx layero@latest deploy --json, эксплуатация живого сайта. - MCP-сервер —
npx -y add-mcp https://mcp.layero.ru/mcpподключает удалённый сервер (Streamable HTTP) во все установленные клиенты. Без входа доступныsearch_docs,check_copy,refactor_site; остальное — вход через OAuth (клиент откроет браузер при первом вызове инструмента аккаунта) или заголовокAuthorization: Bearer $LAYERO_TOKENдля CI. Локально ничего не запускается. - Плагины — Claude Code (
claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero) и Cursor (Customize → Plugins → Add, репозиторийLayeroInfra/layero-agents) ставят навык и MCP одной командой.
CI и среды без браузера
Там, где некому пройти вход в браузере, используется токен LAYERO_TOKEN:
выпустите его на app.layero.ru/settings/cli
или командой npx layero@latest token create. CLI читает переменную сам;
для MCP плагин Claude Code подставляет её в заголовок
Authorization: Bearer ${LAYERO_TOKEN} (то же делает корневой .mcp.json
при клонировании репозитория). В плагине Cursor заголовка нет: Cursor не
раскрывает ${VAR}, и нераскрытая строка ушла бы на сервер как неверный
токен.
Как агент себя ведёт
Принципы — в SOUL.md: не деплоить на прод молча, показывать адрес сайта только из ответа платформы, спрашивать человека перед откатом и выдачей доступа к данным, говорить с пользователем на его языке.
Структура репозитория
skills/layero/SKILL.md — КАНОН: единый навык
skills/layero/references/ — справочники: JSON-события CLI, layero.json, git-провайдеры
mcp.json — КАНОН: как подключить MCP-сервер
agents-install.json — КАНОН: команды установки по клиентам
SOUL.md — принципы поведения агента (layero://soul)
assets/logo.svg — логотип для карточки плагина
build-adapters.py — генерирует всё ниже
check-surfaces.py — гейт: сгенерированное == закоммиченное
.claude-plugin/marketplace.json — маркетплейс Claude Code (генерируется)
plugins/layero/ — плагин Claude Code: .mcp.json + навык (генерируется)
.cursor-plugin/marketplace.json — маркетплейс Cursor (генерируется)
plugins/layero-cursor/ — плагин Cursor: mcp.json, правило, навык, логотип (генерируется)
server.json — запись в реестре MCP как ru.layero/layero (генерируется)
.mcp.json — подключение из корня для Claude Code (генерируется)
Как менять
Правится только канон: skills/layero/, mcp.json, agents-install.json,
SOUL.md, этот README вне блока установки. Затем:
make build # перегенерировать адаптеры
make check # убедиться, что всё совпадает
Адаптеры руками не правятся — правка проживёт до следующего make build
и уронит make check. Гейт заодно сверяет копии agents-install.json в
соседних чекаутах лендинга и документации, если они есть рядом.
Где Layero представлен
Единый список внешних адресов. Меняется здесь; каталоги, которые не
обновляются из репозитория сами, помечены — их правят руками после
каждого релиза (гейт frontend/landing/check-published-claims.py в core
ловит устаревшие обещания).
Продукт
| Что | Адрес |
|---|---|
| Сайт | https://layero.ru · llms.txt: https://layero.ru/llms.txt |
| Панель | https://app.layero.ru |
| Документация | https://docs.layero.ru · для агентов: https://docs.layero.ru/agents/ |
| Статус платформы | https://status.layero.app |
| MCP-сервер | https://mcp.layero.ru/mcp |
| Чат в Telegram | https://t.me/layero_ru |
| Product Radar | https://productradar.ru/product/layero/ |
Код
| Репозиторий | GitHub | Зеркало GitVerse |
|---|---|---|
| Канон для агентов (этот) | https://github.com/LayeroInfra/layero-agents | https://gitverse.ru/layero/layero-agents |
CLI (npm i layero) |
https://github.com/LayeroInfra/cli | https://gitverse.ru/layero/cli |
| Документация | https://github.com/LayeroInfra/layero-docs | https://gitverse.ru/layero/layero-docs |
| Примеры | https://github.com/LayeroInfra/examples | https://gitverse.ru/layero/examples |
| GitHub Action | https://github.com/LayeroInfra/deploy-action | https://gitverse.ru/layero/deploy-action |
| Дизайн-система | https://github.com/LayeroInfra/design-system | https://gitverse.ru/layero/design-system |
Организация на GitVerse — https://gitverse.ru/layero. Зеркала обновляются
workflow mirror-gitverse.yml в каждом репозитории при push в main;
README организации (профиль layero/.gitverse) — из LayeroInfra/.github.
Секреты GITVERSE_LOGIN и GITVERSE_TOKEN заданы на уровне организации
GitHub (видны публичным репозиториям).
Пакеты и маркетплейсы
| Площадка | Запись | Обновляется |
|---|---|---|
| npm | https://www.npmjs.com/package/layero | тег v* в LayeroInfra/cli (workflow publish.yml) |
| GitHub Marketplace | https://github.com/marketplace/actions/deploy-to-layero | релизом deploy-action |
| Официальный реестр MCP | ru.layero/layero — https://registry.modelcontextprotocol.io/v0.1/servers?search=ru.layero |
mcp-publisher publish из mcp/ (бамп версии обязателен) |
| Claude Code marketplace | claude plugin marketplace add LayeroInfra/layero-agents → layero@layero |
из этого репозитория |
| Cursor marketplace | .cursor-plugin/marketplace.json этого репозитория |
из этого репозитория |
| skills.sh | https://skills.sh/LayeroInfra/layero-agents | из этого репозитория |
| Smithery | https://smithery.ai/servers/borisowvalia/layero | руками: npx @smithery/cli mcp publish https://mcp.layero.ru/mcp -n borisowvalia/layero, описание в Settings |
| Glama | https://glama.ai/mcp/connectors/ru.layero/layero | из реестра MCP; владение подтверждено файлом https://mcp.layero.ru/.well-known/glama.json (отдаёт код MCP, не убирать). Старый дубликат ru.layero.mcp/layero помечен deprecated; его владение держит TXT-запись _glama-claim.mcp.layero.ru в зоне layero.ru (YC DNS) |
| cursor.directory | https://cursor.directory/plugins/layero | руками на /plugins/layero/edit |
| mcp.so | заявка https://github.com/chatmcp/mcpso/issues/4219 | по заявке |
| PulseMCP | берёт из реестра MCP | автоматически |
English
Layero is a hosting and deployment platform whose build servers sit
inside Russia: connect a repository or ship a directory, get a site at
<project>.layero.app, plus custom domains, branch previews, runtime apps
and Postgres databases with a Data API.
This repository is the canonical source for how AI agents work with
Layero: one skill (skills/layero), one MCP connection spec (mcp.json) and
one table of install commands (agents-install.json). Everything else — the
Claude Code and Cursor plugins, the MCP registry record, the install block
above — is generated from the canon and checked by a gate.
Install
Commands per client are in the table above (agents-install.json). Three
channels:
- Skill —
npx skills add LayeroInfra/layero-agentsinstallsskills/layerointo any agent that reads the Agent Skills standard. - MCP server —
npx -y add-mcp https://mcp.layero.ru/mcpadds the remote server (Streamable HTTP) to every installed client.search_docs,check_copyandrefactor_sitework without sign-in; everything else signs in through OAuth (the client opens the browser on the first account tool call) orAuthorization: Bearer $LAYERO_TOKENfor CI. Nothing runs locally. - Plugins — Claude Code (
claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero) and Cursor (Customize → Plugins → Add, repositoryLayeroInfra/layero-agents).
CI
Where nobody can sign in through a browser, use LAYERO_TOKEN: issue it at
app.layero.ru/settings/cli or with
npx layero@latest token create.
LAYERO_TOKEN=… npx layero@latest deploy --project <slug> --json --yes
The CLI reads the variable itself; the Claude Code plugin (and the root
.mcp.json) forward it as Authorization: Bearer ${LAYERO_TOKEN}. The Cursor
plugin ships no header because Cursor does not expand ${VAR}.
Changing things
Edit only the canon (skills/layero/, mcp.json, agents-install.json,
SOUL.md, this README outside the install block), then make build and
make check. Generated adapters are never edited by hand.
Docs: https://docs.layero.ru/en/agents/ · Website: https://layero.ru · npm: https://www.npmjs.com/package/layero
Not to be confused with Layer0 / Edgio, or with layero.com — unrelated products.
Лицензия
Layero MCP questions
How do I add Layero MCP to Claude Code?
Run claude mcp add --transport http layero-agents https://mcp.layero.ru/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Layero MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I deploy a site using the CLI?
You can deploy using the command npx layero@latest deploy.
How do I use Layero in CI or headless environments?
Use the LAYERO_TOKEN environment variable, which you can generate at app.layero.ru/settings/cli or via npx layero@latest token create.
Does the MCP server run locally?
No, the MCP server is a remote Streamable HTTP server and nothing runs locally.
What tools are available through the MCP server without signing in?
Users can access search_docs, check_copy, and refactor_site without an account.