x-mcp

エージェントでXアカウントを運用するための、意見を持つMCPサーバー。

X APIのラッパーではありません。APIが教えてくれない4つのことを知っている小さなオペレーターです。

1. For Youのランキング方法 — Xがオープンソース化したアルゴリズム（xai-org/x-algorithm）の重み、ゲート、フィルターが、すべてのツールにガードレールとアドバイスとして組み込まれています: 相互フォローの返信重み5→20、リンク共有20、いいね0.5; 厳密に10秒超の動画; @メンションは1つまで; エンゲージメント釣りなし; オリジナル投稿の間隔は4時間以上; 最初のいいねでアウト・オブ・ネットワークのコーパスが開く; フォロワー1,000人未満のコールドスタート・リフト; 24時間/48時間のウィンドウ。

2. 従量課金APIで実際に何が許可されているか — 2026年以降、Xは呼び出されていない返信を拒否し、セルフサービスからのフォロー、いいね、引用ポストを削除しました。ツールは許可されているすべてのことを実行し、残りは人間にワンタップのインテントリンクを渡し、その後、人間が行ったことを$0.001の所有リードから自動調整します。

3. 各呼び出しのコスト — ローカル台帳がXのリソース別価格（24時間の重複排除付き）を反映し、月間予算を強制し、$0.20の「URL付き投稿」の前に警告します。

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を有効化 → アプリタイプネイティブアプリ（公開、PKCE）または自動化アプリ/ボット（機密、クライアントシークレット付与）→ リダイレクトURI http://127.0.0.1:8477/callbackを追加 → クライアントID（機密の場合はシークレットも）をコピー。クレジットをチャージ（従量課金）。

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

   stdioの代わりにHTTP: 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分ごとで十分）して、予定投稿が配信され、ハンドオフが調整され、メトリクスがinsights用にスナップショットされるようにします:

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

   （Hermesユーザー: schedule(run_due) + handoff(reconcile) + post_performanceを呼び出すcronジョブでも同じことができます。）

設定（環境変数）

拒否する内容とその理由

• 投稿内の@メンションが2つ以上 → XによるリアルタイムLLMスパムスコアリングに回されます。クレジットは返信に記載してください。

• 「いいねで／RTで／タグで」 → SpamHighRecall。誰にも免除はありません。

• 10.0秒以下の動画 → 動画ヘッドが0になり、投稿はすべての動画コーパスから除外されます。

• 1つの投稿に動画＋画像 → 動画コーパスから除外されます。

• 4時間以内の2つ目のオリジナル投稿 → 共有スレートで×0.625。コールドスタートリフトはリクエストごとに1投稿を選択します。

• 同じ返信テキストが2回 → コピペクラスタリング。

• 自分に@メンションしていない投稿への返信 → Xが拒否。代わりにインテントリンクが提供されます。

• 月次予算を超える支出。

ソフトな制限はすべてforce: trueで上書きできますが、その場合アクションは常に人間の承認キューに回されます。メディアルート、予算、X自身の制限は上書きできません。

セキュリティモデル（概要）

• トークン／状態は~/.x-mcp（0700ディレクトリ、0600ファイル）に保存されます。サーバーとx-mcp approve CLIはこれらを安全に共有します（書き込み前に再読み込みし、新しいトークンセットを上書きしません）。

• エージェントは任意のファイルを読み取れません。media_pathsはメディアルート配下に解決される必要があります。IDは数値のスノーフレークとして検証されます（他のエンドポイントへの../パススマイグリングは不可）。

• 取り消し不可またはポリシー上重要なアクション（delete_post、任意のforce、DM、承認モード）にはCLIでの人間による承認が必要です。delete_postはこのサーバーがあなたの投稿として認識しているもののみ受け付けます。

• ツール出力内の第三者のテキストは指示ではなくデータとしてラベル付けされます。HTTPモードではベアラートークンが必要で、Host／Originを検証します。

読むべきポリシーに関する注意事項

• Xの自動化ルール（2026年4月）では、AI返信ボットの事前の書面による承認、ユーザー操作ごとの自動返信1回、重複投稿の禁止、一括フォロー／いいね／DMの禁止、Automatedアカウントラベル（設定 → アカウント → アカウント情報 → 自動化）が必要です。このサーバーは機械的な部分を強制します。承認とラベルの取得・設定はあなたの責任です。

• 提出した開発者契約のユースケースには、エージェントが何をするか（投稿、自メトリクスの読み取り、ニッチ調査）を記載する必要があります。

開発

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

出典: X APIドキュメント（docs.x.com、2026-08-19閲覧: 価格、manage-posts制限、変更履歴、media v2、OAuth 2.0）、およびxai-org/x-algorithm@11a71f8（home-mixer/params/param.rs、scorers/、filters/、visibility-filtering/、phoenix/、grox/）。完全な調査とファイル:行の引用については、x-algorithmクローン内のdocs/FOR_YOU_PLAYBOOK.mdを参照してください。

MIT.