x-mcp

Принципиальный MCP-сервер для управления аккаунтом X с помощью агента.

Это не обёртка над X API. Это небольшой оператор, который знает четыре вещи, о которых API вам не расскажет:

1. Как ранжирует For You — веса, пороги и фильтры из открытого алгоритма X (xai-org/x-algorithm) встроены в каждый инструмент как ограничения и рекомендации: вес ответа 5→20 для взаимных подписок, репост по ссылке 20, лайк 0.5; строго видео >10с; ≤1 @-упоминание; без приманок для вовлечённости; ≥4ч между оригинальными постами; первый лайк открывает внешний корпус; подъём холодного старта для аккаунтов с <1k подписчиков; окна 24ч/48ч.

2. Что на самом деле разрешает API с оплатой за использование — с 2026 года X отклоняет невызванные ответы и убрал подписки, лайки и цитаты из самообслуживания. Инструменты делают всё, что разрешено, и передают человеку ссылку-интент в один клик для остального, а затем автоматически сверяют то, что сделал человек, из собственных чтений за $0.001.

3. Сколько стоит каждый вызов — локальный реестр зеркалирует цены X за ресурс (с дедупликацией за 24ч), соблюдает месячный бюджет и предупреждает вас перед «постом с URL» за $0.20.

4. Что остаётся бизнесу — реестр отношений со всеми, кто взаимодействовал (и кого стоит подписаться в ответ), календарь, который учится на ваших лучших часах, брендбук, который разделяется каждой сессией, конвейер идей и цикл аналитики/отчётов, чтобы агент управлялся на основе собственных цифр, а не ощущений.

Построен на MCP TypeScript SDK v2. По умолчанию stdio, Streamable HTTP опционально. Ноль зависимостей во время выполнения, кроме SDK и zod.

Инструменты

Ресурсы: x://playbook (правила), x://boundary (что разрешает API), x://handoff (живая очередь человека). Промпт: operate (рабочий цикл).

Related MCP server: X(Twitter) V2 MCP Server

Настройка

1. Создайте приложение на https://console.x.com → включите OAuth 2.0 → тип приложения Native App (публичное, PKCE) или Automated App/Bot (конфиденциальное, даёт client secret) → добавьте redirect URI http://127.0.0.1:8477/callback → скопируйте Client ID (и secret, если конфиденциальное). Пополните кредиты (оплата за использование).

2. Настройте — переменные окружения читаются из окружения или из ~/.x-mcp/.env (никогда из текущей директории, чтобы враждебный репозиторий не мог перенаправить ваш токен через свой .env):

   cd x-mcp && npm install && npm run build
   mkdir -p ~/.x-mcp/media && cp .env.example ~/.x-mcp/.env   # set X_CLIENT_ID (+ X_CLIENT_SECRET if confidential)

   Медиа, которые агент может загружать, должны находиться в ~/.x-mcp/media (или в директориях из X_MCP_MEDIA_ROOT) — положите туда ваше демо-видео.

3. Войдите один раз (откроется браузер, токены сохранятся в ~/.x-mcp/tokens.json, режим 0600):

   node dist/bin.js login

4. Подключите к вашему агенту.

   Hermes (~/.hermes/config.yaml):

   mcp_servers:
     x:
       command: node
       args: ["/absolute/path/to/x-mcp/dist/bin.js"]
       env:
         X_CLIENT_ID: "…"
         X_CLIENT_SECRET: "…"          # confidential apps only
         X_MCP_MONTHLY_BUDGET_USD: "25"
         X_MCP_REQUIRE_APPROVAL: "true" # default; keep until you have X's AI-reply approval
       timeout: 180

   Claude Code:

   claude mcp add x -e X_CLIENT_ID=… -e X_MCP_REQUIRE_APPROVAL=true -- node /absolute/path/to/x-mcp/dist/bin.js

   HTTP вместо stdio: X_MCP_HTTP_TOKEN=SECRET node dist/bin.js --http --port 8478 → url: http://127.0.0.1:8478/mcp, заголовок Authorization: Bearer SECRET. Токен обязателен всегда (если вы его не задали, он генерируется и выводится); Host/Origin проверяются на localhost.

5. Запустите цикл. Попросите агента использовать промпт operate (или вставьте его). Проверьте node dist/bin.js queue на предмет ожидающих вас действий; node dist/bin.js approve --all выполняет поставленные в очередь действия API; нажимайте ссылки-интенты для действий, доступных только человеку, и запускайте handoff(reconcile) (или позвольте агенту сделать это), чтобы очередь очистилась сама.

6. Поставьте tick на таймер (каждые 15 мин достаточно), чтобы запланированные посты публиковались, handoff-сверки выполнялись, а метрики снимались для insights:

   */15 * * * * cd /absolute/path/to/x-mcp && node dist/bin.js tick >> ~/.x-mcp/tick.log 2>&1

   (Пользователи Hermes: cron-задача, которая вызывает schedule(run_due) + handoff(reconcile) + post_performance, делает то же самое.)

Конфигурация (env)

Что будет отклонено и почему

• Два или более @упоминаний в посте → X направляет пост в систему оценки спама на основе ИИ в реальном времени. Указывайте упоминания в ответе.

• «Поставь лайк, если / репостни, если / отметь кого-то» → SpamHighRecall, исключений нет.

• Видео короче или равно 10,0 с → начало видео обрезается до 0, и ролик исключается из всех видеокаталогов.

• Видео + изображение в одном посте → пост исключается из видеокаталогов.

• Второй оригинальный пост в течение 4 часов → коэффициент 0,625 в общих очередях; механизм холодного старта выбирает один пост на запрос.

• Одинаковый текст ответа дважды → кластеризация копипасты.

• Ответ на пост, в котором вас не упомянули → X отклоняет его; вы получаете ссылку на черновик.

• Любые расходы сверх месячного бюджета.

Все мягкие ограничения можно обойти с помощью force: true — но это всегда отправляет действие в очередь на подтверждение человеком; медиафайлы, бюджет и собственные лимиты X обойти нельзя.

Модель безопасности (кратко)

• Токены и состояние хранятся в ~/.x-mcp (каталог 0700, файлы 0600); сервер и CLI-команда x-mcp approve работают с ними безопасно (перезапись только после проверки актуальности, новее набор токенов не затирается).

• Агент не может читать произвольные файлы: media_paths должны находиться в пределах корневых каталогов медиафайлов; идентификаторы проверяются как числовые snowflake (никакого ../ для доступа к другим конечным точкам).

• Необратимые или чувствительные к политике действия (delete_post, любой force, личные сообщения, режим подтверждения) требуют подтверждения человеком в CLI. delete_post принимает только те посты, которые этот сервер знает как ваши.

• Текст от сторонних сервисов в выводе инструментов помечается как данные, а не как инструкции. HTTP-режим требует bearer-токен и проверяет заголовки Host и Origin.

Примечания к политике, которые стоит прочитать

• Правила автоматизации X (апрель 2026) требуют предварительного письменного разрешения для ИИ-ботов, отвечающих на посты, одного автоматического ответа на одно взаимодействие пользователя, запрещают дублирующиеся посты, массовые подписки/лайки/личные сообщения, а также требуют метки «Автоматизированный» в аккаунте (Настройки → Ваш аккаунт → Информация об аккаунте → Автоматизация). Этот сервер обеспечивает техническую часть; разрешение и метку вы получаете самостоятельно.

• Описание варианта использования в соглашении с разработчиком должно отражать то, что делает агент (публикация, чтение собственной аналитики, нишевые исследования).

Разработка

npm test          # rules engine + full server through an in-memory MCP client against a mock X API
npm run typecheck
npm run build

Источники: документация API X (docs.x.com, прочитано 19.08.2026: цены, ограничения manage-posts, журнал изменений, media v2, OAuth 2.0) и xai-org/x-algorithm@11a71f8 (home-mixer/params/param.rs, scorers/, filters/, visibility-filtering/, phoenix/, grox/). Полное исследование с указанием файлов и строк — в docs/FOR_YOU_PLAYBOOK.md в клоне x-algorithm.

MIT.