> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP ツールカタログ

> Ayrshare MCP Server が公開する 27 個のツール — 投稿、履歴、アナリティクス、コメント、ダイレクトメッセージ、プロファイル、メディア、生成、webhook、エラー — をドメイン別にグループ化し、スコープと目的を示します。

Ayrshare の [MCP Server](/additional/mcp-action-server) は **27 個のツール** を公開しており、以下にドメイン別にグループ化しています。各ツールは、実際の Ayrshare API チェーンを通じてプロセス内でディスパッチされます。

## スコープ

すべてのツールは **Profile** または **Account** のいずれかのスコープを持ちます。

<ul class="custom-bullets">
  <li>**Profile** — ツールはサブプロファイルを対象とするために `profileKey` 引数を受け付けます。</li>
  <li>**Account** — ツールは `profileKey` を **受け付けず**、アカウントレベルで動作します。</li>
</ul>

`profileKey` 引数を **受け付けない** 6 つのツールは次のとおりです: `create_profile`、`list_profiles`、`explain_error`、`validate_media`、`generate_post`、`recommend_hashtags`。その他のすべてのツールは `profileKey` を受け付けます。`generate_jwt_social_linking_url` は `profileKey` を **必須** とします。注: `recommend_hashtags` は `profileKey` 引数を受け付けませんが、接続の `Profile-Key` ヘッダーを読み取って、どのプロファイルに連携された TikTok アカウントを利用するかを決定するため、結果はプロファイル固有となります。

呼び出しごとの `profileKey` 引数と `Profile-Key` ヘッダーの両方が指定された場合、引数が優先されます。優先順位のルールについては [Connect & Setup](/additional/mcp-action-connect#precedence-argument-wins-over-header) を参照してください。

## Posts

| ツール             | スコープ    | 目的                                 |
| --------------- | ------- | ---------------------------------- |
| `create_post`   | Profile | 1 つ以上のリンクされたプラットフォームに公開します。        |
| `validate_post` | Profile | `create_post` と同じ入力で、ドライラン検証を行います。 |
| `get_post`      | Profile | Ayrshare Post ID で投稿を取得します。        |
| `update_post`   | Profile | スケジュール済みまたは承認待ちの投稿を更新します。          |
| `retry_post`    | Profile | 失敗した投稿を再送信します。                     |

## History

| ツール                    | スコープ    | 目的                                                                                                                                                                          |
| ---------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_post_history`     | Profile | Ayrshare 経由で送信された投稿です。                                                                                                                                                      |
| `get_platform_history` | Profile | Ayrshare 以外の投稿を含む、ネットワークから直接取得した投稿とアナリティクスです。X/Twitter の `userId`/`userName` 検索の場合は、アカウント API キーのみを使用してください。そこで `profileKey` 引数や `Profile-Key` ヘッダーを指定すると Error 400 が返されます。 |

## Analytics

| ツール                               | スコープ    | 目的                                                                                                                                                                       |
| --------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `get_post_analytics`              | Profile | Ayrshare Post ID による投稿ごとのメトリクスです。                                                                                                                                        |
| `get_post_analytics_by_social_id` | Profile | ネイティブの Social Post ID による投稿ごとのメトリクスです。                                                                                                                                   |
| `get_social_network_analytics`    | Profile | 接続されたソーシャルアカウントのアカウント全体のアナリティクスと人口統計データです。X/Twitter の `userId`/`userName` 検索の場合は、アカウント API キーのみを使用してください。そこで `profileKey` 引数や `Profile-Key` ヘッダーを指定すると Error 400 が返されます。 |

## Comments

| ツール             | スコープ    | 目的               |
| --------------- | ------- | ---------------- |
| `get_comments`  | Profile | 投稿へのコメントを読み取ります。 |
| `add_comment`   | Profile | トップレベルのコメントです。   |
| `reply_comment` | Profile | コメントに返信します。      |

## Messages / DMs

| ツール                 | スコープ    | 目的                   |
| ------------------- | ------- | -------------------- |
| `get_messages`      | Profile | プラットフォームの DM を取得します。 |
| `send_message`      | Profile | DM を送信します。           |
| `get_auto_response` | Profile | DM 自動応答設定を読み取ります。    |
| `set_auto_response` | Profile | DM 自動応答を構成します。       |

## Profiles

| ツール                               | スコープ    | 目的                                          |
| --------------------------------- | ------- | ------------------------------------------- |
| `list_profiles`                   | Account | サブプロファイルを一覧表示します。                           |
| `create_profile`                  | Account | サブプロファイルを作成します。                             |
| `generate_jwt_social_linking_url` | Profile | JWT ソーシャルリンクの URL を発行します(`profileKey` が必須)。 |

## Media

| ツール              | スコープ    | 目的                                               |
| ---------------- | ------- | ------------------------------------------------ |
| `validate_media` | Account | メディア URL に到達可能かを HEAD チェックし、`contentType` を返します。 |

## Generate

| ツール                  | スコープ    | 目的                                                                                                                  |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| `generate_post`      | Account | AI による投稿文のドラフト生成です。                                                                                                 |
| `recommend_hashtags` | Account | TikTok の視聴回数データからのハッシュタグ提案です。`Profile-Key` ヘッダーで設定されたプロファイルに連携された TikTok アカウントを使用します。呼び出しごとの `profileKey` は受け付けません。 |

## Webhooks

| ツール                  | スコープ    | 目的                      |
| -------------------- | ------- | ----------------------- |
| `register_webhook`   | Profile | webhook を登録します。         |
| `unregister_webhook` | Profile | webhook の登録を解除します。      |
| `list_webhooks`      | Profile | 登録済みの webhook を一覧表示します。 |

## Errors

| ツール             | スコープ    | 目的                                 |
| --------------- | ------- | ---------------------------------- |
| `explain_error` | Account | Ayrshare エラーコードを、原因、分類、修正方法に分解します。 |

<Info>
  このカタログは、稼働中のサーバーの `tools/list` に対して検証されています。今後さらにツールが追加される予定です(例: Links ツール)。ご不明な点があれば、権威ある一覧については `tools/list` を照会してください。このカタログは MCP サーバーチームによって維持されています。
</Info>
