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

# সোশ্যাল মিডিয়া MCP টুল রেফারেন্স

> Social media studio MCP সার্ভারের প্রতিটি টুল, ক্যাটাগরি অনুযায়ী: পোস্ট, ড্রাফট, মিডিয়া, ইনবক্স, অ্যানালিটিক্স, AI ক্যাপশন, ওয়েবহুক এবং আরও অনেক কিছু।

Social media studio MCP সার্ভার **205টি টুল** প্রদান করে, নিচে এলাকা অনুযায়ী সাজানো। নিচে তালিকাভুক্ত প্রতিটি টুল স্ট্যান্ডার্ড MCP এন্ডপয়েন্টে (`https://api.so-me.studio/mcp`) রেজিস্টার করা এবং যেকোনো অথেন্টিকেটেড এজেন্ট তার `X-API-Key` দিয়ে কল করতে পারে।

> [!NOTE]
>
> একটি পাবলিক MCP এন্ডপয়েন্টেই 205টি টুলের সবগুলো পাওয়া যায় — **আলাদা কোনো অ্যাডমিন MCP সারফেস নেই**। `create_tenant`, `delete_tenant` ও `list_tenants`-এর মতো টুলগুলো অথেন্টিকেটেড ব্যবহারকারীর স্কোপে থাকা সাধারণ ওয়ার্কস্পেস টুল।
>
> `admin/mcp-tool-costs` ও `api-access/mcp` কন্ট্রোলার JWT-সুরক্ষিত ড্যাশবোর্ড রুট, যা প্রতি টুলের **ক্রেডিট খরচ** ও **ব্যবহারের লগ** দেখতে/এডিট করতে ব্যবহৃত হয় — এগুলো অতিরিক্ত কোনো MCP টুল প্রকাশ করে না।

> [!NOTE]
>
> প্রতিটি টুল কলে প্ল্যান ক্রেডিট খরচ হয় এবং তা আপনার প্রতি-মিনিটের রেট লিমিটে গণনা হয়। রানটাইমে খরচ দেখতে [`list_mcp_tools`](#mcp-ইন্ট্রোস্পেকশন-2টি-টুল) এবং অবশিষ্ট ব্যালেন্স দেখতে [`get_mcp_usage`](#mcp-ইন্ট্রোস্পেকশন-2টি-টুল) ব্যবহার করুন। ক্রেডিট স্তর: `1` পড়া/তালিকা/আনা, `2` লেখা/পরিবর্তন/মুছে ফেলা, `3` অ্যানালিটিক্স, `5` AI টেক্সট, `8` AI ছবি, `10` যৌগিক AI অ্যাকশন।

## সাধারণ enum

এই enum মানগুলো অনেক টুলে পুনরায় ব্যবহৃত হয়।

> **socialMedia (SOCIAL\_MEDIA\_ENUM)**
>
> `TWITTER`, `INSTAGRAM`, `LINKEDIN`, `LINKEDIN_PAGE`, `FACEBOOK`, `TIKTOK`, `YOUTUBE`,
> `THREADS`, `WHATSAPP`, `DRIBBBLE`, `PINTEREST`

> **platform (PLATFORM\_ENUM)**
>
> `TWITTER`, `INSTAGRAM`, `LINKEDIN`, `FACEBOOK`, `TIKTOK`, `YOUTUBE`, `THREADS`, `DRIBBBLE`,
> `PINTEREST`, `WHATSAPP`, `LINKEDIN_PAGE`

> **status (STATUS\_ENUM)**
>
> `POSTED`, `SCHEDULED`, `PENDING`, `FAILED`, `PENDING_APPROVAL`, `REJECTED`

> **postType (POST\_TYPE\_ENUM)**
>
> `TEXT`, `IMAGE`, `MULTIPLE_IMAGES`, `VIDEO`, `CAROUSEL`, `REEL`, `STORY`

> [!NOTE]
>
> সব লিস্ট টুলে পেজিনেশনের ডিফল্ট একই: `page` ডিফল্ট `1`, `limit` ডিফল্ট `20` (সর্বোচ্চ `100`), যদি না কোনো টুল ভিন্ন স্কিম (যেমন কার্সর- বা অফসেট-ভিত্তিক) উল্লেখ করে।

## পোস্ট (11টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_posts` | আপনার ওয়ার্কস্পেসের শিডিউল করা/পাবলিশ করা পোস্টের তালিকা | `page?`, `limit?`, `status?`, `socialMedia?` |
| `get_post` | ID দিয়ে একটি পোস্ট আনা | `id` |
| `create_post` | নতুন পোস্ট তৈরি | `text`, `socialMedia`, `postType?`, `scheduledAt?`, `accountId?` |
| `update_post` | বিদ্যমান পোস্ট আপডেট | `id`, `text?`, `scheduledAt?`, `metaData?`, `postType?` |
| `schedule_post` | বিদ্যমান পোস্ট ভবিষ্যতে পাবলিশের জন্য শিডিউল | `id`, `scheduledAt` |
| `unschedule_post` | পোস্ট শিডিউল থেকে সরানো (আবার pending করা) | `id` |
| `delete_post` | পোস্ট মুছে ফেলা | `id` |
| `retry_post` | ব্যর্থ পোস্ট আবার চেষ্টা (FAILED → PENDING) | `id` |
| `resubmit_post` | প্রত্যাখ্যাত পোস্ট অনুমোদনের জন্য আবার জমা দেওয়া | `id` |
| `bulk_delete_posts` | একসাথে একাধিক পোস্ট মুছে ফেলা | `ids` (array) |
| `get_calendar_posts` | তারিখের পরিসরের পোস্ট আনা (ক্যালেন্ডার ভিউ) | `startDate`, `endDate` |

## পোস্টিং ওয়ার্কফ্লো

রাইট টুলগুলো `text`, `fileIds` ও `scheduledAt`-এর পাশাপাশি তিনটি ঐচ্ছিক ফিল্ড গ্রহণ করে: `threadParts`, `firstComment` ও `tiktok`। প্রতিটি ফিল্ড কী করে তা টুলের বিবরণে বলা আছে; এই অংশে ব্যবহারকারীর হয়ে পোস্ট করা এজেন্টের জন্য প্রস্তাবিত কাজের ক্রম দেওয়া হলো।

**1. প্রথমে মিডিয়া পরীক্ষা করুন**

মিডিয়া এজেন্ট নিজে তৈরি, এডিট বা বাছাই করলে `create_post` বা `schedule_post`-এর আগে উদ্দিষ্ট `targets` দিয়ে `validate_post_media` কল করুন। এটি প্রতি গন্তব্যের জন্য মাপা প্রস্থ, উচ্চতা, সময়কাল, কোডেক ও ফ্রেম রেট, কনফিগার করা সীমা এবং প্রতিটি অমিলের জন্য একটি `fix` স্ট্রিং ফেরত দেয়। ফাইল এজেন্ট তৈরি করলে ফিক্স প্রয়োগ করে আবার যাচাই করুন; ব্যবহারকারী ফাইল দিলে রিপোর্ট দেখান এবং সিদ্ধান্ত ব্যবহারকারীর উপর ছেড়ে দিন। শুধু মাপা মান পাঠান — বাদ দেওয়া প্রতিটি প্রপার্টি পাস নয়, `needs_review` হিসেবে ফেরত আসে। শুরুতেই সঠিক সাইজে মিডিয়া তৈরির সবচেয়ে সস্তা উপায় হলো `get_media_rules`, যা প্রতি প্ল্যাটফর্মের পূর্ণ টেবিল ফেরত দেয়।

**2. আপলোড নিশ্চিত করুন**

`presign_media_upload` লাইব্রেরি ফাইল রিজার্ভ করে এবং PUT URL ফেরত দেয়। প্রতিটি PUT-এ ঘোষিত `mimetype`-এর সমান একটি `Content-Type` হেডার পাঠাতে হবে, নইলে স্টোরেজ 403 দেয়। বাইটগুলো সংরক্ষিত হওয়ার পরই আপলোড সম্পূর্ণ হয়: ফাইলটি পোস্টে যুক্ত করার আগে `verifyUpload: true` দিয়ে `get_media_file` কল করুন।

**3. TikTok: ক্রিয়েটরকে জিজ্ঞেস করুন, অনুমান করবেন না**

TikTok প্রাইভেসি লেভেল ছাড়া কোনো পোস্ট প্রত্যাখ্যান করে, আর শুধু ক্রিয়েটরই তা বেছে নিতে পারেন। টার্গেট অ্যাকাউন্টের জন্য `get_tiktok_creator_info` কল করুন, ব্যবহারকারীকে শুধু `privacy_level_options`-এ ফেরত আসা মানগুলো দিন (প্রাইভেট অ্যাকাউন্ট `PUBLIC_TO_EVERYONE` বেছে নিতে পারে না), পাবলিক অ্যাকাউন্টের জন্য `PUBLIC_TO_EVERYONE` সাজেস্ট করুন, কমেন্ট অনুমোদিত কি না জিজ্ঞেস করুন, তারপর `tiktok` অবজেক্টে `{ privacyLevel, allowComments, allowDuet, allowStitch }` পাঠান। `tiktok.privacyLevel` ছাড়া পোস্ট `TIKTOK_PRIVACY_LEVEL_REQUIRED` দিয়ে প্রত্যাখ্যাত হয়; ক্রিয়েটর ব্যবহার করতে পারেন না এমন লেভেল `TIKTOK_PRIVACY_LEVEL_NOT_ALLOWED` ফেরত দেয়। `TIKTOK_SETTING_FORCED` সতর্কতার অর্থ ক্রিয়েটর অ্যাকাউন্ট জুড়ে কমেন্ট, ডুয়েট বা স্টিচ বন্ধ করেছেন — এটি ব্যবহারকারীকে জানান।

**4. চেইন ও ফার্স্ট কমেন্ট**

`threadParts` শুধু X, Threads, Bluesky ও Mastodon-এ একাধিক পোস্টের চেইন তৈরি করে: `text` হলো প্রথম পোস্ট এবং `threadParts[0]` প্রথম রিপ্লাই। প্রথম পোস্টের পরের অংশ পাবলিশ করা best effort; `metaData.threadPartWarning` সেট থাকলে তা জানান এবং প্রথম পোস্ট কখনো আবার পাবলিশ করবেন না। `firstComment` পোস্টের নিচে (চেইনের ক্ষেত্রে শেষ অংশের নিচে) Facebook, Instagram, X, LinkedIn, LinkedIn Page, Threads, YouTube, TikTok, Bluesky ও Mastodon-এ একটি কমেন্ট দেয় (TikTok-এর জন্য অ্যাকাউন্টস-এ অ্যাকাউন্টের কমেন্ট অ্যাক্সেস চালু থাকতে হবে)। প্রতিশ্রুতি দেওয়ার আগে `list_accounts`-এ `capabilities.firstComment` দেখে নিন — অসমর্থিত টার্গেটেও পোস্ট পাবলিশ হয় এবং `FIRST_COMMENT_UNSUPPORTED` সতর্কতা ফেরত আসে। কমেন্ট লাইভ বলার আগে পোস্টের `firstCommentStatus` পড়ুন।

## পোস্ট কমেন্ট (5টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_post_comments` | পোস্টের কমেন্টের তালিকা | `postId`, `page?`, `limit?` |
| `add_post_comment` | পোস্টে কমেন্ট যোগ করা | `postId`, `content` |
| `update_post_comment` | বিদ্যমান পোস্ট কমেন্ট আপডেট | `commentId`, `content` |
| `delete_post_comment` | পোস্ট কমেন্ট মুছে ফেলা | `commentId` |
| `mark_comments_as_read` | পোস্টের সব কমেন্ট পঠিত হিসেবে চিহ্নিত করা | `postId` |

## ড্রাফট (6টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_drafts` | আপনার ওয়ার্কস্পেসের ড্রাফট পোস্টের তালিকা | `page?`, `limit?` |
| `get_draft` | ID দিয়ে একটি ড্রাফট আনা | `id` |
| `create_draft` | নতুন ড্রাফট পোস্ট তৈরি | `text?`, `title?`, `socialMedia?`, `postType?`, `description?`, `accountId?` |
| `update_draft` | বিদ্যমান ড্রাফট আপডেট | `id`, `text?`, `title?`, `socialMedia?`, `postType?`, `description?`, `accountId?` |
| `delete_draft` | ড্রাফট মুছে ফেলা | `id` |
| `convert_draft` | ড্রাফটকে শিডিউল করা পোস্টে রূপান্তর (ড্রাফটে `text`, `socialMedia`, `postType` থাকতে হবে) | `id`, `scheduledAt?` |

## অ্যাকাউন্ট (3টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_accounts` | সংযুক্ত সোশ্যাল মিডিয়া অ্যাকাউন্টের তালিকা | *(নেই)* |
| `get_account` | সংযুক্ত সোশ্যাল অ্যাকাউন্টের বিবরণ আনা | `id` |
| `disconnect_account` | সংযুক্ত সোশ্যাল অ্যাকাউন্ট বিচ্ছিন্ন (সরানো) | `id` |

## মিডিয়া (13টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_media` | লাইব্রেরির মিডিয়া ফাইলের তালিকা | `page?`, `limit?`, `folderId?` |
| `search_media` | নাম দিয়ে মিডিয়া ফাইল সার্চ | `query` |
| `get_media_file` | ID দিয়ে একটি মিডিয়া ফাইল আনা | `id` |
| `delete_media` | লাইব্রেরি থেকে মিডিয়া ফাইল মুছে ফেলা | `id` |
| `bulk_delete_media` | একসাথে একাধিক মিডিয়া ফাইল মুছে ফেলা | `fileIds` (array) |
| `list_media_folders` | লাইব্রেরির মিডিয়া ফোল্ডারের তালিকা | `page?`, `limit?` |
| `create_media_folder` | নতুন মিডিয়া ফোল্ডার তৈরি | `name`, `parentId?` |
| `delete_media_folder` | মিডিয়া ফোল্ডার ও তার কনটেন্ট মুছে ফেলা | `id` |
| `move_media_file` | মিডিয়া ফাইল অন্য ফোল্ডারে (বা রুটে) সরানো | `id`, `folderId?` |
| `move_media_folder` | ফোল্ডার অন্য প্যারেন্টে (বা রুটে) সরানো | `id`, `parentId?` |
| `rename_media_file` | মিডিয়া ফাইলের নাম বদলানো | `id`, `name` |
| `rename_media_folder` | মিডিয়া ফোল্ডারের নাম বদলানো | `id`, `name` |
| `presign_media_upload` | লাইব্রেরিতে মিডিয়া আপলোডের জন্য presigned S3 PUT URL তৈরি | `files` (array of `{filename, mimetype, size?}`), `folderId?` |

## ইনবক্স (18টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_conversations` | সব সংযুক্ত প্ল্যাটফর্মের ইনবক্স কথোপকথনের তালিকা | *(নেই)* |
| `get_messages` | কথোপকথন থ্রেডের মেসেজ আনা | `threadId` |
| `reply_to_conversation` | কথোপকথন থ্রেডে ফলো-আপ পোস্ট করা | `threadId`, `message` |
| `update_conversation` | কথোপকথনের স্ট্যাটাস আপডেট (`threadStatus`: `OPEN`/`CLOSED`/`ARCHIVED`) | `threadId`, `threadStatus?`, `isSeen?` |
| `delete_conversation` | কথোপকথন থ্রেড মুছে ফেলা | `threadId` |
| `list_saved_replies` | সংরক্ষিত উত্তরের টেমপ্লেটের তালিকা | `page?`, `limit?` |
| `get_saved_reply` | ID দিয়ে একটি সংরক্ষিত উত্তরের টেমপ্লেট আনা | `id` |
| `create_saved_reply` | নতুন সংরক্ষিত উত্তরের টেমপ্লেট তৈরি | `text` |
| `update_saved_reply` | বিদ্যমান সংরক্ষিত উত্তর আপডেট | `id`, `text` |
| `delete_saved_reply` | সংরক্ষিত উত্তর মুছে ফেলা | `id` |
| `subscribe_inbox` | সংযুক্ত সোশ্যাল অ্যাকাউন্টের ইনবক্স সিঙ্ক চালু করা | `accountId` |
| `unsubscribe_inbox` | সংযুক্ত সোশ্যাল অ্যাকাউন্টের ইনবক্স সিঙ্ক বন্ধ করা | `accountId` |
| `edit_inbox_message` | সোশ্যাল ইনবক্সের কমেন্ট/মেসেজ এডিট (Facebook/Instagram) | `threadId`, `messageId`, `commentId`, `message`, `pageId`, `attachment?` |
| `delete_inbox_message` | সোশ্যাল ইনবক্সের কমেন্ট/মেসেজ মুছে ফেলা (Facebook/Instagram) | `threadId`, `messageId`, `commentId`, `pageId` |
| `hide_inbox_message` | সোশ্যাল ইনবক্সের কমেন্ট লুকানো বা আবার দেখানো (Facebook/Instagram) | `threadId`, `messageId`, `commentId`, `pageId`, `hidden?` |
| `preview_bulk_reply` | পাঠানোর আগে বাল্ক রিপ্লাইয়ের প্রাপকদের প্রিভিউ | `threadIds` (array) |
| `create_bulk_reply` | অনেক DM কথোপকথনে একটি উত্তর পাঠানো (ঐচ্ছিক `{{name}}` ব্যক্তিগতকরণসহ) | `threadIds` (array), `message`, `attachments?` (array) |
| `get_bulk_reply_batch` | বাল্ক রিপ্লাই ব্যাচের স্ট্যাটাস ও ফলাফল আনা | `batchId` |

## অনুমোদন (4টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_approvals` | অনুমোদনের অপেক্ষায় থাকা পোস্টের তালিকা | *(নেই)* |
| `approve_post` | অনুমোদনের অপেক্ষায় থাকা পোস্ট অনুমোদন | `postId`, `comment?` |
| `reject_post` | অনুমোদনের অপেক্ষায় থাকা পোস্ট প্রত্যাখ্যান | `postId`, `comment` (আবশ্যক কারণ) |
| `update_review_comment` | অনুমোদন ওয়ার্কফ্লোর পোস্টের রিভিউ/প্রত্যাখ্যানের মন্তব্য আপডেট | `postId`, `comment` |

## টিম (6টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_team_members` | আপনার ওয়ার্কস্পেসের সব টিম সদস্যের তালিকা | *(নেই)* |
| `invite_team_member` | ওয়ার্কস্পেসে কাউকে আমন্ত্রণ (`role`: `owner`/`member`, ডিফল্ট `member`; `postApproval`: `requires_approval`/`auto_approve`, ডিফল্ট `requires_approval`, owner-দের ক্ষেত্রে উপেক্ষিত) | `email`, `role?`, `postApproval?` |
| `remove_team_member` | ওয়ার্কস্পেস থেকে সদস্য সরানো | `memberId` |
| `update_member_role` | টিম সদস্যের ভূমিকা আপডেট (`role`: `owner`/`member`)। একটি ওয়ার্কস্পেসে একাধিক owner থাকতে পারে; শেষ owner-কে ডিমোট করা যায় না। `postApproval` (`requires_approval`/`auto_approve`) owner-দের ক্ষেত্রে উপেক্ষিত, তাঁরা সবসময় রিভিউ ছাড়াই পাবলিশ করেন | `memberId`, `role`, `postApproval?` |
| `list_team_invitations` | অপেক্ষমাণ টিম আমন্ত্রণের তালিকা | `page?`, `limit?` |
| `cancel_team_invitation` | অপেক্ষমাণ টিম আমন্ত্রণ বাতিল | `invitationId` |

## বায়োলিংক (19টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_biolinks` | সব বায়োলিংক পেজের তালিকা | *(নেই)* |
| `get_biolink` | বায়োলিংক পেজের বিবরণ আনা | `id` |
| `create_biolink` | নতুন বায়োলিংক পেজ তৈরি | `slug?`, `displayName?`, `bio?` |
| `update_biolink` | বিদ্যমান বায়োলিংক পেজ আপডেট | `id`, `displayName?`, `bio?`, `slug?` |
| `delete_biolink` | বায়োলিংক পেজ মুছে ফেলা | `id` |
| `publish_biolink` | বায়োলিংকের পাবলিশ অবস্থা টগল করা | `id` |
| `change_biolink_theme` | বায়োলিংককে প্রিসেট থিমে বদলানো | `id`, `theme` |
| `set_biolink_custom_theme` | বায়োলিংকে কাস্টম থিম রং প্রয়োগ | `id`, `backgroundColor?`, `textColor?`, `buttonColor?`, `buttonTextColor?` |
| `list_biolink_buttons` | বায়োলিংক পেজের বাটনের তালিকা | `biolinkId`, `page?`, `limit?` |
| `create_biolink_button` | বায়োলিংক পেজে বাটন যোগ | `biolinkId`, `type`, `text`, `url?`, `email?`, `phone?`, `icon?`, `isActive?` |
| `update_biolink_button` | বায়োলিংক পেজের বাটন আপডেট | `biolinkId`, `buttonId`, `text?`, `url?`, `email?`, `phone?`, `icon?`, `isActive?` |
| `delete_biolink_button` | বায়োলিংক পেজ থেকে বাটন মুছে ফেলা | `biolinkId`, `buttonId` |
| `reorder_biolink_buttons` | বায়োলিংক পেজের বাটনের ক্রম বদলানো | `biolinkId`, `buttonIds` (array) |
| `list_biolink_posts` | বায়োলিংকের গ্যালারি পোস্টের তালিকা | `biolinkId` |
| `create_biolink_post` | বায়োলিংকে গ্যালারি পোস্ট যোগ | `biolinkId`, `imageUrl?`, `caption?`, `linkUrl?`, `isVisible?` |
| `update_biolink_post` | বায়োলিংকের গ্যালারি পোস্ট আপডেট | `biolinkId`, `postId`, `imageUrl?`, `caption?`, `linkUrl?`, `isVisible?` |
| `delete_biolink_post` | বায়োলিংক থেকে গ্যালারি পোস্ট মুছে ফেলা | `biolinkId`, `postId` |
| `reorder_biolink_posts` | বায়োলিংকের গ্যালারি পোস্টের ক্রম বদলানো | `biolinkId`, `itemIds` (array) |
| `get_biolink_analytics` | বায়োলিংক পেজের অ্যানালিটিক্স আনা (ভিউ, ক্লিক) | `biolinkId` |

## AI কনটেন্ট (10টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `generate_caption` | সোশ্যাল মিডিয়া প্ল্যাটফর্মের জন্য AI ক্যাপশন তৈরি | `platform`, `topic`, `tone?` |
| `generate_content` | যেকোনো ধরনের AI টেক্সট কনটেন্ট তৈরি বা নতুন করে লেখা (পোস্ট, ক্যাপশন, হ্যাশট্যাগ, হেডলাইন, বায়ো, থ্রেড, ইমেইল ইত্যাদি) | `text`, `type?`, `command?` (`generate`/`rewrite`/`insert`), `tone?`, `platform?`, `customInstruction?` |
| `generate_image` | টেক্সট প্রম্পট থেকে AI ছবি তৈরি | `prompt`, `style?`, `aspectRatio?`, `negativePrompt?`, `provider?`, `numImages?` |
| `generate_and_schedule` | এক কলে AI কনটেন্ট তৈরি, পোস্ট তৈরি ও শিডিউল | `platform`, `socialMedia`, `topic`, `scheduledAt`, `tone?`, `accountId?` |
| `get_ai_history` | AI প্রম্পট জেনারেশনের ইতিহাস আনা | `page?`, `limit?` |
| `get_ai_credits` | বর্তমান প্ল্যানের AI ক্রেডিট ব্যালেন্স ও সীমা আনা (টেক্সট, ছবি, UGC ভিডিও) | *(নেই)* |
| `list_ai_image_providers` | বর্তমান প্ল্যানে অনুমোদিত AI ছবি জেনারেশন প্রোভাইডারের তালিকা | *(নেই)* |
| `list_generated_images` | পেজিনেশনসহ AI-তৈরি ছবির তালিকা | `page?`, `limit?` |
| `get_generated_image` | ID দিয়ে একটি AI-তৈরি ছবির বিবরণ আনা | `id` |
| `delete_generated_image` | ID দিয়ে AI-তৈরি ছবি মুছে ফেলা | `id` |

## AI ভিডিও / UGC (9টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `generate_video` | AI UGC ভিডিও তৈরি | `hookText` (সর্বোচ্চ 500 অক্ষর), `avatarId`, `soundId?`, `productDemoUrl?` |
| `list_videos` | তৈরি করা UGC ভিডিওর তালিকা | `page?`, `limit?` |
| `get_video` | ID দিয়ে তৈরি করা ভিডিও আনা (জেনারেশন স্ট্যাটাসসহ) | `id` |
| `delete_video` | তৈরি করা ভিডিও মুছে ফেলা | `id` |
| `list_avatars` | ভিডিও জেনারেশনের জন্য উপলব্ধ UGC অ্যাভাটারের তালিকা | `page?`, `limit?` |
| `list_sounds` | ভিডিও জেনারেশনের জন্য উপলব্ধ সাউন্ড/মিউজিকের তালিকা | `page?`, `limit?`, `genre?` |
| `get_sound_genres` | UGC ভিডিওর জন্য উপলব্ধ ব্যাকগ্রাউন্ড-সাউন্ড জনরার তালিকা | *(নেই)* |
| `generate_hook_suggestions` | UGC ভিডিওর জন্য AI হুক/স্ক্রিপ্ট সাজেশন তৈরি | `topic`, `platform?`, `count?` (ডিফল্ট 5) |
| `list_ai_video_providers` | বর্তমান প্ল্যানে অনুমোদিত AI UGC ভিডিও প্রোভাইডারের তালিকা | *(নেই)* |

## অ্যানালিটিক্স (26টি টুল)

### ক্রস-প্ল্যাটফর্ম ও পোস্ট অনুযায়ী

| টুল | বিবরণ | Params |
| - | - | - |
| `get_analytics_summary` | ওয়ার্কস্পেসের অ্যানালিটিক্স ওভারভিউ — স্ট্যাটাস ও প্ল্যাটফর্ম অনুযায়ী পোস্ট সংখ্যা | *(নেই)* |
| `get_platform_analytics` | নির্দিষ্ট সংযুক্ত সোশ্যাল অ্যাকাউন্টের বিস্তারিত অ্যানালিটিক্স | `accountId`, `days?` |
| `get_post_analytics` | নির্দিষ্ট পোস্টের অ্যানালিটিক্স | `postId`, `days?` |

### প্ল্যাটফর্ম অনুযায়ী অ্যানালিটিক্স

| টুল | বিবরণ | Params |
| - | - | - |
| `get_facebook_analytics` | Facebook পেজ-স্তরের অ্যানালিটিক্স | `accountId`, `days?` |
| `get_facebook_posts_analytics` | পোস্ট অনুযায়ী Facebook পেজ অ্যানালিটিক্স | `accountId`, `days?` |
| `get_facebook_videos_analytics` | ভিডিও অনুযায়ী Facebook পেজ অ্যানালিটিক্স | `accountId`, `days?` |
| `get_instagram_analytics` | Instagram অ্যাকাউন্ট-স্তরের অ্যানালিটিক্স | `accountId`, `days?` |
| `get_instagram_media_analytics` | পোস্ট অনুযায়ী Instagram মিডিয়া অ্যানালিটিক্স | `accountId`, `days?` |
| `get_instagram_stories_analytics` | Instagram স্টোরি অ্যানালিটিক্স | `accountId`, `days?` |
| `get_linkedin_analytics` | LinkedIn পেজ-স্তরের অ্যানালিটিক্স | `accountId`, `days?` |
| `get_linkedin_posts_analytics` | পোস্ট অনুযায়ী LinkedIn পেজ অ্যানালিটিক্স | `accountId`, `days?` |
| `get_youtube_analytics` | YouTube চ্যানেল-স্তরের অ্যানালিটিক্স | `accountId`, `days?` |
| `get_youtube_videos_analytics` | ভিডিও অনুযায়ী YouTube চ্যানেল অ্যানালিটিক্স | `accountId`, `days?` |
| `get_twitter_analytics` | Twitter/X অ্যাকাউন্ট-স্তরের অ্যানালিটিক্স | `accountId`, `days?` |
| `get_twitter_content_analytics` | Twitter/X কনটেন্ট-স্তরের অ্যানালিটিক্স | `accountId`, `days?` |
| `get_whatsapp_analytics` | WhatsApp Business অ্যাকাউন্ট অ্যানালিটিক্স | `accountId`, `days?` |
| `get_tiktok_analytics` | TikTok অ্যাকাউন্ট অ্যানালিটিক্স | `accountId`, `days?` |
| `get_bluesky_analytics` | Bluesky অ্যাকাউন্ট অ্যানালিটিক্স | `accountId`, `days?` |
| `get_mastodon_analytics` | Mastodon অ্যাকাউন্ট অ্যানালিটিক্স | `accountId`, `days?` |
| `get_reddit_account_analytics` | Reddit অ্যাকাউন্ট-স্তরের অ্যানালিটিক্স | `accountId`, `days?` |
| `get_reddit_submissions_analytics` | Reddit সাবমিশন (পোস্ট) অ্যানালিটিক্স | `accountId`, `days?` |
| `get_pinterest_analytics` | Pinterest অ্যাকাউন্ট অ্যানালিটিক্স | `accountId`, `days?` |
| `get_pinterest_pins_analytics` | পিন অনুযায়ী Pinterest অ্যানালিটিক্স | `accountId`, `days?` |
| `get_pinterest_top_pins_analytics` | সেরা পারফর্ম করা Pinterest পিন (`sortBy`: `IMPRESSION`/`ENGAGEMENT`/`OUTBOUND_CLICK`/`PIN_CLICK`/`SAVE`) | `accountId`, `days?`, `sortBy?` |
| `get_pinterest_top_video_pins_analytics` | সেরা পারফর্ম করা Pinterest ভিডিও পিন | `accountId`, `days?`, `sortBy?` |
| `get_gmb_analytics` | Google Business Profile (GMB) লোকেশনের অ্যানালিটিক্স | `accountId`, `locationId?`, `days?` |

> [!NOTE]
>
> প্রতিটি অ্যানালিটিক্স টুলে `days` ডিফল্ট `7` (লুকব্যাক উইন্ডো)।

## পোস্টের সেরা সময় (3টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `get_best_time_recommendations` | ওয়ার্কস্পেসের সব সংযুক্ত অ্যাকাউন্টের সেরা পোস্টিং সময়ের সুপারিশের তালিকা | *(নেই)* |
| `get_best_time_recommendation` | একটি অ্যাকাউন্টের সেরা সময়ের সুপারিশ আনা (হিটম্যাপ + শীর্ষ সময়সীমা) | `socialAccountId` |
| `recompute_best_time_recommendation` | সাম্প্রতিক এনগেজমেন্ট ইতিহাস থেকে অ্যাকাউন্টের সেরা সময়ের সুপারিশ নতুন করে হিসাব করা | `socialAccountId` |

## নোটিফিকেশন (5টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_notifications` | অথেন্টিকেটেড ব্যবহারকারীর ইন-অ্যাপ নোটিফিকেশনের তালিকা (কার্সর পেজিনেশন) | `category?`, `isRead?`, `limit?`, `cursor?` |
| `get_unread_notification_count` | অপঠিত নোটিফিকেশনের সংখ্যা আনা, ঐচ্ছিকভাবে ক্যাটাগরি অনুযায়ী | `category?` |
| `mark_notification_read` | একটি নোটিফিকেশন পঠিত হিসেবে চিহ্নিত করা | `id` |
| `mark_all_notifications_read` | সব নোটিফিকেশন (ঐচ্ছিকভাবে একটি ক্যাটাগরির মধ্যে) পঠিত হিসেবে চিহ্নিত করা | `category?` |
| `archive_notification` | নোটিফিকেশন আর্কাইভ (বাতিল) করা | `id` |

## নলেজ / RAG (6টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_knowledge` | AI অ্যাসিস্ট্যান্টের (RAG) ব্যবহৃত নলেজ ডকুমেন্টের তালিকা | `search?`, `tags?` (array), `activeOnly?`, `sortBy?`, `sortOrder?` (`ASC`/`DESC`), `limit?`, `offset?` |
| `get_knowledge` | নিষ্কাশিত টেক্সট ও মেটাডেটাসহ একটি নলেজ ডকুমেন্ট আনা | `id` |
| `create_knowledge` | আপলোড করা ফাইল বা টাইপ করা নোট থেকে নলেজ ডকুমেন্ট তৈরি (`sourceType`: `pdf`/`image`/`text_file`/`note`) | `sourceType`, `title`, `fileId?`, `body?`, `tags?`, `isActive?` |
| `update_knowledge` | নলেজ ডকুমেন্টের মেটাডেটা বা নোটের বডি আপডেট | `id`, `title?`, `tags?`, `isActive?`, `body?` |
| `reprocess_knowledge` | ব্যর্থ PDF/ছবি/টেক্সট নলেজ ডকুমেন্টের এক্সট্র্যাকশন আবার চেষ্টা | `id` |
| `delete_knowledge` | নলেজ ডকুমেন্ট মুছে ফেলা | `id` |

> [!NOTE]
>
> `create_knowledge`-এ `pdf`/`image`/`text_file` সোর্স টাইপের জন্য `fileId` আবশ্যক, আর `note`-এর জন্য `body` আবশ্যক।

## Canva (4টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `get_canva_status` | অথেন্টিকেটেড ব্যবহারকারীর জন্য Canva সংযুক্ত আছে কি না যাচাই | *(নেই)* |
| `list_canva_designs` | ব্যবহারকারীর Canva ডিজাইনের তালিকা (পেজিনেটেড, সার্চযোগ্য) | `query?`, `continuation?` |
| `export_canva_design` | Canva ডিজাইন ছবি হিসেবে এক্সপোর্ট (অ্যাসিঙ্ক; এক্সপোর্ট জব ID ফেরত দেয়) | `designId` |
| `get_canva_export_status` | Canva ডিজাইন এক্সপোর্ট জবের স্ট্যাটাস পোল করা | `exportId` |

## টেমপ্লেট (3টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_templates` | ক্যাটাগরি অনুযায়ী উপলব্ধ কনটেন্ট টেমপ্লেটের তালিকা (`meme`, `quote_card`, `before_after`, `reaction`, `announcement`, `testimonial`) | `category?`, `page?`, `limit?` |
| `get_template` | ID দিয়ে একটি কনটেন্ট টেমপ্লেট আনা | `id` |
| `render_template` | দেওয়া ফিল্ড মান দিয়ে টেমপ্লেট রেন্ডার করা | `id`, `fields` (object) |

## সহায়তা ও সাপোর্ট (5টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `create_ticket` | সাপোর্ট টিকেট তৈরি (`priority`: `LOW`/`MEDIUM`/`HIGH`, ডিফল্ট `MEDIUM`) | `subject`, `message`, `priority?` |
| `list_tickets` | আপনার সাপোর্ট টিকেটের তালিকা | `page?`, `limit?` |
| `get_ticket` | বিস্তারিতসহ সাপোর্ট টিকেট আনা | `id` |
| `send_ticket_message` | সাপোর্ট টিকেটে মেসেজ পাঠানো | `ticketId`, `message` |
| `list_ticket_messages` | সাপোর্ট টিকেটের সব মেসেজের তালিকা | `ticketId` |

## WhatsApp (6টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_whatsapp_templates` | WhatsApp Business মেসেজ টেমপ্লেটের তালিকা | `accountId` |
| `get_whatsapp_template` | নাম দিয়ে একটি WhatsApp মেসেজ টেমপ্লেট আনা | `accountId`, `templateName` |
| `create_whatsapp_template` | WhatsApp মেসেজ টেমপ্লেট তৈরি (Meta অনুমোদনের জন্য জমা) (`category`: `MARKETING`/`UTILITY`/`AUTHENTICATION`) | `accountId`, `name`, `language`, `category`, `components` (array) |
| `delete_whatsapp_template` | WhatsApp মেসেজ টেমপ্লেট মুছে ফেলা | `accountId`, `templateName` |
| `send_whatsapp_template` | প্রাপককে WhatsApp টেমপ্লেট মেসেজ পাঠানো (E.164 ফোন) | `accountId`, `to`, `templateName`, `languageCode`, `components?` |
| `upload_whatsapp_template_media` | টেমপ্লেটের হেডার মিডিয়া (ছবি/ভিডিও/ডকুমেন্ট) আপলোড | `accountId`, `fileType`, `fileUrl?`, `fileBase64?` |

## ইন্টিগ্রেশন হেল্পার (9টি টুল)

পাবলিশ করার আগে প্ল্যাটফর্ম-নির্দিষ্ট গন্তব্য (বোর্ড, চ্যানেল, সাবরেডিট, লোকেশন) খুঁজে নিন।

| টুল | বিবরণ | Params |
| - | - | - |
| `list_pinterest_boards` | অ্যাকাউন্টের Pinterest বোর্ডের তালিকা (পোস্টের আগে বোর্ড বেছে নিন) | `accountId` |
| `create_pinterest_board` | নতুন Pinterest বোর্ড তৈরি (`privacy` যেমন `PUBLIC`/`SECRET`) | `accountId`, `name`, `description?`, `privacy?` |
| `list_reddit_subreddits` | সংযুক্ত Reddit অ্যাকাউন্ট যে সাবরেডিটের সদস্য তাদের তালিকা | `accountId` |
| `list_reddit_flairs` | সাবরেডিটের উপলব্ধ পোস্ট ফ্লেয়ারের তালিকা | `accountId`, `subreddit` |
| `list_gmb_locations` | অ্যাকাউন্টের Google Business Profile (GMB) লোকেশনের তালিকা | `accountId` |
| `list_discord_channels` | বট-মোড অ্যাকাউন্টের জন্য উপলব্ধ Discord চ্যানেলের তালিকা | `accountId` |
| `list_slack_channels` | সংযুক্ত ওয়ার্কস্পেসের Slack চ্যানেলের তালিকা | `accountId` |
| `list_telegram_chats` | অ্যাকাউন্টের জন্য উপলব্ধ Telegram চ্যাট/গ্রুপের তালিকা | `accountId` |
| `get_tiktok_creator_info` | TikTok ক্রিয়েটর/অ্যাকাউন্টের তথ্য আনা (পোস্টিং সক্ষমতা যাচাই) | `accountId` |

## ওয়েবহুক (10টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_webhook_subscriptions` | আপনার ওয়ার্কস্পেসের সব ওয়েবহুক সাবস্ক্রিপশনের তালিকা | *(নেই)* |
| `get_webhook_subscription` | ID দিয়ে একটি ওয়েবহুক সাবস্ক্রিপশন আনা | `id` |
| `create_webhook_subscription` | নতুন ওয়েবহুক সাবস্ক্রিপশন তৈরি | `url`, `categories` (array), `description?` |
| `update_webhook_subscription` | বিদ্যমান ওয়েবহুক সাবস্ক্রিপশন আপডেট | `id`, `url?`, `categories?`, `description?`, `isActive?`, `regenerateSecret?` |
| `delete_webhook_subscription` | ওয়েবহুক সাবস্ক্রিপশন মুছে ফেলা | `id` |
| `test_webhook_subscription` | ওয়েবহুক সাবস্ক্রিপশনে টেস্ট পিং পাঠানো | `id` |
| `list_webhook_deliveries` | ওয়েবহুক ডেলিভারি লগের তালিকা (ফিল্টারযোগ্য) | `page?`, `limit?`, `subscriptionId?`, `event?`, `status?`, `category?` |
| `get_webhook_delivery` | পূর্ণ পেলোড ও স্ট্যাটাসসহ একটি ওয়েবহুক ডেলিভারি লগ আনা | `id` |
| `retry_webhook_delivery` | ব্যর্থ ওয়েবহুক ডেলিভারি আবার চেষ্টা | `id` |
| `list_webhook_events` | ক্যাটাগরি অনুযায়ী সব উপলব্ধ ওয়েবহুক ইভেন্ট টাইপের তালিকা | *(নেই)* |

> [!NOTE]
>
> ওয়েবহুক `categories` গ্রহণ করে: `post`, `inbox`, `account`, `subscription`, `ai`, `team`, `support`।
> ডেলিভারির `status` ফিল্টার গ্রহণ করে: `pending`, `success`, `retrying`, `failed`।

## প্ল্যান, বিলিং ও ব্যবহার (6টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `get_billing` | সাবস্ক্রিপশন ও বিলিং তথ্য আনা | *(নেই)* |
| `get_usage` | বর্তমান বিলিং পিরিয়ডের ব্যবহারের বিভাজন আনা | *(নেই)* |
| `get_plans` | মূল্য ও দৃশ্যমানতাসহ প্ল্যান ক্যাটালগ আনা | *(নেই)* |
| `get_plan_features` | অভ্যন্তরীণ শনাক্তকারী ব্যবহার করে ফিচার ম্যাট্রিক্স আনা: `solo` (Lite), `team` (Standard), `scale` (Advanced) বা `lifetime` (Lifetime)। `hobby` একটি বাতিল হয়ে যাওয়া লেগেসি প্ল্যান | `planName` |
| `get_subscription` | ওয়ার্কস্পেসের বর্তমান সাবস্ক্রিপশন স্ট্যাটাস, প্ল্যান ও সীমা আনা | *(নেই)* |
| `list_invoices` | বর্তমান সাবস্ক্রিপশনের ইনভয়েসের তালিকা | *(নেই)* |

## রেফারেল (2টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `get_referral_code` | অথেন্টিকেটেড ব্যবহারকারীর রেফারেল কোড আনা | *(নেই)* |
| `get_referral_stats` | রেফারেল কোড, রেফারেল সংখ্যা, অর্জিত ক্রেডিট ও শেয়ার URL আনা | *(নেই)* |

## API কী (3টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_api_keys` | বর্তমান ওয়ার্কস্পেসের সক্রিয় API কী-র তালিকা | *(নেই)* |
| `create_api_key` | নতুন API কী তৈরি; পূর্ণ কী শুধু একবারই ফেরত দেওয়া হয় | `name`, `expiresAt?` |
| `revoke_api_key` | API কী বাতিল | `id` |

## টেন্যান্ট / ওয়ার্কস্পেস (4টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `list_tenants` | অথেন্টিকেটেড ব্যবহারকারী যে ওয়ার্কস্পেস/টেন্যান্টের সদস্য তাদের তালিকা | `page?`, `limit?` |
| `create_tenant` | অথেন্টিকেটেড ব্যবহারকারীর মালিকানায় নতুন ওয়ার্কস্পেস/টেন্যান্ট তৈরি | `name`, `description?` |
| `delete_tenant` | ওয়ার্কস্পেস/টেন্যান্ট মুছে ফেলা | `id` |
| `leave_tenant` | ব্যবহারকারী সদস্য এমন ওয়ার্কস্পেস/টেন্যান্ট ছেড়ে যাওয়া | `tenantId?` (ডিফল্ট বর্তমানটি) |

## প্রোফাইল ও পছন্দ (5টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `get_profile` | আপনার ইউজার প্রোফাইল আনা | *(নেই)* |
| `update_profile` | অথেন্টিকেটেড ব্যবহারকারীর প্রোফাইল আপডেট | `name?`, `password?`, `email?` |
| `get_user_preferences` | অথেন্টিকেটেড ব্যবহারকারীর পছন্দ আনা (নোটিফিকেশন সেটিংস, টাইমজোন, UI পছন্দ) | *(নেই)* |
| `update_user_preferences` | অথেন্টিকেটেড ব্যবহারকারীর পছন্দ আপডেট (মার্জ) | `preferences` (object) |
| `get_current_tenant` | বর্তমানে সক্রিয় ওয়ার্কস্পেসের (টেন্যান্ট) বিবরণ আনা | *(নেই)* |

## অর্গানাইজেশন (2টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `get_organization` | ওয়ার্কস্পেস/অর্গানাইজেশনের বিবরণ আনা | *(নেই)* |
| `update_organization` | বর্তমান ওয়ার্কস্পেস / অর্গানাইজেশন আপডেট | `name?`, `description?`, `color?` (hex), `timezone?` (IANA) |

## MCP ইন্ট্রোস্পেকশন (2টি টুল)

| টুল | বিবরণ | Params |
| - | - | - |
| `get_mcp_usage` | বর্তমান পিরিয়ডে এই ওয়ার্কস্পেসের MCP ক্রেডিট ব্যবহার, সীমা ও প্রতি টুলের বিভাজন আনা | *(নেই)* |
| `list_mcp_tools` | সব উপলব্ধ MCP টুল ও তাদের ক্রেডিট খরচের তালিকা | *(নেই)* |

## ব্যবহারের উদাহরণ

```json পোস্ট তৈরি ও শিডিউল theme={null}
{
  "name": "create_post",
  "arguments": {
    "text": "Shipping our biggest update yet 🚀 Read the changelog → so-me.studio/changelog",
    "socialMedia": "LINKEDIN_PAGE",
    "postType": "TEXT",
    "scheduledAt": "2026-06-20T14:00:00.000Z",
    "accountId": "acct_01HZ..."
  }
}
```

```json AI: এক কলে তৈরি, পোস্ট করা ও শিডিউল theme={null}
{
  "name": "generate_and_schedule",
  "arguments": {
    "platform": "INSTAGRAM",
    "socialMedia": "INSTAGRAM",
    "topic": "5 tips for consistent posting as a solo founder",
    "tone": "engaging",
    "scheduledAt": "2026-06-21T16:30:00.000Z"
  }
}
```

```json AI ছবি তৈরি (4টি ভ্যারিয়েন্ট) theme={null}
{
  "name": "generate_image",
  "arguments": {
    "prompt": "minimalist product launch banner, soft gradient background",
    "style": "illustration",
    "aspectRatio": "16:9",
    "provider": "flux_fal",
    "numImages": 4
  }
}
```

```json Instagram-এর বিস্তারিত অ্যানালিটিক্স আনা theme={null}
{
  "name": "get_instagram_media_analytics",
  "arguments": {
    "accountId": "acct_01HZ...",
    "days": 30
  }
}
```

```json ব্যক্তিগতকরণসহ অনেক DM-এ বাল্ক রিপ্লাই theme={null}
{
  "name": "create_bulk_reply",
  "arguments": {
    "threadIds": ["thr_1", "thr_2", "thr_3"],
    "message": "Hey {{firstName}}, thanks for reaching out! Here's the link you asked for."
  }
}
```

```json একটি অ্যাকাউন্টের পোস্টের সেরা সময় theme={null}
{
  "name": "get_best_time_recommendation",
  "arguments": {
    "socialAccountId": "acct_01HZ..."
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.