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

# Danh mục Công cụ MCP

> 27 công cụ được cung cấp bởi Ayrshare MCP Server — bài đăng, lịch sử, phân tích, bình luận, tin nhắn trực tiếp, profiles, media, generation, webhook và lỗi — nhóm theo miền với phạm vi và mục đích.

[MCP Server](/additional/mcp-action-server) của Ayrshare cung cấp **27 công cụ**, được nhóm bên dưới theo miền. Mỗi công cụ được điều phối trong tiến trình qua chuỗi Ayrshare API thực tế.

## Phạm vi

Mọi công cụ đều có phạm vi **Profile** hoặc **Account**:

<ul class="custom-bullets">
  <li>**Profile** — công cụ chấp nhận đối số `profileKey` để nhắm tới một sub-profile.</li>
  <li>**Account** — công cụ **không** nhận `profileKey`; nó hoạt động ở cấp độ tài khoản.</li>
</ul>

Sáu công cụ **không** nhận đối số `profileKey` là: `create_profile`, `list_profiles`, `explain_error`, `validate_media`, `generate_post`, và `recommend_hashtags`. Tất cả các công cụ khác chấp nhận `profileKey`; `generate_jwt_social_linking_url` **bắt buộc** phải có. Lưu ý: `recommend_hashtags` không nhận đối số `profileKey` nhưng vẫn đọc header `Profile-Key` của kết nối để chọn tài khoản TikTok đã liên kết của ai để lấy dữ liệu, vì vậy kết quả của nó là cụ thể theo profile.

Khi có cả đối số `profileKey` theo lệnh gọi và header `Profile-Key`, đối số thắng. Xem [Kết nối & Thiết lập](/additional/mcp-action-connect#precedence-argument-wins-over-header) để biết các quy tắc ưu tiên.

## Bài đăng

| Công cụ         | Phạm vi | Mục đích                                                   |
| --------------- | ------- | ---------------------------------------------------------- |
| `create_post`   | Profile | Xuất bản đến một hoặc nhiều nền tảng đã liên kết.          |
| `validate_post` | Profile | Xác thực dry-run, cùng đầu vào như `create_post`.          |
| `get_post`      | Profile | Lấy một bài đăng theo Ayrshare Post ID.                    |
| `update_post`   | Profile | Cập nhật một bài đăng đã lên lịch hoặc đang chờ phê duyệt. |
| `retry_post`    | Profile | Gửi lại một bài đăng thất bại.                             |

## Lịch sử

| Công cụ                | Phạm vi | Mục đích                                                                                                                                                                                                                                            |
| ---------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_post_history`     | Profile | Bài đăng được gửi qua Ayrshare.                                                                                                                                                                                                                     |
| `get_platform_history` | Profile | Bài đăng và phân tích trực tiếp từ mạng, bao gồm các bài đăng không thuộc Ayrshare. Đối với tra cứu `userId`/`userName` của X/Twitter, hãy chỉ sử dụng API key tài khoản; một đối số `profileKey` hoặc header `Profile-Key` ở đó sẽ trả về Lỗi 400. |

## Phân tích

| Công cụ                           | Phạm vi | Mục đích                                                                                                                                                                                                                                            |
| --------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_post_analytics`              | Profile | Số liệu theo bài đăng theo Ayrshare Post ID.                                                                                                                                                                                                        |
| `get_post_analytics_by_social_id` | Profile | Số liệu theo bài đăng theo Social Post ID gốc.                                                                                                                                                                                                      |
| `get_social_network_analytics`    | Profile | Phân tích toàn tài khoản và nhân khẩu học cho một tài khoản mạng xã hội đã kết nối. Đối với tra cứu `userId`/`userName` của X/Twitter, hãy chỉ sử dụng API key tài khoản; một đối số `profileKey` hoặc header `Profile-Key` ở đó sẽ trả về Lỗi 400. |

## Bình luận

| Công cụ         | Phạm vi | Mục đích                         |
| --------------- | ------- | -------------------------------- |
| `get_comments`  | Profile | Đọc bình luận trên một bài đăng. |
| `add_comment`   | Profile | Bình luận cấp cao nhất.          |
| `reply_comment` | Profile | Trả lời một bình luận.           |

## Tin nhắn / DM

| Công cụ             | Phạm vi | Mục đích                         |
| ------------------- | ------- | -------------------------------- |
| `get_messages`      | Profile | Lấy DM cho một nền tảng.         |
| `send_message`      | Profile | Gửi một DM.                      |
| `get_auto_response` | Profile | Đọc cài đặt tự động phản hồi DM. |
| `set_auto_response` | Profile | Cấu hình tự động phản hồi DM.    |

## Profiles

| Công cụ                           | Phạm vi | Mục đích                                           |
| --------------------------------- | ------- | -------------------------------------------------- |
| `list_profiles`                   | Account | Liệt kê các sub-profile.                           |
| `create_profile`                  | Account | Tạo một sub-profile.                               |
| `generate_jwt_social_linking_url` | Profile | Tạo URL social-linking JWT (yêu cầu `profileKey`). |

## Media

| Công cụ          | Phạm vi | Mục đích                                                             |
| ---------------- | ------- | -------------------------------------------------------------------- |
| `validate_media` | Account | HEAD-check một URL media có thể truy cập được; trả về `contentType`. |

## Generate

| Công cụ              | Phạm vi | Mục đích                                                                                                                                                                 |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `generate_post`      | Account | Bản nháp nội dung bài đăng do AI tạo.                                                                                                                                    |
| `recommend_hashtags` | Account | Gợi ý hashtag từ dữ liệu số lượt xem TikTok. Sử dụng tài khoản TikTok đã liên kết trên profile được đặt bởi header `Profile-Key`; không nhận `profileKey` theo lệnh gọi. |

## Webhook

| Công cụ              | Phạm vi | Mục đích                        |
| -------------------- | ------- | ------------------------------- |
| `register_webhook`   | Profile | Đăng ký một webhook.            |
| `unregister_webhook` | Profile | Hủy đăng ký một webhook.        |
| `list_webhooks`      | Profile | Liệt kê các webhook đã đăng ký. |

## Lỗi

| Công cụ         | Phạm vi | Mục đích                                                                    |
| --------------- | ------- | --------------------------------------------------------------------------- |
| `explain_error` | Account | Giải mã một mã lỗi Ayrshare thành nguyên nhân, phân loại và cách khắc phục. |

<Info>
  Danh mục này được xác minh với `tools/list` của server live. Nhiều công cụ hơn được lên kế hoạch (ví dụ: các công cụ Links). Nếu có nghi ngờ, hãy truy vấn `tools/list` để có tập hợp có thẩm quyền. Danh mục này được duy trì bởi đội ngũ MCP server.
</Info>
