> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/ru/produkty/rome-cli.md).

# Rome CLI + MCP

CLI разработчика Rome и сервер MCP — проверенные факты о цепочке, правильный шаблон сборки и уникальные для Rome действия (пополнение, развёртывание, проверка) для человека или ИИ-агента.

`Rome` проводит разработчика — человека или ИИ-агента — через весь жизненный цикл разработки на Rome: актуальные факты о сети, нужный шаблон, вызовы контрактов, вход в систему пополнения, deploy/send, межвиртуальную диагностику и works-gate для обеих дорожек. Один общий набор возможностей, две согласованные поверхности — CLI (`rome <команда>`) и [MCP](https://modelcontextprotocol.io) сервер (`rome mcp`) — чтобы агент и человек использовали одну и ту же ментальную модель.

## Установка

Сначала репозиторий (публикация в npm ожидается):

```bash
# однократный запуск, без установки:
npx github:rome-protocol/rome-cli#v0.12.0 facts chain hadrian

# постоянная установка — клонировать + связать:
git clone --branch v0.12.0 https://github.com/rome-protocol/rome-cli
cd rome-cli && npm install && npm install -g .
```

Обычная `npm install -g github:rome-protocol/rome-cli` не **не** работает сегодня — npm подготавливает git-зависимости пакета без собственных node\_modules ([rome-cli#25](https://github.com/rome-protocol/rome-cli/issues/25)). Используйте однократный запуск через npx или клонирование + связывание, и фиксируйте тег, как указано выше: npx сохраняет первую загруженную копию, поэтому незакреплённый `npx github:rome-protocol/rome-cli` может продолжать запускать старую версию, тогда как закреплённый тег всегда загружает именно эту версию.

## Два слоя поверх одного ядра

**Чтение — актуализация данных + диагностика.** Без ключей; и в CLI, и на MCP-сервере.

| Команда                                                  | Что возвращает                                                                                                                             |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `rome facts chain·tokens·contracts·gas·balance·programs` | актуальные факты о сети из реестра + RPC — без выдуманных идентификаторов, адресов или селекторов                                          |
| `rome cookbook patterns·cpi-recipe·errors`               | какой пример соответствует вашей цели · правила аккаунтов CPI, в которых агенты ошибаются · расшифровать сбой Rome → причина + исправление |
| `rome call <chain> <addr> <sig> [args]`                  | прочитать контракт (`eth_call`) — аргументы с несколькими значениями передаются через запятую в одном аргументе: `"0xOwner…,0xSpender…"`   |
| `rome doctor <chain>`                                    | предполетная проверка — сеть доступна? RPC достижим? программа настроена? кошелёк пополнен?                                                |
| `rome tx <chain> <hash>`                                 | диагностировать транзакцию — квитанция EVM + транзакция(и) расчёта Solana + ссылка Via (у Rome нет `debug_traceTransaction`)               |
| `rome preset foundry\|hardhat <chain>`                   | готовая конфигурация сети Rome для вашего инструментария + особенности                                                                     |

**Действия — подпись в блокчейне.** только CLI, ключ из окружения, **никогда** в MCP.

| Команда                                                                    | Что делает                                                                                                                                                                                                                                                                                                                                                              |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rome deploy <chain> <artifact>`                                           | развернуть скомпилированный контракт, учитывая особенности газа в Rome                                                                                                                                                                                                                                                                                                  |
| `rome send <chain> <addr> <sig>`                                           | записать в контракт через правильный путь записи Rome                                                                                                                                                                                                                                                                                                                   |
| `rome fund <chain> --from <src> --amount <usdc>`                           | перевести USDC → газ Rome (CCTP) — входной канал «из дома»                                                                                                                                                                                                                                                                                                              |
| `rome bridge <chain> --from <src> --amount <usdc> [--intent gas\|wrapper]` | перевести USDC **в** как газ или wUSDC                                                                                                                                                                                                                                                                                                                                  |
| `rome bridge <chain> --to <dest> --amount <usdc>`                          | перевести wUSDC **наружу** — сжечь на Rome; вы получаете на целевой сети (Rome спонсирует входящие переводы, а не исходное получение)                                                                                                                                                                                                                                   |
| `rome activate <chain>`                                                    | необязательное финансирование PDA; для исходящего моста оно не требуется, поскольку мостовой контракт (RomeBridgeWithdraw v12 и новее) оплачивает арендную плату за сообщение и включает её в газ                                                                                                                                                                       |
| `rome verify <chain> [--path …]`                                           | этот **works-gate с учётом пути**, по одному для каждого пути входа: `solidity` — один и тот же контракт отвечает на EVM-дорожке *и* дорожка Solana · `solana-program` — вызов на EVM-дорожке запускает вашу программу Solana через CPI · `из домашней сети` — перейти по мосту внутрь → выполнить действие в Rome → перейти по мосту наружу, круговой путь подтверждён |

## Подключите это к ИИ-агенту (MCP)

Вам не нужно ничего запускать или размещать — ваш MCP-клиент запускает `rome mcp` (сервер stdio) по требованию. Зарегистрируйте его один раз:

```json
{ "mcpServers": { "rome": { "command": "npx", "args": ["-y", "github:rome-protocol/rome-cli#v0.12.0", "mcp"] } } }
```

(При установке через клонирование + связывание, `{ "command": "rome", "args": ["mcp"] }` тоже работает — форме npx просто не требуется предварительная установка.)

Затем агент вызывает такие инструменты, как `facts_chain`, `cookbook_cpi_recipe`, `doctor`, `tx`, и `preset` — на основе актуального реестра + RPC, поэтому он перестаёт угадывать адреса и селекторы. Поверхность MCP **только для чтения и не содержит ключей** — безопасна для подключения к любому агенту; она никогда не сможет подписывать или перемещать средства. Действия подписи остаются в CLI, а ключ передаётся через окружение.

## Цикл актуализации для агента

1. `rome cookbook patterns <what I'm building>` → какой пример репозитория + архитектуры
2. `rome facts chain <chain>` → RPC, идентификатор программы, газовый токен (без жёсткого кодирования)
3. …пишите код, опираясь на эти точные значения…
4. `rome verify <chain> --path <your way in>` → подтвердить, что это работает, каким бы путём вы ни пришли

## Подробнее

* Репозиторий + полные руководства: [`rome-protocol/rome-cli`](https://github.com/rome-protocol/rome-cli)
* [Экосистема и репозитории](https://docs.rome.builders/ru/nachalo-raboty-1/ecosystem.md) · [Сборка приложения с двумя дорожками](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/dual-lane-app.md) · [Из дома: добраться до Rome из другой сети](https://docs.rome.builders/ru/rukovodstva-dlya-razrabotchikov/from-home.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/ru/produkty/rome-cli.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
