Меню документации

Сервер MCP

TEnergy держит сервер Model Context Protocol по адресу https://mcp.tenergy.me (Streamable HTTP). При подключении он просит войти в TEnergy (первый вход создаёт аккаунт) и разрешить агенту нужные действия с лимитом трат; после этого агент видит баланс, получает котировки и заказывает энергию. Смотреть цены и рынок без аккаунта можно по адресу https://mcp.tenergy.me/public.

АдресСетьДоступ
https://mcp.tenergy.memainnetвход или ключ ak_live_
https://mcp.tenergy.me/nileтестнет Nileвход в кабинет Nile или ключ ak_test_
https://mcp.tenergy.me/publicmainnetоткрыт без аккаунта: только цены и данные сети
https://mcp.tenergy.me/nile/publicтестнет Nileоткрыт без аккаунта: только цены и данные сети

Подключение

Приложение Claude или claude.ai

  1. Откройте Settings → Connectors → Add → Add custom connector.
  2. Назовите TEnergy и вставьте адрес https://mcp.tenergy.me (тестнет Nile: https://mcp.tenergy.me/nile). Настройку входа оставьте той, что Claude определит сам, — «Sign in now».
  3. Нажмите Add. Сначала Claude покажет свою страницу «Завершить подключение коннектора?» — нажмите Продолжить.
  4. Войдите в TEnergy (при первом входе аккаунт создаётся сам), выберите разрешения и лимиты трат и нажмите Разрешить.

Лимиты можно поменять, а доступ отозвать в любой момент в кабинете, в разделе «Подключённые агенты».

Claude Code в терминале

Нужна установленная программа Claude Code для командной строки; в приложении Claude используйте шаги выше.

claude mcp add --transport http tenergy https://mcp.tenergy.me

Затем введите /mcp в Claude Code и выберите Authenticate.

Другие клиенты со входом через аккаунт

Добавьте свой коннектор (или MCP-сервер) с адресом https://mcp.tenergy.me; клиент откроет ту же страницу входа TEnergy.

С API-ключом вместо входа

Клиенты, которые передают заголовки, могут прислать ключ: Authorization: ApiKey <key>:<secret>. Сервер подписывает каждый вызов этим ключом, а сам ключ никогда не попадает к модели.

Claude Code:

claude mcp add --transport http tenergy https://mcp.tenergy.me/ --header "Authorization: ApiKey ak_live_...:..."

Cursor — mcp.json:

{"mcpServers":{"tenergy":{"url":"https://mcp.tenergy.me/","headers":{"Authorization":"ApiKey ak_live_...:..."}}}}

VS Code — .vscode/mcp.json:

{"servers":{"tenergy":{"type":"http","url":"https://mcp.tenergy.me/","headers":{"Authorization":"ApiKey ak_live_...:..."}}}}

Инструменты

ИнструментНужен аккаунтЧто делает
get_prices, get_address_resourcesНетТаблица цен; энергия и bandwidth получателя
get_market, get_market_summary, get_price_historyНетЖивые цены провайдеров, сводка за день, история цен
get_chain_parameters, get_energy_fee_historyНетЦена энергии в сети и её история
estimate_contract_call, suggest_order_size, calculate_savingsНетЭнергия на вызов контракта, объём заказа на пакет переводов, экономия против сжигания TRX
explain_conceptНетЭнергия, bandwidth, делегирование и другие термины
get_x402_quoteНетMainnet: котировка x402 в USDC на Base за энергию для TRON-адреса; платит ваш x402-клиент, инструмент ничего не подписывает
estimate_transferДаСтоимость одного перевода USDT получателю
get_accountДаУчётная запись, от имени которой работает подключение: Account ID (acc_…) и название
get_balance, get_deposit_addressesДаПредоплаченный баланс (с ID и названием учётной записи); куда его пополнить
create_quote, create_orderДа (права на расходы)Закрепить цену на 120 с; купить
get_order, list_ordersДаСтатус и история

Промпты: cheapest_energy_for_transfer, size_batch_order, explain_failed_transaction. Ресурсы: tenergy://docs/quickstart, tenergy://llms.txt, tenergy://facts/energy.

Оплата без аккаунта (HTTP 402, TRX)

Агент без ключа тоже может купить энергию. POST https://api.tenergy.me/v1/orders без ключа отвечает HTTP 402, а в JSON (protocol: "tenergy-trx-transfer", version: 1) написано, как заплатить обычным переводом TRX:

ПолеЧто в нём
pay_to, network, chain, assetАдрес для оплаты часовой аренды; основная сеть TRON (на API Nile — Nile); TRX
price_sun_per_unit, fee_bpsЦена единицы энергии вместе с комиссией сервиса; price_steps — цена по объёму
min_amount, max_amountСколько энергии можно купить одним переводом сейчас
rulesЭнергия = отправленные TRX ÷ цена на момент поступления, с округлением вниз; получатель — отправитель или адрес из мемо; платёж меньше минимума и остаток не возвращаются
transactionТолько если в теле запроса есть payer (и amount или amount_sun, по желанию receiver): неподписанный перевод — остаётся подписать и отправить
status_urlGET /v1/transfers/{txid}: awaiting_transfer, pending, order (со статусом заказа), no_order, not_ours

Это предложение в TRX — не x402 (в x402 нет схемы для TRON и TRX). Запрос с любыми учётными данными проверяется как обычно и такой 402 не получает.

Оплата USDC в сети Base (x402)

Агент, у которого есть USDC в Base, может заплатить по стандарту x402 v2. Передайте amount и receiver в анонимном POST /v1/orders или вызовите GET https://tenergy.me/x402?amount=65000&receiver=T...: в ответе 402 появятся заголовок PAYMENT-REQUIRED и accepts[].

ПолеЗначение
scheme, networkexact, eip155:8453 (Base)
assetUSDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (EIP-3009)
amountСумма в USDC (6 знаков) за этот объём энергии, комиссия сервиса включена
maxTimeoutSeconds120: повторите запрос с подписью за это время
extra.intentIdСтатус: GET /v1/x402/intents/{id}

Повторите тот же запрос с заголовком PAYMENT-SIGNATURE (любой клиент x402 делает это сам). Мы проводим платёж через фасилитатор Coinbase, создаём заказ на receiver и отвечаем заказом и заголовком PAYMENT-RESPONSE. Без receiver цена только ориентировочная. Энергия на 1 час; один платёж покупает объём в пределах min_amount–max_amount из предложения в TRX.

Правила безопасности

ПравилоЗачем
Ключ читается только из заголовка Authorization, в каждом запросеОн не хранится на сервере и не показывается модели
create_order требует max_price_sun и client_order_idПотолок цены и ключ идемпотентности у каждой покупки
Заказы дороже 50 TRX отклоняются до списанияЗапутавшийся агент не опустошит баланс одним вызовом
Дайте ключу только те права, что нужны агенту; набора по умолчанию нетСм. Аутентификацию
Сначала проверьте в тестнете Nile (/nile, ключ ak_test_)В Окружениях — что Nile доказать не может

    ↑ ↓ — выбрать · Enter — открыть · Esc — закрыть