> ## 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

> 27 інструментів, доступних через Ayrshare MCP Server — публікації, історія, аналітика, коментарі, прямі повідомлення, профілі, медіа, генерація, вебхуки та помилки — згруповані за доменами з областю дії та призначенням.

Ayrshare [MCP Server](/additional/mcp-action-server) надає **27 інструментів**, згрупованих нижче за доменами. Кожен інструмент диспетчеризується в межах процесу через реальний ланцюжок Ayrshare API.

## Область дії

Кожен інструмент має область дії **Profile** або **Account**:

<ul class="custom-bullets">
  <li>**Profile** — інструмент приймає аргумент `profileKey` для націлювання на sub-profile.</li>
  <li>**Account** — інструмент **не** приймає `profileKey`; він працює на рівні акаунту.</li>
</ul>

Шість інструментів, які **не** приймають аргумент `profileKey`: `create_profile`, `list_profiles`, `explain_error`, `validate_media`, `generate_post` та `recommend_hashtags`. Усі інші інструменти приймають `profileKey`; `generate_jwt_social_linking_url` **вимагає** його. Примітка: `recommend_hashtags` не приймає аргумент `profileKey`, але все ж читає заголовок `Profile-Key` підключення, щоб визначити, з чийого підключеного акаунту TikTok брати дані, тож його результати є специфічними для профілю.

Коли одночасно присутні аргумент `profileKey` виклику та заголовок `Profile-Key`, перевагу має аргумент. Див. [Connect & Setup](/additional/mcp-action-connect#precedence-argument-wins-over-header) для правил пріоритету.

## Публікації

| Інструмент      | Область | Призначення                                                       |
| --------------- | ------- | ----------------------------------------------------------------- |
| `create_post`   | Profile | Публікація на одну або кілька підключених платформ.               |
| `validate_post` | Profile | Валідація без запуску, ті самі вхідні дані, що й у `create_post`. |
| `get_post`      | Profile | Отримати публікацію за Ayrshare Post ID.                          |
| `update_post`   | Profile | Оновити заплановану публікацію або таку, що очікує на схвалення.  |
| `retry_post`    | Profile | Повторно надіслати невдалу публікацію.                            |

## Історія

| Інструмент             | Область | Призначення                                                                                                                                                                                                                                                         |
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_post_history`     | Profile | Публікації, надіслані через Ayrshare.                                                                                                                                                                                                                               |
| `get_platform_history` | Profile | Публікації та аналітика безпосередньо з мережі, включно з публікаціями, не пов'язаними з Ayrshare. Для пошуку `userId`/`userName` в X/Twitter використовуйте лише API Key акаунту; наявність аргументу `profileKey` або заголовка `Profile-Key` повертає Error 400. |

## Аналітика

| Інструмент                        | Область | Призначення                                                                                                                                                                                                                                     |
| --------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_post_analytics`              | Profile | Метрики окремої публікації за Ayrshare Post ID.                                                                                                                                                                                                 |
| `get_post_analytics_by_social_id` | Profile | Метрики окремої публікації за нативним Social Post ID.                                                                                                                                                                                          |
| `get_social_network_analytics`    | Profile | Аналітика та демографія на рівні акаунту для підключеного соціального акаунту. Для пошуку `userId`/`userName` в X/Twitter використовуйте лише API Key акаунту; наявність аргументу `profileKey` або заголовка `Profile-Key` повертає Error 400. |

## Коментарі

| Інструмент      | Область | Призначення                     |
| --------------- | ------- | ------------------------------- |
| `get_comments`  | Profile | Читати коментарі до публікації. |
| `add_comment`   | Profile | Коментар верхнього рівня.       |
| `reply_comment` | Profile | Відповісти на коментар.         |

## Повідомлення / DM

| Інструмент          | Область | Призначення                           |
| ------------------- | ------- | ------------------------------------- |
| `get_messages`      | Profile | Отримати DM для платформи.            |
| `send_message`      | Profile | Надіслати DM.                         |
| `get_auto_response` | Profile | Читати налаштування автовідповіді DM. |
| `set_auto_response` | Profile | Налаштувати автовідповідь DM.         |

## Профілі

| Інструмент                        | Область | Призначення                                                             |
| --------------------------------- | ------- | ----------------------------------------------------------------------- |
| `list_profiles`                   | Account | Список sub-profiles.                                                    |
| `create_profile`                  | Account | Створити sub-profile.                                                   |
| `generate_jwt_social_linking_url` | Profile | Створити JWT-URL прив'язки соціальних акаунтів (потребує `profileKey`). |

## Медіа

| Інструмент       | Область | Призначення                                                   |
| ---------------- | ------- | ------------------------------------------------------------- |
| `validate_media` | Account | HEAD-перевірка доступності URL медіа; повертає `contentType`. |

## Генерація

| Інструмент           | Область | Призначення                                                                                                                                                                              |
| -------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `generate_post`      | Account | AI-чернетка тексту публікації.                                                                                                                                                           |
| `recommend_hashtags` | Account | Пропозиції хештегів на основі даних про перегляди TikTok. Використовує підключений акаунт TikTok у профілі, заданому заголовком `Profile-Key`; не приймає `profileKey` на рівні виклику. |

## Вебхуки

| Інструмент           | Область | Призначення                     |
| -------------------- | ------- | ------------------------------- |
| `register_webhook`   | Profile | Зареєструвати вебхук.           |
| `unregister_webhook` | Profile | Скасувати реєстрацію вебхука.   |
| `list_webhooks`      | Profile | Список зареєстрованих вебхуків. |

## Помилки

| Інструмент      | Область | Призначення                                                                |
| --------------- | ------- | -------------------------------------------------------------------------- |
| `explain_error` | Account | Розшифрувати код помилки Ayrshare на причину, класифікацію та виправлення. |

<Info>
  Цей каталог перевірено відносно `tools/list` живого сервера. Плануються додаткові інструменти (наприклад, інструменти для Links). У разі сумнівів запитайте `tools/list` для авторитетного набору. Каталог підтримується командою MCP server.
</Info>