Справочник инструментов MCP Server

Tenderly MCP Server предоставляет 59 инструментов, разделённых на семь групп. Чтобы сначала подключить его к своему клиенту, следуйте быстрому старту MCP Server. Всем инструментам, работающим с ресурсами проекта, требуется активный проект — сначала вызовите set_active_project. Инструментам Virtual Environment требуется активный Virtual Environment — вызовите set_active_vnet или создайте/форкните Virtual Environment (что автоматически активирует его).

Вам не нужно вызывать инструменты по имени. Просто опишите, что вы хотите, естественным языком, и Claude сам подберёт нужные инструменты.

Проект и аккаунт

Эти инструменты управляют контекстом сессии. Большинству других инструментов требуется установленный активный проект.

Инструмент	Описание
`get_user_info`	Возвращает информацию об аккаунте (ID, имя пользователя, email), текущий активный проект и активный Virtual Environment (ID, RPC URL, network ID), если установлен.
`list_projects`	Перечисляет все проекты Tenderly, доступные вам. Поддерживает необязательную фильтрацию по имени или слагу.
`set_active_project`	Устанавливает активный проект для последующих вызовов инструментов. Принимает `account_slug` и `project_slug`. Должен быть вызван до использования инструментов уровня проекта.

Сети

Инструмент	Описание
`get_networks`	Перечисляет все публичные EVM-сети, поддерживаемые Tenderly (100+). Поддерживает необязательную фильтрацию по имени. Возвращает network ID, имя, слаг и chain ID.

Контракты

Инструмент	Описание
`get_contract_info`	Возвращает метаданные для адреса контракта в заданной сети: имя контракта, ABI (если верифицирован), версию компилятора, EVM-версию, язык, стандарты токенов (ERC-20, ERC-721 и т. д.), блок создания, транзакцию создания и адрес деплойера.

Симуляции транзакций

Симулируйте и трассируйте транзакции в любой поддерживаемой Tenderly EVM-сети, не тратя газ и не изменяя ончейн-состояние.

Основные инструменты симуляции

Инструмент	Описание
`simulate_transaction`	Симулирует транзакцию и возвращает результат: статус success/revert, использованный газ, декодированное имя метода, сообщение об ошибке и причину revert. Поддерживает переопределения состояния, поля EIP-1559 и кастомные номера блоков. Результаты сохраняются на дашборд проекта.
`resimulate_transaction`	Воспроизводит существующую ончейн-транзакцию в среде симуляции Tenderly. Полезно для отладки транзакций, которые упали или повели себя неожиданно.
`trace_transaction`	Трассирует ончейн-транзакцию и возвращает сводку: статус, использованный газ, декодированный метод, отправителя, получателя и детали ошибки.

Инструменты детализации симуляции

После запуска simulate_transaction, resimulate_transaction или trace_transaction используйте эти дополнительные инструменты с возвращённым simulation_id или tx_hash, чтобы инспектировать конкретные аспекты исполнения.

Инструмент	Описание
`get_simulation_call_trace`	Плоское дерево вызовов — каждый внутренний EVM-вызов с декодированными именами функций, входами, выходами и газом по каждому вызову. Поддерживает параметр `max_depth`. Ограничено 256 записями.
`get_simulation_events`	Декодированные события (логи), эмитированные во время исполнения, включая имена событий, эмитирующие адреса и параметры, декодированные по ABI. Ограничено 100 записями.
`get_simulation_state_changes`	Диффы слотов хранилища (адрес, ключ, значения до/после) и диффы нативных балансов для всех затронутых аккаунтов. Ограничено 100 записями.
`get_simulation_asset_transfers`	Все переводы токенов и нативных активов: отправитель, получатель, информация о токене (имя, тип, символ, decimals) и сумма. Ограничено 100 записями.
`get_simulation_exposure_changes`	Изменения approvals и allowance для токенов — approvals, отзывы и permits. Ограничено 100 записями.
`get_simulation_balance_changes`	Чистое изменение балансов по каждому адресу с долларовыми значениями. Ограничено 100 записями.
`get_simulation_gas_breakdown`	Разбивка газа по каждому вызову, включая intrinsic gas и refunds. Значения газа включают подвызовы.
`get_simulation_generated_access_list`	Генерирует access list EIP-2930 путём пересимуляции транзакции. Полезно для оптимизации газа.

Virtual Environments

Создавайте и управляйте приватными персистентными форками публичных EVM-сетей. У Virtual Environments свои RPC-эндпоинты, и они поддерживают имперсонированные транзакции без приватных ключей. Инструменты Virtual Environment используют stateful-модель сессии: установите Virtual Environment активным (или создайте/форкните его — это автоматически активирует), и все последующие инструменты Virtual Environment работают с ним. Не нужно передавать ID Virtual Environment в каждый вызов.

Инструмент	Описание
`set_active_vnet`	Устанавливает активный Virtual Environment для последующих вызовов инструментов. Принимает `vnet_id`. После установки все инструменты Virtual Environment автоматически работают с этим Virtual Environment.
`create_vnet`	Создаёт новый Virtual Environment, форкая публичную сеть на определённом блоке. Принимает `network_id`, необязательные `display_name`, `description`, `block_number` (hex), кастомный `chain_id` и `sync_state_enabled`. Возвращает детали Virtual Environment, включая RPC URLs. Автоматически устанавливает новый Virtual Environment активным.
`list_vnets`	Перечисляет Virtual Environments в активном проекте. Поддерживает пагинацию (`page`, `per_page`), фильтрацию по статусу (`running`, `stopped`, `cloning`) и поиск по имени.
`get_vnet`	Возвращает полные детали активного Virtual Environment: ID, слаг, отображаемое имя, статус, описание, конфигурацию форка, конфигурацию сети и URL RPC-эндпоинтов.
`fork_vnet`	Форкает активный Virtual Environment в новый, сохраняя всё состояние, включая задеплоенные контракты и балансы. Автоматически устанавливает новый форк активным.
`delete_vnet`	Удаляет Virtual Environment. Это деструктивное действие. Очищает активный Virtual Environment из состояния сессии.
`send_vnet_transaction`	Отправляет и исполняет транзакцию в активном Virtual Environment. Адрес отправителя имперсонируется, приватный ключ не нужен. Принимает `from`, `to`, `input` (calldata), `value` (hex wei) и `gas`.
`get_vnet_transactions`	Перечисляет транзакции в активном Virtual Environment с пагинацией. Возвращает хеш транзакции, статус, использованный газ, номер блока и метод.
`fund_account`	Задаёт баланс нативного токена для любого адреса в активном Virtual Environment, вызывая `tenderly_setBalance` по RPC. Принимает `address` и `amount` в hex wei.
`set_erc20_balance`	Задаёт баланс ERC-20 токена для любого адреса в активном Virtual Environment через `tenderly_setErc20Balance`. Принимает `token_address`, `address` и `value`. Предпочтительнее `set_storage_at` для изменения балансов токенов.
`set_storage_at`	Записывает сырое значение в конкретный слот хранилища контракта через `tenderly_setStorageAt`. Принимает `contract_address`, `slot` и `value`. Используйте для переопределения цен оракулов, параметров протокола или любого состояния, не покрытого высокоуровневыми инструментами.
`vnet_call`	Выполняет read-only `eth_call` в активном Virtual Environment. Принимает `to`, `input` (calldata) и необязательный `from`. Результаты усекаются на 10 КБ.
`vnet_multicall`	Выполняет пакет до 10 read-only `eth_call`-запросов за один RPC round-trip. Каждый вызов принимает `to`, `input` и необязательный `from`. Каждый результат усекается на 10 КБ.
`mine_block`	Майнит один блок в активном Virtual Environment через `evm_mine`. Используйте после `increase_time`, чтобы применить изменение времени.
`increase_time`	Продвигает часы Virtual Environment на заданное число секунд через `evm_increaseTime`. Всегда следуйте `mine_block`, чтобы зафиксировать изменение времени в новом блоке.
`snapshot_vnet`	Сохраняет текущее состояние Virtual Environment и возвращает ID снапшота через `evm_snapshot`. Используйте для ветвления тестовых сценариев — сделайте снапшот перед тестом, затем откатитесь и попробуйте другой путь.
`revert_vnet`	Восстанавливает Virtual Environment к ранее сохранённому снапшоту через `evm_revert`. Снапшот расходуется при использовании — сделайте новый снапшот, если нужно откатиться ещё раз.

Симуляции и трассы Virtual Environment

Симулируйте и трассируйте транзакции в активном Virtual Environment. Эти инструменты работают с operation ID, а не с хешами транзакций сетевого уровня.

Основные инструменты симуляции Virtual Environment

Инструмент	Описание
`simulate_vnet_transaction`	Симулирует транзакцию в Virtual Environment, не изменяя его состояние. Возвращает статус, использованный газ, декодированный метод и `operation_id` для последующих инструментов. Поддерживает переопределения состояния.
`resimulate_vnet_transaction`	Повторно трассирует ранее выполненную транзакцию Virtual Environment по её `operation_id` (из `get_vnet_transactions`).
`trace_vnet_transaction`	Возвращает сводку декодированной трассы исполнения: имя контракта, имя функции, декодированные входные параметры, декодированный выход, использованный газ и детали ошибки.

Инструменты детализации симуляции Virtual Environment

Используйте их с operation_id из инструментов выше. Они работают в активном Virtual Environment.

Инструмент	Описание
`get_vnet_simulation_call_trace`	Плоская трасса вызовов для транзакции Virtual Environment с типом вызова, адресами, газом и значением по каждому вызову.
`get_vnet_simulation_events`	Декодированные события, эмитированные во время транзакции Virtual Environment: имя события и эмитирующий адрес.
`get_vnet_simulation_gas_breakdown`	Разбивка газа по каждому вызову, отсортированная по потреблению газа. Показывает общий газ и топ-потребителей.
`get_vnet_simulation_state_changes`	Диффы слотов хранилища: адрес, ключ, значения до/после для каждого изменённого слота.
`get_vnet_simulation_generated_access_list`	Access list EIP-2930, сгенерированный из исполнения транзакции Virtual Environment.
`get_vnet_simulation_balance_changes`	Чистые изменения балансов по каждому адресу с долларовыми значениями.
`get_vnet_simulation_asset_changes`	Переводы токенов и нативных активов: тип, from, to, сумма и информация о токене.

Продвинутая навигация по трассе

16 инструментов для навигации по сложным транзакциям с сотнями или тысячами внутренних вызовов. Используйте их, когда get_simulation_call_trace или get_vnet_simulation_call_trace возвращают усечённые результаты или когда нужно искать, углубляться или обобщать большую трассу без загрузки всего дерева.

Ончейн и симуляция

Инструмент	Описание
`get_trace_stats`	Быстрая проверка размера перед загрузкой трассы — возвращает общее число вызовов, максимальную глубину, число ошибок и уникальных контрактов. Помогает выбрать стратегию навигации.
`get_trace_skeleton`	Возвращает сжатое дерево вызовов (имя функции, контракт, глубина, флаг ошибки, без декодированных аргументов) для больших усечённых трасс. Используйте возвращённые значения `absolute_position`, чтобы углубиться.
`get_call_trace_node`	Разворачивает конкретный усечённый узел трассы. Используйте, когда узел сообщает `omitted_children > 0`.
`search_call_trace`	Ищет в большой трассе конкретные вызовы, не загружая всё дерево. Фильтруйте по адресу, имени функции или статусу ошибки.
`get_subtree_events`	Возвращает события из одного конкретного поддерева, а не из всей транзакции. Используйте, когда `get_simulation_events` возвращает слишком много событий.
`get_subtree_state_changes`	Возвращает диффы хранилища из одного конкретного поддерева.
`find_failures`	Находит все локации ошибок в транзакции сразу — возвращает каждый упавший узел с именем контракта, функцией и декодированной ошибкой.
`get_error_path`	Показывает цепочку виновников от корня до самой глубокой ошибки с декодированными входами/выходами на каждом уровне. Основной инструмент для отладки revert’ов в сложных транзакциях.
`get_transaction_fund_flow`	Показывает упорядоченное движение денег в транзакции — кто, кому и что отправил, с долларовыми значениями и чистым потоком по каждому адресу. Только для ончейн-транзакций.

Аналоги для Virtual Environment

Зеркальные аналоги инструментов выше для транзакций в активном Virtual Environment.

Инструмент	Описание
`get_vnet_trace_stats`	Аналог `get_trace_stats` для Virtual Environment.
`get_vnet_trace_skeleton`	Аналог `get_trace_skeleton` для Virtual Environment.
`get_vnet_call_trace_node`	Аналог `get_call_trace_node` для Virtual Environment.
`search_vnet_call_trace`	Аналог `search_call_trace` для Virtual Environment.
`get_vnet_subtree_events`	Аналог `get_subtree_events` для Virtual Environment.
`find_vnet_failures`	Аналог `find_failures` для Virtual Environment.
`get_vnet_error_path`	Аналог `get_error_path` для Virtual Environment.

Getting Started

Simulator

Console

Monitor

Node RPC

Account & Settings

Справочник инструментов MCP Server

Проект и аккаунт

Сети

Контракты

Симуляции транзакций

Основные инструменты симуляции

Инструменты детализации симуляции

Virtual Environments

Симуляции и трассы Virtual Environment

Основные инструменты симуляции Virtual Environment

Инструменты детализации симуляции Virtual Environment

Продвинутая навигация по трассе

Ончейн и симуляция

Аналоги для Virtual Environment

​Проект и аккаунт

​Сети

​Контракты

​Симуляции транзакций

​Основные инструменты симуляции

​Инструменты детализации симуляции

​Virtual Environments

​Симуляции и трассы Virtual Environment

​Основные инструменты симуляции Virtual Environment

​Инструменты детализации симуляции Virtual Environment

​Продвинутая навигация по трассе

​Ончейн и симуляция

​Аналоги для Virtual Environment

Проект и аккаунт

Сети

Контракты

Симуляции транзакций

Основные инструменты симуляции

Инструменты детализации симуляции

Virtual Environments

Симуляции и трассы Virtual Environment

Основные инструменты симуляции Virtual Environment

Инструменты детализации симуляции Virtual Environment

Продвинутая навигация по трассе

Ончейн и симуляция

Аналоги для Virtual Environment