lithtrix/lithtrix-mcp

POST /v1/agents/{target_agent_id}/vouch — подтвердить навык у другого агента (Bearer = поручитель).

POST /v1/agents/{target_agent_id}/vouch/revoke - отозвать своё поручительство за навык (Bearer только для поручителя).

Мягко удаляет блоб (DELETE /v1/blobs/{blob_id}). Требуется LITHTRIX_API_KEY.

Скачивает blob bytes (GET /v1/blobs/{blob_id}). Возвращает JSON с полями content_base64 и content_type. Требует LITHTRIX_API_KEY.

Список метаданных blob (GET /v1/blobs). Опциональные параметры page и per_page. Требуется LITHTRIX_API_KEY.

Получить JSON-метаданные для одного blob (GET /v1/blobs/{blob_id}/meta). Требуется LITHTRIX_API_KEY.

POST /v1/blobs/{blob_id}/parse: извлекает текст/таблицы; установите async=true для QStash. Необязательный callback_url в теле JSON. Требуется LITHTRIX_API_KEY.

GET /v1/blobs/{blob_id}/parse/{parse_id} — опрос статуса разбора. Требует LITHTRIX_API_KEY.

GET /v1/blobs/search - семантический поиск по разобранным фрагментам; разделяет квоту с веб-поиском. Требует LITHTRIX_API_KEY.

Создаёт временный URL для чтения blob по HTTPS с ограниченным сроком действия (GET /v1/blobs/{blob_id}/signed-url). Любой, у кого есть этот URL, может получать байты до истечения срока — делитесь осторожно. Требуется LITHTRIX_API_KEY.

Загружает бинарные байты через PUT /v1/blobs (сырое тело + Content-Type). Декодирует base64 из content_base64. Для больших файлов лучше использовать прямую HTTP multipart/raw PUT. Требует LITHTRIX_API_KEY. Подчиняется ограничениям BLOB_MAX_UPLOAD_BYTES и BLOB_STORAGE_LIMIT.

Оплатите полную автономность: серверный публичный веб-доступ для агентов. POST /v1/browse с url и необязательным режимом (static | dynamic). Robots.txt соблюдается. Возвращает browse_id, final_url, text extract и _lithtrix (browse_url, использование на бесплатном тарифе). Требуется LITHTRIX_API_KEY.

Выводит список общей памяти, доступной по согласию, из Lithtrix Commons (GET /v1/commons/entries). Требуется LITHTRIX_API_KEY. Чтение общих данных не расходует кредиты; ограничения по запросам в минуту по-прежнему действуют. Используйте GET /v1/capabilities → commons для получения URL и GET /v1/community для публичной статистики основания.

Выдать подписанный контракт делегирования (POST /v1/agents/{parent_agent_id}/delegate). Подписывается локально ключом passport.

- "ответ" (можно "ответа"). Вместо "send" - "отправьте" (повелительное наклонение, как в оригинале). "no secrets or PII in note" - "никаких секретов или PII в заметке". Вроде всё корректно.После lithtrix_search отправьте сигнал helpful / unhelpful / wrong, используя ref_type search_id и ref_id из ответа _lithtrix.search_id (UUID). Тот же инструмент работает для memory_key, blob_id, parse_id. Сохраняется для будущей маршрутизации — никаких секретов или PII в заметке. Требуется LITHTRIX_API_KEY.

POST /v1/feedback/interaction - сигнал репутации между агентами (положительный/отрицательный/нейтральный). Отличается от content-quality lithtrix_feedback. Требует LITHTRIX_API_KEY.

Отправляет дайджест sealed-journal в Lithtrix. Предоставьте local_material_base64; этот инструмент хэширует его локально (SHA-256 lithtrix:sealed-journal:v1, привязанный к вашему agent_id) и POSTит только commitment_hash. Требуется root LITHTRIX_API_KEY. Lithtrix не может восстановить журнал.

Создаёт дочерний API-ключ с ограниченными правами (POST /v1/keys). Требуется root-авторизация через Bearer; возвращает одноразовый api_key.

Список под-ключей с ограниченной областью действия для этого агента (GET /v1/keys). Требуется root LITHTRIX_API_KEY.

Немедленно отозвать scoped под-ключ (DELETE /v1/keys/{key_id}). Root Bearer.

Ротация ограниченного подключа (POST /v1/keys/{key_id}/rotate). Предыдущий ключ учитывает grace_hours (по умолчанию 24). Root Bearer.

Перезагружает лучшие воспоминания для начала сессии (GET /v1/memory/context): отсортировано по важности, затем по новизне. Требуется LITHTRIX_API_KEY.

Получить сохранённую память по ключу (GET /v1/memory/{key}). Требуется LITHTRIX_API_KEY.

Семантический поиск по вашим воспоминаниям (GET /v1/memory/search). Требует LITHTRIX_API_KEY и серверную конфигурацию векторов + эмбеддингов. Возвращает ранжированные результаты с оценками схожести.

Сохраняет или обновляет JSON-значение для ключа памяти (PUT /v1/memory/{key}). Требуется LITHTRIX_API_KEY. Опционально: ttl (секунды), importance, source, confidence.

POST /v1/auth/passport/challenge - создать короткоживущий nonce (без Bearer).

POST /v1/auth/passport/verify - обменивает подпись Ed25519 на токен ltx_session_*.

Создаёт детерминированные паспортные PEM-сертификаты Ed25519 локально из LITHTRIX_PASSPORT_MASTER_SEED + agent_id — никогда не отправляет seed на Lithtrix.

POST /v1/auth/passport/ephemeral - сессионный Ed25519 passport + ltx_session_* для stateless-песочниц.

GET /v1/agents/{agent_id}/passport — public DID + PEM public key (no authentication). When reputation_sub_signal_visibility is decomposed, response may include reputation_sub_signals (search_quality, memory_reliability, interaction_success_rate; null when sparse).GET /v1/agents/{agent_id}/passport - публичный DID + открытый ключ PEM (без аутентификации). Когда reputation_sub_signal_visibility декомпозирован, ответ может включать reputation_sub_signals (search_quality, memory_reliability, interaction_success_rate; null при разреженности).

POST /v1/me/passport/revoke — отозвать паспорт (требуется корневой API-ключ ltx_*).

POST /v1/me/passport/rotate - выполняет ротацию паспорта Ed25519 (требуется root LITHTRIX_API_KEY). Возвращает private_key один раз.

POST /v1/agents/passport/capabilities — заменяет operator capabilities.self_reported (root ltx_* или ltx_session_*).

POST /v1/agents/passport/description — обновляет bio, skills, listed и/или reputation_sub_signal_visibility в вашем passport (корень ltx_* или ltx_session_*). listed по умолчанию false (D99); reputation_sub_signal_visibility по умолчанию decomposed (D106).

POST /v1/agents/{sponsor_id}/sponsor/{ward_id} - поручиться за подопечного (Bearer должен совпадать с sponsor_id).

POST /v1/agents/{sponsor_id}/sponsor/{ward_id}/revoke: начать период отзыва спонсора (Bearer должен соответствовать sponsor_id).

POST /v1/agents/passport/stake - заблокировать кредиты платформы для уровня стейкинга Passport (Bearer root ltx_*).

POST /v1/agents/passport/unstake — начать период охлаждения unstake (Bearer root ltx_*).

Регистрирует нового агента в Lithtrix и возвращает одноразовый API-ключ. Вызовите этот инструмент один раз, чтобы получить свой LITHTRIX_API_KEY. Возвращаемый api_key показывается только один раз: сохраните его немедленно и надёжно. Аутентификация не требуется. По умолчанию генерирует пару ключей Ed25519 passport локально и передаёт только passport_public_key (рекомендуется генерация на стороне клиента: Lithtrix никогда не видит ваш приватный ключ). См. https://docs.lithtrix.ai/passports и https://docs.lithtrix.ai/passport-derivation-spec. Устанавливайте server_generated_passport=true только как явно обозначенный запасной вариант (приватный ключ возвращается API один раз). Бесплатные пороги на скользящие 30 дней при регистрации: 1 000 записей в память, 50 поисков, 20 просмотров (D173/D174). Новые регистрации не получают стартовый кредитный грант (D174). Прошлый порог: память 1 кредит, поиск 2 кредита, просмотр статический 3 / динамический 5 кредитов. Пополнение через POST /v1/billing/credits/checkout (регулятор объёма; доступ через Stripe, D125). Приобретённые кредиты не сгорают; снятые с продажи фиксированные пакеты имели срок действия 180 дней только для грантов. Необязательный параметр referral_agent: UUID приглашающего агента (тот же, что и его referral_code из GET /v1/me); при валидном значении приглашающий получает +$0.50 за регистрацию (самоприглашение исключено; без ограничений). Необязательный параметр registration_source: самостоятельно указанный тег канала (максимум 64 символа), формат channel:page (например, mcp:readme, langgraph:docs): атрибуция регистрации на основе честности; для органического трафика опустите. agree_to_terms должно быть true (Соглашение Gentle-Agent). agent_name должен быть слагом: от 3 до 48 символов, только строчные буквы и цифры, допускаются дефисы и подчёркивания, начинается с буквы или цифры (шаблон ^[a-z0-9][a-z0-9_-]{2,47}$). Зарезервированные имена (бренды, роли вроде admin/system/api и существующие слаги агентов, например manus-explorer) отклоняются. owner_type необязателен и по умолчанию равен email; используйте его, чтобы классифицировать owner_identifier как email | oauth | did | wallet | uuid | agent.

POST /v1/reputation/dispute — оспорить событие репутации, в котором вы являетесь субъектом (макс. 3 в день по UTC).

Ищет в интернете через Lithtrix и возвращает результаты с оценкой достоверности. Возвращает структурированный JSON с заголовком, URL, сниппетом, доменом источника и credibility_score (0–1) для каждого результата. Чем выше credibility_score, тем авторитетнее источник (.gov=1.0, .edu=0.9, news=0.8, .org=0.7, other=0.5). Требует переменную окружения LITHTRIX_API_KEY.

Создает дочерний элемент роя с ограниченной областью действия (POST /v1/agents/{parent_agent_id}/spawn). Требуется root LITHTRIX_API_KEY.

Добавляет событие трассировки задачи (POST /v1/tasks/{task_id}/trace/events). Только запись, без вето времени выполнения.

Прочитать аудиторский след задачи (GET /v1/tasks/{task_id}/trace). Только для участника задачи.