@devries-cameron20 / composio Mirror · read-only / commits / 65cbd0f59
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 03:15 UTC

docs: update toolkits and API data

lingalarahul7 committed Mar 16, 2026 at 18:06 UTC 65cbd0f5918eef9c759fc85b72bd3a0556ffc1f4
2 files changed +1576 -1619
docs/public/data/toolkits-list.json
+17 -17
@@ -3495,6 +3495,14 @@
3495 "toolCount": 38,
3496 "triggerCount": 0
3497 },
3498 + {
3499 + "slug": "doppler_secretops",
3500 + "name": "Doppler SecretOps",
3501 + "logo": "https://logos.composio.dev/api/doppler_secretops",
3502 + "category": "developer tools",
3503 + "toolCount": 29,
3504 + "triggerCount": 0
3505 + },
3506 {
3507 "slug": "dotsimple",
3508 "name": "Dotsimple",
@@ -7603,7 +7611,7 @@
7611 "slug": "truvera",
7612 "name": "Truvera",
7613 "logo": "https://logos.composio.dev/api/truvera",
7606 - "category": "verifiable credentials",
7614 + "category": "security & identity tools",
7615 "toolCount": 15,
7616 "triggerCount": 0
7617 },
@@ -7679,6 +7687,14 @@
7687 "toolCount": 33,
7688 "triggerCount": 0
7689 },
7690 + {
7691 + "slug": "uniswap_api",
7692 + "name": "Uniswap Api",
7693 + "logo": "https://logos.composio.dev/api/uniswap_api",
7694 + "category": "developer tools",
7695 + "toolCount": 7,
7696 + "triggerCount": 0
7697 + },
7698 {
7699 "slug": "updown_io",
7700 "name": "Updown.io",
@@ -7982,21 +7998,5 @@
7998 "category": "url shortener",
7999 "toolCount": 8,
8000 "triggerCount": 0
7985 - },
7986 - {
7987 - "slug": "yelp",
7988 - "name": "Yelp",
7989 - "logo": "https://logos.composio.dev/api/yelp",
7990 - "category": "reviews",
7991 - "toolCount": 6,
7992 - "triggerCount": 0
7993 - },
7994 - {
7995 - "slug": "zep",
7996 - "name": "Zep",
7997 - "logo": "https://logos.composio.dev/api/zep",
7998 - "category": "artificial intelligence",
7999 - "toolCount": 41,
8000 - "triggerCount": 0
8001 }
8002 ]
\ No newline at end of file
docs/public/data/toolkits.json
+1559 -1602
@@ -13,7 +13,7 @@
13 ],
14 "toolCount": 60,
15 "triggerCount": 2,
16 - "version": "20260312_00",
16 + "version": "20260316_00",
17 "tools": [
18 {
19 "slug": "GMAIL_ADD_LABEL_TO_EMAIL",
@@ -23,17 +23,17 @@
23 {
24 "slug": "GMAIL_BATCH_DELETE_MESSAGES",
25 "name": "Batch delete Gmail messages",
26 - "description": "Tool to permanently delete multiple Gmail messages in bulk. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene)."
26 + "description": "Tool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene). Use GMAIL_MOVE_TO_TRASH instead when reversibility may be needed. Always obtain explicit user confirmation and verify a sample of message IDs before executing. High-volume calls may trigger 429 rateLimitExceeded or 403 userRateLimitExceeded errors; apply exponential backoff."
27 },
28 {
29 "slug": "GMAIL_BATCH_MODIFY_MESSAGES",
30 "name": "Batch modify Gmail messages",
31 - "description": "Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels."
31 + "description": "Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels. High-volume calls may return 429 rateLimitExceeded or 403 userRateLimitExceeded; apply exponential backoff."
32 },
33 {
34 "slug": "GMAIL_CREATE_EMAIL_DRAFT",
35 "name": "Create email draft",
36 - "description": "Creates a Gmail email draft. All fields are optional per the Gmail API - drafts can be created with minimal content and edited later before sending. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. When creating a draft reply to an existing thread (thread_id provided), leave subject empty to stay in the same thread; setting a subject will create a NEW thread instead."
36 + "description": "Creates a Gmail email draft. While all fields are optional per the Gmail API, practical validation requires at least one of recipient_email, cc, or bcc and at least one of subject or body. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. Returns a draft_id that must be used as-is with GMAIL_SEND_DRAFT — synthetic or stale IDs will fail. When creating a draft reply to an existing thread (thread_id provided), leave subject empty to stay in the same thread; setting a subject will create a NEW thread instead. HTTP 429 may occur on rapid creation/send sequences; apply exponential backoff."
37 },
38 {
39 "slug": "GMAIL_CREATE_FILTER",
@@ -43,12 +43,12 @@
43 {
44 "slug": "GMAIL_CREATE_LABEL",
45 "name": "Create label",
46 - "description": "Creates a new label with a unique name in the specified user's Gmail account."
46 + "description": "Creates a new label with a unique name in the specified user's Gmail account. Returns a labelId (e.g., 'Label_123') required for downstream tools like GMAIL_ADD_LABEL_TO_EMAIL, GMAIL_BATCH_MODIFY_MESSAGES, and GMAIL_MODIFY_THREAD_LABELS — those tools do not accept display names."
47 },
48 {
49 "slug": "GMAIL_DELETE_DRAFT",
50 "name": "Delete Draft",
51 - "description": "Permanently deletes a specific Gmail draft using its ID; ensure the draft exists and the user has necessary permissions for the given `user_id`."
51 + "description": "Permanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling. Ensure the draft exists and the user has necessary permissions for the given `user_id`."
52 },
53 {
54 "slug": "GMAIL_DELETE_FILTER",
@@ -73,27 +73,27 @@
73 {
74 "slug": "GMAIL_FETCH_EMAILS",
75 "name": "Fetch emails",
76 - "description": "Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval."
76 + "description": "Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval. Results are NOT sorted by recency; sort by internalDate client-side. The messages field may be absent or empty (valid no-results state); always null-check before accessing messageId or threadId. Null-check subject and header fields before string operations. For large result sets, prefer ids_only=true or metadata-only listing, then hydrate via GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID."
77 },
78 {
79 "slug": "GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID",
80 "name": "Fetch message by message ID",
81 - "description": "Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`."
81 + "description": "Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`. Spam/trash messages are excluded unless upstream list/search calls used `include_spam_trash=true`. Use `internalDate` (milliseconds since epoch) rather than header `Date` for recency checks."
82 },
83 {
84 "slug": "GMAIL_FETCH_MESSAGE_BY_THREAD_ID",
85 "name": "Fetch Message by Thread ID",
86 - "description": "Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`."
86 + "description": "Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`. Returns a `messages` array; `thread_id` is not echoed in the response. Message order is not guaranteed — sort by `internalDate` to find oldest/newest. Check `labelIds` per message to filter drafts. Concurrent bulk calls may trigger 403 `userRateLimitExceeded` or 429; cap concurrency ~10 and use exponential backoff."
87 },
88 {
89 "slug": "GMAIL_FORWARD_MESSAGE",
90 "name": "Forward email message",
91 - "description": "Forward an existing Gmail message to specified recipients, preserving original body and attachments."
91 + "description": "Forward an existing Gmail message to specified recipients, preserving original body and attachments. Verify recipients and content before forwarding to avoid unintended exposure. Bulk forwarding may trigger 429/5xx rate limits; keep concurrency to 5–10 and apply backoff. Messages near Gmail's size limits may fail; reconstruct a smaller draft if needed."
92 },
93 {
94 "slug": "GMAIL_GET_ATTACHMENT",
95 "name": "Get Gmail attachment",
96 - "description": "Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs."
96 + "description": "Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs. Returns base64url-encoded binary data (up to ~25 MB); the downloaded file location is at data.file.s3url (also exposes mimetype and name; no s3key). Attachments exceeding ~25 MB may be exposed as Google Drive links — use GOOGLEDRIVE_DOWNLOAD_FILE when a Drive file_id is present instead."
97 },
98 {
99 "slug": "GMAIL_GET_AUTO_FORWARDING",
@@ -103,7 +103,7 @@
103 {
104 "slug": "GMAIL_GET_CONTACTS",
105 "name": "Get contacts",
106 - "description": "Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination."
106 + "description": "Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination. Only covers saved contacts and 'Other Contacts'; email-header-only senders are out of scope. Contact records may have sparse data — handle missing fields gracefully. People API shares a per-user QPS quota; HTTP 429 requires exponential backoff (1s, 2s, 4s)."
107 },
108 {
109 "slug": "GMAIL_GET_DRAFT",
@@ -128,12 +128,12 @@
128 {
129 "slug": "GMAIL_GET_PEOPLE",
130 "name": "Get People",
131 - "description": "Retrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return."
131 + "description": "Retrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return. Scope is limited to the authenticated user's own contacts and 'Other Contacts' history only."
132 },
133 {
134 "slug": "GMAIL_GET_PROFILE",
135 "name": "Get Profile",
136 - "description": "Retrieves key Gmail profile information (email address, message/thread totals, history ID) for a user."
136 + "description": "Retrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user. messagesTotal counts individual emails; threadsTotal counts conversations; neither is per-label — use GMAIL_FETCH_EMAILS with label filters for label-specific counts. The returned historyId seeds incremental sync via GMAIL_LIST_HISTORY; if historyIdTooOld is returned, rescan with GMAIL_FETCH_EMAILS before resuming. Response may be wrapped under a top-level data field; unwrap before reading fields. A successful call confirms mailbox connectivity but not full mailbox access if granted scopes are narrow. Use the returned email address to dynamically identify the authenticated account rather than hard-coding it."
137 },
138 {
139 "slug": "GMAIL_GET_VACATION_SETTINGS",
@@ -163,7 +163,7 @@
163 {
164 "slug": "GMAIL_LIST_DRAFTS",
165 "name": "List Drafts",
166 - "description": "Retrieves a paginated list of email drafts from a user's Gmail account. Use verbose=true to get full draft details including subject, body, sender, and timestamp."
166 + "description": "Retrieves a paginated list of email drafts from a user's Gmail account. Use verbose=true to get full draft details including subject, body, sender, and timestamp. Draft ordering is non-guaranteed; iterate using page_token until it is absent to retrieve all drafts. Newly created drafts may not appear immediately. Rapid calls may trigger 403 userRateLimitExceeded or 429 errors; apply exponential backoff (1s, 2s, 4s) before retrying."
167 },
168 {
169 "slug": "GMAIL_LIST_FILTERS",
@@ -178,12 +178,12 @@
178 {
179 "slug": "GMAIL_LIST_HISTORY",
180 "name": "List Gmail history",
181 - "description": "Tool to list Gmail mailbox change history since a known startHistoryId. Use when performing incremental mailbox syncs to fetch only new changes."
181 + "description": "Tool to list Gmail mailbox change history since a known startHistoryId. Use for incremental mailbox syncs. Persist the latest historyId as a checkpoint across sessions; without it, incremental sync is unreliable. An empty history list in the response is valid and means no new changes occurred."
182 },
183 {
184 "slug": "GMAIL_LIST_LABELS",
185 "name": "List Gmail labels",
186 - "description": "Retrieves a list of all system and user-created labels for the specified Gmail account."
186 + "description": "Retrieves all system and user-created labels for a Gmail account in a single unpaginated response. Primary use: obtain internal label IDs (e.g., 'Label_123') required by other Gmail tools — display names cannot be used as label identifiers and cause silent failures or errors. System labels (INBOX, UNREAD, SPAM, TRASH, etc.) are case-sensitive and must be used exactly as returned; INBOX, SPAM, and TRASH are read-only and cannot be added/removed via label modification tools. The Gmail search 'label:' operator accepts display names, but label_ids parameters in tools like GMAIL_FETCH_EMAILS require internal IDs from this tool — mixing conventions yields zero results silently. Do not hardcode label IDs across sessions; refresh via this tool on conflict errors."
187 },
188 {
189 "slug": "GMAIL_LIST_MESSAGES",
@@ -203,12 +203,12 @@
203 {
204 "slug": "GMAIL_LIST_THREADS",
205 "name": "List threads",
206 - "description": "Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination."
206 + "description": "Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination. Spam and trash are excluded by default unless explicitly targeted via `label:spam` or `label:trash` in the query."
207 },
208 {
209 "slug": "GMAIL_MODIFY_THREAD_LABELS",
210 "name": "Modify thread labels",
211 - "description": "Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid."
211 + "description": "Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid. To modify a single message only, use a message-level tool instead."
212 },
213 {
214 "slug": "GMAIL_MOVE_THREAD_TO_TRASH",
@@ -218,12 +218,12 @@
218 {
219 "slug": "GMAIL_MOVE_TO_TRASH",
220 "name": "Move to Trash",
221 - "description": "Moves an existing, non-deleted email message to the trash for the specified user."
221 + "description": "Moves an existing, non-deleted email message to the trash for the specified user. Trashed messages are recoverable and still count toward storage quota until purged. Prefer this over GMAIL_BATCH_DELETE_MESSAGES when recovery may be needed. For bulk operations, use GMAIL_BATCH_MODIFY_MESSAGES or GMAIL_BATCH_DELETE_MESSAGES instead of repeated calls to this tool."
222 },
223 {
224 "slug": "GMAIL_PATCH_LABEL",
225 "name": "Patch Label",
226 - "description": "Patches the specified label."
226 + "description": "Patches the specified user-created label. System labels (e.g., INBOX, SENT, SPAM) cannot be modified and will be rejected."
227 },
228 {
229 "slug": "GMAIL_PATCH_SEND_AS",
@@ -233,22 +233,22 @@
233 {
234 "slug": "GMAIL_REPLY_TO_THREAD",
235 "name": "Reply to email thread",
236 - "description": "Sends a reply within a specific Gmail thread using the original thread's subject, requiring a valid `thread_id` and at least one of recipient_email, cc, or bcc must be provided. Supports attachments via the `attachment` parameter with `mimetype` and `name`."
236 + "description": "Sends a reply within a specific Gmail thread using the original thread's subject; do not provide a custom subject as it will start a new conversation instead of replying in-thread. Requires a valid `thread_id` and at least one of `recipient_email`, `cc`, or `bcc`. Supports attachments via the `attachment` parameter with `name`, `mimetype`, and `s3key` fields."
237 },
238 {
239 "slug": "GMAIL_SEARCH_PEOPLE",
240 "name": "Search People",
241 - "description": "Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'."
241 + "description": "Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'. Only searches the authenticated user's contact directory — people existing solely in message headers won't appear; use GMAIL_FETCH_EMAILS for those. Results may be zero or multiple; never auto-select from ambiguous results. Results paginate via next_page_token; follow until empty and deduplicate by email. Many records lack emailAddresses or names even when requested — handle missing keys. Directory/organization policies may suppress entries."
242 },
243 {
244 "slug": "GMAIL_SEND_DRAFT",
245 "name": "Send Draft",
246 - "description": "Sends an existing draft email AS-IS to recipients already defined within the draft. IMPORTANT: This action does NOT accept recipient parameters (to, cc, bcc). The Gmail API's drafts/send endpoint sends drafts to whatever recipients are already set in the draft's To, Cc, and Bcc headers - it cannot add or override recipients. If the draft has no recipients, you must either: 1. Create a new draft with recipients using GMAIL_CREATE_EMAIL_DRAFT, then send it 2. Use GMAIL_SEND_EMAIL to send a new email directly with recipients This action only requires the draft_id parameter."
246 + "description": "Sends an existing draft email AS-IS to recipients already defined within the draft. IMPORTANT: This action does NOT accept recipient parameters (to, cc, bcc). The Gmail API's drafts/send endpoint sends drafts to whatever recipients are already set in the draft's To, Cc, and Bcc headers - it cannot add or override recipients. If the draft has no recipients, you must either: 1. Create a new draft with recipients using GMAIL_CREATE_EMAIL_DRAFT, then send it 2. Use GMAIL_SEND_EMAIL to send a new email directly with recipients. Send is immediate and irreversible — confirm recipients and content before calling. No scheduling support; trigger at the desired UTC time externally. Gmail enforces ~25 MB message size limit and daily send caps (~500 recipients/day personal, ~2,000/day Workspace)."
247 },
248 {
249 "slug": "GMAIL_SEND_EMAIL",
250 "name": "Send Email",
251 - "description": "Sends an email via Gmail API using the authenticated user's Google profile display name. At least one of 'to' (or 'recipient_email'), 'cc', or 'bcc' must be provided. At least one of subject or body must be provided. Requires `is_html=True` if the body contains HTML. All common file types including PNG, JPG, PDF, MP4, etc. are supported as attachments. Gmail API limits total message size to ~25 MB after base64 encoding."
251 + "description": "Sends an email via Gmail API using the authenticated user's Google profile display name. Sends immediately and is irreversible — confirm recipients, subject, body, and attachments before calling. At least one of 'to' (or 'recipient_email'), 'cc', or 'bcc' must be provided. At least one of subject or body must be provided. Requires `is_html=True` if the body contains HTML. All common file types including PNG, JPG, PDF, MP4, etc. are supported as attachments. Gmail API limits total message size to ~25 MB after base64 encoding. To reply in an existing thread, use GMAIL_REPLY_TO_THREAD instead. No scheduled send support; enforce timing externally."
252 },
253 {
254 "slug": "GMAIL_SETTINGS_GET_IMAP",
@@ -390,7 +390,7 @@
390 ],
391 "toolCount": 25,
392 "triggerCount": 0,
393 - "version": "20260227_00",
393 + "version": "20260316_00",
394 "tools": [
395 {
396 "slug": "COMPOSIO_CHECK_ACTIVE_CONNECTION",
@@ -550,7 +550,7 @@
550 ],
551 "toolCount": 866,
552 "triggerCount": 20,
553 - "version": "20260313_00",
553 + "version": "20260316_00",
554 "tools": [
555 {
556 "slug": "GITHUB_ABORT_REPOSITORY_MIGRATION",
@@ -1785,12 +1785,12 @@
1785 {
1786 "slug": "GITHUB_FIND_PULL_REQUESTS",
1787 "name": "Find Pull Requests",
1788 - "description": "Primary tool to find and search pull requests. Supports filtering by repository, author, state, labels, and merge status, and returns structured PR data for reliable use in workflows."
1788 + "description": "Primary tool to find and search pull requests. Supports filtering by repository, author, state, labels, and merge status, and returns structured PR data for reliable use in workflows. GitHub search results are capped at ~1000 total items; narrow filters when totals approach this limit. `created_since`/`updated_since` filter on creation/update timestamps, not `merged_at`; apply merge-date filtering client-side."
1789 },
1790 {
1791 "slug": "GITHUB_FIND_REPOSITORIES",
1792 "name": "Find Repositories",
1793 - "description": "AI-optimized repository search with smart filtering by language, stars, topics, and ownership. Builds intelligent search queries and returns clean, actionable repository data."
1793 + "description": "AI-optimized repository search with smart filtering by language, stars, topics, and ownership. Builds intelligent search queries and returns clean, actionable repository data. Check `incomplete_results` in the response — when true, results are non-exhaustive. Search endpoints are rate-limited to ~30 requests/minute (vs. 5000/hour for general REST); apply backoff on 403/429. Total results are capped at ~1000 per query regardless of pagination."
1794 },
1795 {
1796 "slug": "GITHUB_FOLLOW_ORGANIZATION_GRAPHQL",
@@ -2555,7 +2555,7 @@
2555 {
2556 "slug": "GITHUB_GET_RAW_REPOSITORY_CONTENT",
2557 "name": "Get Raw Repository Content",
2558 - "description": "Tool to fetch raw file content from a GitHub repository. Use when you need the raw bytes of a file in the repo."
2558 + "description": "Tool to fetch raw file content from a GitHub repository. Returns raw bytes in whatever format the file uses (JSON, CSV, binary, etc.) — parsing and validation are the caller's responsibility. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools to avoid mismatched-ref errors."
2559 },
2560 {
2561 "slug": "GITHUB_GET_REPO_ALLOWED_ACTIONS",
@@ -4325,7 +4325,7 @@
4325 {
4326 "slug": "GITHUB_RUN_GRAPH_QL_QUERY",
4327 "name": "Run GraphQL Query",
4328 - "description": "Tool to run an arbitrary GitHub GraphQL v4 query. Use when you need to fetch multiple datasets in one batch."
4328 + "description": "Tool to run an arbitrary GitHub GraphQL v4 query or mutation. Use when fetching multiple datasets in one batch. Cost-based rate limit: ~5,000 points/hour; keep field selections narrow, avoid deep nesting, and include rateLimit in responses to monitor quota. Responses are nested under data.data (e.g., data.data.repository.vulnerabilityAlerts); always inspect the errors array even on HTTP 200, as partial failures embed there. Paginate by looping on pageInfo.hasNextPage and advancing with pageInfo.endCursor. Search results cap at ~1,000 items per query; split by label, date range, or repository for full coverage. Use ProjectV2 nodes, not Classic Projects (deprecated). Parallel mutations (e.g., addProjectV2ItemById) can trigger transient conflicts; use sequential execution."
4329 },
4330 {
4331 "slug": "GITHUB_RUN_GRAPH_QL_RELAY_QUERY",
@@ -4340,7 +4340,7 @@
4340 {
4341 "slug": "GITHUB_SEARCH_CODE_ALL_PAGES",
4342 "name": "Search code (all pages)",
4343 - "description": "Tool to search code across multiple pages using GitHub's code search API. Use when single-page searches may miss matches and you need a full or capped result set."
4343 + "description": "Tool to search code across multiple pages using GitHub's code search API. Use when single-page searches may miss matches and you need a full or capped result set. GitHub caps results at ~1,000 total items regardless of pagination; results for broad queries may be silently truncated. Only the default branch is indexed, and very large files may be excluded — treat results as potentially partial. Rate limit: ~30 requests/minute; honor `Retry-After` on 403/429 responses."
4344 },
4345 {
4346 "slug": "GITHUB_SEARCH_COMMITS",
@@ -5050,7 +5050,7 @@
5050 ],
5051 "toolCount": 46,
5052 "triggerCount": 7,
5053 - "version": "20260312_00",
5053 + "version": "20260316_00",
5054 "tools": [
5055 {
5056 "slug": "GOOGLECALENDAR_ACL_DELETE",
@@ -5105,7 +5105,7 @@
5105 {
5106 "slug": "GOOGLECALENDAR_CALENDAR_LIST_INSERT",
5107 "name": "Insert Calendar into List",
5108 - "description": "Inserts an existing calendar into the user's calendar list."
5108 + "description": "Inserts an existing calendar into the user's calendar list, making it visible in the UI. Calendars (e.g., newly created ones) won't appear in the list or UI until explicitly inserted."
5109 },
5110 {
5111 "slug": "GOOGLECALENDAR_CALENDAR_LIST_PATCH",
@@ -5115,7 +5115,7 @@
5115 {
5116 "slug": "GOOGLECALENDAR_CALENDAR_LIST_UPDATE",
5117 "name": "Update Calendar List Entry",
5118 - "description": "Updates an existing entry on the user\\'s calendar list."
5118 + "description": "Updates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user — does not modify the underlying calendar resource (title, timezone, etc.). To modify the calendar itself, use GOOGLECALENDAR_CALENDARS_UPDATE."
5119 },
5120 {
5121 "slug": "GOOGLECALENDAR_CALENDAR_LIST_WATCH",
@@ -5125,12 +5125,12 @@
5125 {
5126 "slug": "GOOGLECALENDAR_CALENDARS_DELETE",
5127 "name": "Delete Calendar",
5128 - "description": "Deletes a secondary calendar that you own or have delete permissions on. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead."
5128 + "description": "Deletes a secondary calendar that you own or have delete permissions on. Deletion is permanent and irreversible — verify the correct calendar_id before calling. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead. Parallel calls may trigger userRateLimitExceeded; sequence bulk deletions."
5129 },
5130 {
5131 "slug": "GOOGLECALENDAR_CALENDARS_UPDATE",
5132 "name": "Update Calendar",
5133 - "description": "Updates metadata for a calendar."
5133 + "description": "Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. Use GOOGLECALENDAR_PATCH_CALENDAR to update only a subset of fields. Mutates the underlying calendar resource (title, description, timeZone, etc.); use GOOGLECALENDAR_CALENDAR_LIST_UPDATE to change per-user display properties like color."
5134 },
5135 {
5136 "slug": "GOOGLECALENDAR_CHANNELS_STOP",
@@ -5140,7 +5140,7 @@
5140 {
5141 "slug": "GOOGLECALENDAR_CLEAR_CALENDAR",
5142 "name": "Clear Calendar",
5143 - "description": "Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account."
5143 + "description": "Clears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely."
5144 },
5145 {
5146 "slug": "GOOGLECALENDAR_COLORS_GET",
@@ -5150,17 +5150,17 @@
5150 {
5151 "slug": "GOOGLECALENDAR_CREATE_EVENT",
5152 "name": "Create Event",
5153 - "description": "Create a Google Calendar event using start_datetime plus duration fields. The organizer is added as an attendee unless exclude_organizer is True. By default adds Google Meet link (works for Workspace, gracefully falls back for personal Gmail). Attendees can be email strings (required) or objects with email and optional fields. Example: { \"start_datetime\": \"2025-01-16T13:00:00\", \"timezone\": \"America/New_York\", \"event_duration_hour\": 1, \"event_duration_minutes\": 30, \"summary\": \"Client sync\", \"attendees\": [\"required@example.com\", {\"email\": \"optional@example.com\", \"optional\": true}] }"
5153 + "description": "Create a Google Calendar event using start_datetime plus duration fields. The organizer is added as an attendee unless exclude_organizer is True. By default adds Google Meet link (works for Workspace, gracefully falls back for personal Gmail). Attendees can be email strings (required) or objects with email and optional fields. No conflict checking is performed; use GOOGLECALENDAR_FREE_BUSY_QUERY to detect overlaps before creating. Returns event id and htmlLink nested under data.response_data. Example: { \"start_datetime\": \"2025-01-16T13:00:00\", \"timezone\": \"America/New_York\", \"event_duration_hour\": 1, \"event_duration_minutes\": 30, \"summary\": \"Client sync\", \"attendees\": [\"required@example.com\", {\"email\": \"optional@example.com\", \"optional\": true}] }"
5154 },
5155 {
5156 "slug": "GOOGLECALENDAR_DELETE_EVENT",
5157 "name": "Delete event",
5158 - "description": "Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); this action is idempotent and raises a 404 error if the event is not found."
5158 + "description": "Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); idempotent — a 404 for an already-deleted event is a no-op. Bulk deletions may trigger `rateLimitExceeded` or `userRateLimitExceeded`; cap concurrency to 5–10 requests and apply exponential backoff."
5159 },
5160 {
5161 "slug": "GOOGLECALENDAR_DUPLICATE_CALENDAR",
5162 "name": "Create a calendar",
5163 - "description": "Creates a new, empty Google Calendar with the specified title (summary)."
5163 + "description": "Creates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if needed."
5164 },
5165 {
5166 "slug": "GOOGLECALENDAR_EVENTS_GET",
@@ -5175,7 +5175,7 @@
5175 {
5176 "slug": "GOOGLECALENDAR_EVENTS_INSTANCES",
5177 "name": "Get Event Instances",
5178 - "description": "Returns instances of the specified recurring event."
5178 + "description": "Returns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying."
5179 },
5180 {
5181 "slug": "GOOGLECALENDAR_EVENTS_LIST",
@@ -5185,7 +5185,7 @@
5185 {
5186 "slug": "GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARS",
5187 "name": "List Events from All Calendars",
5188 - "description": "Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars."
5188 + "description": "Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars. An inverted or incorrect time range silently returns empty results rather than an error. An empty `items` list means no events matched the filters—adjust `time_min`, `time_max`, or `q` before concluding no events exist."
5189 },
5190 {
5191 "slug": "GOOGLECALENDAR_EVENTS_MOVE",
@@ -5195,27 +5195,27 @@
5195 {
5196 "slug": "GOOGLECALENDAR_EVENTS_WATCH",
5197 "name": "Watch Events",
5198 - "description": "Watch for changes to Events resources."
5198 + "description": "Watch for changes to Events resources. Watch channels expire; persist the channel `id` per `calendarId` to re-establish watches after expiration or restarts."
5199 },
5200 {
5201 "slug": "GOOGLECALENDAR_FIND_EVENT",
5202 "name": "Find event",
5203 - "description": "Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types; ensure `timeMin` is not chronologically after `timeMax` if both are provided."
5203 + "description": "Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types. Ensure `timeMin` is not chronologically after `timeMax` if both are provided. Results may span multiple pages; always follow `nextPageToken` until absent to avoid silently missing events. Validate the correct match from results by checking summary, start.dateTime, and organizer.email before using event_id for mutations. An empty `items` array means no events matched — widen filters rather than treating it as an error."
5204 },
5205 {
5206 "slug": "GOOGLECALENDAR_FIND_FREE_SLOTS",
5207 "name": "Find free slots",
5208 - "description": "Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range. If `time_min` is not provided, defaults to the current timestamp in the specified timezone. If `time_max` is not provided, defaults to 23:59:59 of the day specified in `time_min` (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Returns busy intervals and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods."
5208 + "description": "Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range. If `time_min` is not provided, defaults to the current timestamp in the specified timezone. If `time_max` is not provided, defaults to 23:59:59 of the day specified in `time_min` (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Returns busy intervals and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods. Returned free slots are unfiltered by duration; callers must filter intervals to those fully containing the required meeting length. No event metadata (titles, descriptions, links) is returned; use GOOGLECALENDAR_EVENTS_LIST for event details."
5209 },
5210 {
5211 "slug": "GOOGLECALENDAR_FREE_BUSY_QUERY",
5212 "name": "Query Free/Busy Information (Deprecated)",
5213 - "description": "DEPRECATED: Use GOOGLECALENDAR_FIND_FREE_SLOTS instead. Returns free/busy information for a set of calendars."
5213 + "description": "DEPRECATED: Use GOOGLECALENDAR_FIND_FREE_SLOTS instead (though this tool provides wider secondary/shared calendar coverage). Returns opaque busy intervals only—no event titles or details; use GOOGLECALENDAR_EVENTS_LIST when event details are needed."
5214 },
5215 {
5216 "slug": "GOOGLECALENDAR_GET_CALENDAR",
5217 "name": "Get Google Calendar",
5218 - "description": "Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access."
5218 + "description": "Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access. Response includes `timeZone` (IANA format, e.g., 'America/Los_Angeles') — use it directly when constructing `timeMin`/`timeMax` in other tools to avoid DST errors. An empty `defaultReminders` list is valid (no defaults configured). Insufficient `accessRole` may omit fields like `defaultReminders` and `colorId`."
5219 },
5220 {
5221 "slug": "GOOGLECALENDAR_GET_CALENDAR_PROFILE",
@@ -5225,12 +5225,12 @@
5225 {
5226 "slug": "GOOGLECALENDAR_GET_CURRENT_DATE_TIME",
5227 "name": "Get current date and time",
5228 - "description": "Gets the current date and time, allowing for a specific timezone offset."
5228 + "description": "Gets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., 'tomorrow', 'next Monday') to avoid off-by-one-day errors across timezones."
5229 },
5230 {
5231 "slug": "GOOGLECALENDAR_LIST_CALENDARS",
5232 "name": "List Google Calendars",
5233 - "description": "Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering."
5233 + "description": "Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering. Loop through all pages using nextPageToken until absent to avoid missing calendars. Use the primary flag and accessRole field from the response to identify calendars — display names are not valid calendar_id values. Read access (listing) does not imply write OAuth scopes."
5234 },
5235 {
5236 "slug": "GOOGLECALENDAR_LIST_SETTINGS",
@@ -5255,7 +5255,7 @@
5255 {
5256 "slug": "GOOGLECALENDAR_REMOVE_ATTENDEE",
5257 "name": "Remove attendee from event",
5258 - "description": "Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist."
5258 + "description": "Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist. Concurrent calls on the same event can overwrite attendee lists — apply changes sequentially per event."
5259 },
5260 {
5261 "slug": "GOOGLECALENDAR_SETTINGS_GET",
@@ -5265,7 +5265,7 @@
5265 {
5266 "slug": "GOOGLECALENDAR_SETTINGS_LIST",
5267 "name": "List Settings",
5268 - "description": "Returns all user settings for the authenticated user."
5268 + "description": "Returns all user settings for the authenticated user. Results include multiple settings keyed by id (e.g., `timeZone`); locate a specific setting by its `id` field. `timeZone` values are IANA identifiers (e.g., `America/New_York`) — use directly in datetime and event logic; align with `timeZone` from GOOGLECALENDAR_GET_CALENDAR for consistent notification times."
5269 },
5270 {
5271 "slug": "GOOGLECALENDAR_SETTINGS_WATCH",
@@ -5280,7 +5280,7 @@
5280 {
5281 "slug": "GOOGLECALENDAR_UPDATE_EVENT",
5282 "name": "Update Google event",
5283 - "description": "Updates an existing event in Google Calendar. REQUIRES event_id - you MUST first search for the event using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to obtain the event_id. This is a full PUT replacement, so provide all desired fields as unspecified ones may be cleared or reset."
5283 + "description": "Updates an existing event in Google Calendar. REQUIRES event_id - you MUST first search for the event using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to obtain the event_id. This is a full PUT replacement: omitted fields (including attendees, reminders, recurrence, conferencing) are cleared. Always provide the complete desired event state. Use GOOGLECALENDAR_PATCH_EVENT instead for partial edits."
5284 }
5285 ],
5286 "triggers": [
@@ -5386,7 +5386,7 @@
5386 ],
5387 "toolCount": 47,
5388 "triggerCount": 5,
5389 - "version": "20260312_00",
5389 + "version": "20260316_00",
5390 "tools": [
5391 {
5392 "slug": "NOTION_ADD_MULTIPLE_PAGE_CONTENT",
@@ -5739,7 +5739,7 @@
5739 ],
5740 "toolCount": 46,
5741 "triggerCount": 16,
5742 - "version": "20260313_00",
5742 + "version": "20260316_00",
5743 "tools": [
5744 {
5745 "slug": "GOOGLESHEETS_ADD_SHEET",
@@ -6119,7 +6119,7 @@
6119 ],
6120 "toolCount": 151,
6121 "triggerCount": 9,
6122 - "version": "20260312_00",
6122 + "version": "20260316_00",
6123 "tools": [
6124 {
6125 "slug": "SLACK_ADD_CALL_PARTICIPANTS",
@@ -6204,7 +6204,7 @@
6204 {
6205 "slug": "SLACK_CREATE_CHANNEL",
6206 "name": "Create channel",
6207 - "description": "Initiates a public or private channel-based conversation"
6207 + "description": "Initiates a public or private channel-based conversation in a Slack workspace. Immediately creates the channel; invoke only after explicit user confirmation."
6208 },
6209 {
6210 "slug": "SLACK_CREATE_CHANNEL_BASED_CONVERSATION",
@@ -6229,7 +6229,7 @@
6229 {
6230 "slug": "SLACK_DELETE_CANVAS",
6231 "name": "Delete Slack Canvas",
6232 - "description": "Deletes a Slack Canvas permanently."
6232 + "description": "Deletes a Slack Canvas permanently and irreversibly. Always confirm with the user before calling this tool."
6233 },
6234 {
6235 "slug": "SLACK_DELETE_CHANNEL",
@@ -6284,7 +6284,7 @@
6284 {
6285 "slug": "SLACK_ENABLE_PUBLIC_SHARING_OF_A_FILE",
6286 "name": "Share file public url",
6287 - "description": "Enables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files."
6287 + "description": "Enables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files. Once enabled, the file is accessible to anyone with the URL — verify intent before sharing sensitive or confidential files."
6288 },
6289 {
6290 "slug": "SLACK_ENABLE_USER_GROUP",
@@ -6314,7 +6314,7 @@
6314 {
6315 "slug": "SLACK_FETCH_ITEM_REACTIONS",
6316 "name": "Fetch item reactions",
6317 - "description": "Fetches reactions for a Slack message, file, or file comment, requiring one of: channel and timestamp; file ID; or file comment ID."
6317 + "description": "Fetches reactions for a Slack message, file, or file comment. Exactly one identifier path must be provided: `channel`+`timestamp`, `file`, or `file_comment`. Mixing identifiers (e.g., providing both `channel`+`timestamp` and `file`) causes errors. If the response omits the `reactions` field, the item has zero reactions."
6318 },
6319 {
6320 "slug": "SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION",
@@ -6329,17 +6329,17 @@
6329 {
6330 "slug": "SLACK_FIND_CHANNELS",
6331 "name": "Find channels",
6332 - "description": "Find channels in a Slack workspace by any criteria - name, topic, purpose, or description. NOTE: This action can only search channels visible to the bot. Empty results may indicate: - No channels match the search query in name, topic, or purpose - The target channel is private and the bot hasn't been invited - The bot lacks required scopes (channels:read, groups:read) Check 'composio_execution_message' and 'total_channels_searched' in the response for details."
6332 + "description": "Find channels in a Slack workspace by any criteria - name, topic, purpose, or description. Returns channel IDs (C*/G* prefixed) required by most Slack tools — always resolve names to IDs here before passing to other tools. NOTE: This action can only search channels visible to the bot. Empty results may indicate: - No channels match the search query in name, topic, or purpose - The target channel is private and the bot hasn't been invited - The bot lacks required scopes (channels:read, groups:read). If empty, retry with exact_match=false or exclude_archived=false to avoid false negatives. In large workspaces, paginate using next_cursor to avoid missing matches. Check 'composio_execution_message' and 'total_channels_searched' in the response for details."
6333 },
6334 {
6335 "slug": "SLACK_FIND_USER_BY_EMAIL_ADDRESS",
6336 "name": "Lookup users by email (Deprecated)",
6337 - "description": "DEPRECATED: Use FindUsers instead. Retrieves the Slack user object for an active user by their registered email address; fails with 'users_not_found' if the email is unregistered or the user is inactive."
6337 + "description": "DEPRECATED: Use FindUsers instead. Retrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with 'users_not_found' if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings."
6338 },
6339 {
6340 "slug": "SLACK_FIND_USERS",
6341 "name": "Find users",
6342 - "description": "Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches."
6342 + "description": "Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches. Zero results may reflect email visibility restrictions or workspace policies, not global absence. Repeated calls may trigger HTTP 429; honor the Retry-After header."
6343 },
6344 {
6345 "slug": "SLACK_GET_APP_PERMISSION_SCOPES",
@@ -6384,7 +6384,7 @@
6384 {
6385 "slug": "SLACK_GET_REMOTE_FILE",
6386 "name": "Get remote file",
6387 - "description": "Retrieve information about a remote file added to Slack."
6387 + "description": "Retrieve information about a remote file added to Slack via the files.remote API. Does not work for standard Slack-hosted file uploads."
6388 },
6389 {
6390 "slug": "SLACK_GET_TEAM_PROFILE",
@@ -6414,7 +6414,7 @@
6414 {
6415 "slug": "SLACK_INVITE_USERS_TO_A_SLACK_CHANNEL",
6416 "name": "Invite users to a Slack channel",
6417 - "description": "Invites users to an existing Slack channel using their valid Slack User IDs."
6417 + "description": "Invites users to an existing Slack channel using their valid Slack User IDs. Response is always HTTP 200; inspect `ok`, `error`, and `errors` fields to confirm users were added."
6418 },
6419 {
6420 "slug": "SLACK_INVITE_USER_TO_CHANNEL",
@@ -6429,7 +6429,7 @@
6429 {
6430 "slug": "SLACK_JOIN_AN_EXISTING_CONVERSATION",
6431 "name": "Join conversation by channel id",
6432 - "description": "Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission."
6432 + "description": "Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission. Joining an already-joined channel returns a non-fatal no-op response. Private or restricted channel joins may fail with a permission error."
6433 },
6434 {
6435 "slug": "SLACK_LEAVE_CONVERSATION",
@@ -6454,12 +6454,12 @@
6454 {
6455 "slug": "SLACK_LIST_ALL_CHANNELS",
6456 "name": "List all channels",
6457 - "description": "Lists conversations available to the user with various filters and search options."
6457 + "description": "Lists conversations available to the user with various filters and search options. Always use resolved `channel_id` (not display names) for downstream operations, as names may be non-unique. The `created` field in results is a Unix epoch timestamp (UTC). Pagination across large workspaces may return HTTP 429 with a `Retry-After` header; honor the delay and resume from the last successful cursor."
6458 },
6459 {
6460 "slug": "SLACK_LIST_ALL_USERS",
6461 "name": "List all users",
6462 - "description": "Retrieves a paginated list of all users, including comprehensive details, profile information, status, and team memberships, in a Slack workspace; data may not be real-time."
6462 + "description": "Retrieves a paginated list of all users with profile details, status, and team memberships in a Slack workspace; data may not be real-time. Filter response fields `is_bot`, `is_app_user`, and `deleted` to build human-only rosters. Profile fields like `email` and `phone` may be absent depending on OAuth scopes and workspace privacy settings. Guest/restricted accounts may be omitted based on scopes—do not treat results as a complete directory. High-frequency calls risk HTTP 429; honor the `Retry-After` header and throttle to ~1–2 requests/second. Use stable user IDs rather than display names for mapping. Prefer SLACK_FIND_USERS for targeted lookups; cache results to avoid full-workspace fetches."
6463 },
6464 {
6465 "slug": "SLACK_LIST_APPROVED_WORKSPACE_INVITE_REQUESTS",
@@ -6474,12 +6474,12 @@
6474 {
6475 "slug": "SLACK_LIST_CANVASES",
6476 "name": "List Slack Canvases",
6477 - "description": "Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter. Known limitations: - The 'user' filter may return canvases accessible to the specified user, not just canvases they created. This is a known behavior of the Slack files.list API with canvas types. - The 'ts_from' and 'ts_to' timestamp filters may not work reliably for canvas types. Consider using client-side filtering on the 'created' field in the response if precise date filtering is required."
6477 + "description": "Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter. Only canvases accessible to the authenticated app are returned; missing canvases indicate permissions restrictions, not empty data. Use `paging.pages` in the response to determine total pages; iterate `page` with `count` to retrieve all results. Known limitations: - The 'user' filter may return canvases accessible to the specified user, not just canvases they created. - The 'ts_from' and 'ts_to' timestamp filters may not work reliably for canvas types. Consider client-side filtering on the 'created' field in the response if precise date filtering is required."
6478 },
6479 {
6480 "slug": "SLACK_LIST_CONVERSATIONS",
6481 "name": "List conversations",
6482 - "description": "List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels."
6482 + "description": "List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels. Returns conversation IDs (C* for channels, G* for group DMs), not display names. Absence of private channels, DMs, or MPIMs from results indicates token scope or membership limits, not that the conversation is nonexistent."
6483 },
6484 {
6485 "slug": "SLACK_LIST_CUSTOM_EMOJIS",
@@ -6499,7 +6499,7 @@
6499 {
6500 "slug": "SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK",
6501 "name": "List Slack files",
6502 - "description": "Lists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; this action returns metadata only, not file content."
6502 + "description": "Lists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; returns metadata only, not file content. Results are limited to files visible to the authenticated user — files in private channels or restricted to certain members require appropriate membership and permissions. For large workspaces, check `paging.pages` in the response to determine total pages when paginating."
6503 },
6504 {
6505 "slug": "SLACK_LIST_IDP_GROUPS_LINKED_TO_CHANNEL",
@@ -6519,7 +6519,7 @@
6519 {
6520 "slug": "SLACK_LIST_REMINDERS",
6521 "name": "List reminders",
6522 - "description": "Lists all reminders with their details for the authenticated Slack user; returns an empty list if no reminders exist."
6522 + "description": "Lists all reminders with their details for the authenticated Slack user; returns an empty array if no reminders exist (valid state, not an error). Reminder text is not unique—perform client-side matching on returned objects before extracting a reminder ID for use with SLACK_MARK_REMINDER_AS_COMPLETE or SLACK_DELETE_A_SLACK_REMINDER."
6523 },
6524 {
6525 "slug": "SLACK_LIST_REMOTE_FILES",
@@ -6539,7 +6539,7 @@
6539 {
6540 "slug": "SLACK_LIST_STARRED_ITEMS",
6541 "name": "List starred items",
6542 - "description": "Lists items starred by a user."
6542 + "description": "Lists items starred by a user. Returns classic starred items only — does not reflect Slack's 'saved for later' feature. Use SLACK_SEARCH_MESSAGES or SLACK_SEARCH_ALL for broader saved-content queries."
6543 },
6544 {
6545 "slug": "SLACK_LIST_USER_GROUP_MEMBERS",
@@ -6554,7 +6554,7 @@
6554 {
6555 "slug": "SLACK_LIST_USER_REACTIONS",
6556 "name": "List user reactions",
6557 - "description": "Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required."
6557 + "description": "Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required. Results are paginated; check `response_metadata.next_cursor` and iterate with the `cursor` parameter to retrieve complete reaction history."
6558 },
6559 {
6560 "slug": "SLACK_LIST_WORKSPACE_ADMINS",
@@ -6584,7 +6584,7 @@
6584 {
6585 "slug": "SLACK_OPEN_DM",
6586 "name": "Open DM",
6587 - "description": "Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID."
6587 + "description": "Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID. Returns `already_open=true` when the DM exists — treat as success and reuse the returned `channel.id` (starts with 'D') for subsequent SLACK_SEND_MESSAGE calls; passing a username, email, or user ID directly to SLACK_SEND_MESSAGE causes `channel_not_found`. Avoid redundant calls when an existing DM channel ID is available."
6588 },
6589 {
6590 "slug": "SLACK_PIN_ITEM",
@@ -6609,7 +6609,7 @@
6609 {
6610 "slug": "SLACK_REMOVE_REACTION_FROM_ITEM",
6611 "name": "Remove reaction from item",
6612 - "description": "Removes an emoji reaction from a message, file, or file comment in Slack."
6612 + "description": "Removes an emoji reaction from a message, file, or file comment in Slack. Provide exactly one targeting method: channel+timestamp together, file, or file_comment. Mixing methods or omitting all returns invalid_arguments."
6613 },
6614 {
6615 "slug": "SLACK_REMOVE_REMOTE_FILE",
@@ -6659,12 +6659,12 @@
6659 {
6660 "slug": "SLACK_RETRIEVE_CONVERSATION_INFORMATION",
6661 "name": "Retrieve conversation information",
6662 - "description": "Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content; requires a valid channel ID."
6662 + "description": "Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content. The `channel` parameter is effectively required. Private channels, DMs, or channels where the app lacks membership may return restricted data; check `is_archived` and `is_member` fields in the response to diagnose access issues. Bulk lookups may trigger HTTP 429 rate limiting; honor the `Retry-After` response header."
6663 },
6664 {
6665 "slug": "SLACK_RETRIEVE_CONVERSATION_MEMBERS_LIST",
6666 "name": "Get conversation members",
6667 - "description": "Retrieves a paginated list of active member IDs for a specified Slack public channel, private channel, direct message (DM), or multi-person direct message (MPIM)."
6667 + "description": "Retrieves a paginated list of active member IDs (not names, emails, or presence) for a specified Slack public channel, private channel, DM, or MPIM. Returns only user IDs; use a user-lookup tool to enrich member data."
6668 },
6669 {
6670 "slug": "SLACK_RETRIEVE_CURRENT_USER_DND_STATUS",
@@ -6679,7 +6679,7 @@
6679 {
6680 "slug": "SLACK_RETRIEVE_DETAILED_USER_INFORMATION",
6681 "name": "Retrieve detailed user information",
6682 - "description": "Retrieves comprehensive information for a valid Slack user ID, excluding message history and channel memberships."
6682 + "description": "Retrieves comprehensive information for a valid Slack user ID, excluding message history and channel memberships. Sensitive fields like `email` and `phone` require the `users:read.email` scope and may be silently omitted based on workspace privacy policies."
6683 },
6684 {
6685 "slug": "SLACK_RETRIEVE_MESSAGE_PERMALINK_URL",
@@ -6689,7 +6689,7 @@
6689 {
6690 "slug": "SLACK_RETRIEVE_USER_PROFILE_INFORMATION",
6691 "name": "Retrieve user profile information",
6692 - "description": "Retrieves profile information for a specified Slack user (defaults to the authenticated user if `user` ID is omitted); a provided `user` ID must be valid."
6692 + "description": "Retrieves profile information for a specified Slack user (defaults to the authenticated user if `user` ID is omitted); a provided `user` ID must be valid. Sensitive fields like email and phone may be silently omitted if required scopes (e.g., `users:read.email`) are not granted or workspace privacy policies restrict access."
6693 },
6694 {
6695 "slug": "SLACK_REVOKE_FILE_PUBLIC_SHARING",
@@ -6719,7 +6719,7 @@
6719 {
6720 "slug": "SLACK_SEARCH_ALL",
6721 "name": "Search all content",
6722 - "description": "Tool to search all messages and files. Use when you need unified content search across channels and files in one call."
6722 + "description": "Tool to search all messages and files. Use when you need unified content search across channels and files in one call. Results are scoped to content visible to the authenticated token; missing hits in private or restricted channels reflect permission/membership gaps. Response separates messages and files into distinct sections — explicitly read the files section for document results. Results are index-based and may lag several minutes behind real-time; use SLACK_FETCH_CONVERSATION_HISTORY for near-real-time per-channel coverage. Paginated searches exceeding ~1 req/sec may return HTTP 429 too_many_requests; honor the Retry-After header and resume from the last page."
6723 },
6724 {
6725 "slug": "SLACK_SEARCH_MESSAGES",
@@ -6729,7 +6729,7 @@
6729 {
6730 "slug": "SLACK_SEND_EPHEMERAL_MESSAGE",
6731 "name": "Send ephemeral message",
6732 - "description": "Sends an ephemeral message to a user in a channel."
6732 + "description": "Sends an ephemeral message visible only to the specified `user` in a channel; other channel members cannot see it. Both the bot and the target user must be members of the specified channel."
6733 },
6734 {
6735 "slug": "SLACK_SEND_ME_MESSAGE",
@@ -6739,7 +6739,7 @@
6739 {
6740 "slug": "SLACK_SEND_MESSAGE",
6741 "name": "Send message",
6742 - "description": "Posts a message to a Slack channel, direct message, or private group; requires content via `text`, `blocks`, or `attachments`."
6742 + "description": "Posts a message to a Slack channel, DM, or private group; requires at least one content field (`markdown_text`, `text`, `blocks`, or `attachments`) — omitting all causes a `no_text` error. Fails with `not_in_channel`, `channel_not_found`, or `channel_is_archived` if the bot lacks access. Body limit ~4000 characters. Rate-limited at ~1 req/sec (HTTP 429, honor `Retry-After`). Not idempotent — duplicate calls post duplicate messages."
6743 },
6744 {
6745 "slug": "SLACK_SET_ADMIN_USER",
@@ -6874,7 +6874,7 @@
6874 {
6875 "slug": "SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK",
6876 "name": "Upload or create a file in Slack",
6877 - "description": "Upload files, images, screenshots, documents, or any media to Slack channels or threads. Supports all file types including images (PNG, JPG, JPEG, GIF), documents (PDF, DOCX, TXT), code files, and more. Can share files publicly in channels or as thread replies with optional comments."
6877 + "description": "Upload files, images, screenshots, documents, or any media to Slack channels or threads. Supports all file types including images (PNG, JPG, JPEG, GIF), documents (PDF, DOCX, TXT), code files, and more. Can share files publicly in channels or as thread replies with optional comments. Large files may fail with `upload_too_large`; use SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE for large uploads. If the API returns `ok=false` with `method_deprecated`, fall back to SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE or SLACK_SEND_MESSAGE with a URL."
6878 }
6879 ],
6880 "triggers": [
@@ -6998,7 +6998,7 @@
6998 ],
6999 "toolCount": 121,
7000 "triggerCount": 0,
7001 - "version": "20260312_00",
7001 + "version": "20260316_00",
7002 "tools": [
7003 {
7004 "slug": "SUPABASE_ALPHA_CREATE_API_KEY",
@@ -7712,7 +7712,7 @@
7712 ],
7713 "toolCount": 301,
7714 "triggerCount": 5,
7715 - "version": "20260313_00",
7715 + "version": "20260316_00",
7716 "tools": [
7717 {
7718 "slug": "OUTLOOK_ADD_EVENT_ATTACHMENT",
@@ -7722,7 +7722,7 @@
7722 {
7723 "slug": "OUTLOOK_ADD_MAIL_ATTACHMENT",
7724 "name": "Add mail attachment",
7725 - "description": "Tool to add an attachment to an email message. Use when you have a message ID and need to attach a small (<3 MB) file or reference."
7725 + "description": "Tool to add an attachment to an email message. Use when you have a message ID and need to attach a small (<3 MB) file or reference. For files ≥3 MB, use OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSION instead."
7726 },
7727 {
7728 "slug": "OUTLOOK_BATCH_MOVE_MESSAGES",
@@ -7737,7 +7737,7 @@
7737 {
7738 "slug": "OUTLOOK_CALENDAR_CREATE_EVENT",
7739 "name": "Create Calendar Event",
7740 - "description": "Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`."
7740 + "description": "Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`. No recurrence support; does not check scheduling conflicts. Re-running creates duplicate events — use OUTLOOK_UPDATE_CALENDAR_EVENT to modify existing events."
7741 },
7742 {
7743 "slug": "OUTLOOK_CANCEL_CALENDAR_EVENT",
@@ -7782,7 +7782,7 @@
7782 {
7783 "slug": "OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSION",
7784 "name": "Create attachment upload session",
7785 - "description": "Tool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chunks."
7785 + "description": "Tool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chunks. Direct attachment methods fail with 400/413 errors for files over ~3 MB. Upload sessions expire if chunks are not uploaded promptly; complete all chunk uploads before session expiry. Total message size (including base64 overhead) is capped at ~25 MB."
7786 },
7787 {
7788 "slug": "OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSION_IN_CHILD_FOLDER",
@@ -7867,7 +7867,7 @@
7867 {
7868 "slug": "OUTLOOK_CREATE_DRAFT_REPLY",
7869 "name": "Create a draft reply",
7870 - "description": "Creates a draft reply in the specified user's Outlook mailbox to an existing message (identified by a valid `message_id`), optionally including a `comment` and CC/BCC recipients."
7870 + "description": "Creates a draft reply in the specified user's Outlook mailbox to an existing message (identified by a valid `message_id`), optionally including a `comment` and CC/BCC recipients. The draft is NOT sent automatically; use OUTLOOK_SEND_DRAFT as a separate step to send it."
7871 },
7872 {
7873 "slug": "OUTLOOK_CREATE_EMAIL_RULE",
@@ -7892,7 +7892,7 @@
7892 {
7893 "slug": "OUTLOOK_CREATE_MAIL_FOLDER",
7894 "name": "Create mail folder",
7895 - "description": "Tool to create a new mail folder. Use when you need to organize email into a new folder."
7895 + "description": "Tool to create a new mail folder at the top level of the mailbox by default; nested folder creation is not supported via this tool. Use when you need to organize email into a new folder. Reference the returned folder `id` (not `displayName`) in downstream operations, as folder names are not unique."
7896 },
7897 {
7898 "slug": "OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE",
@@ -8147,7 +8147,7 @@
8147 {
8148 "slug": "OUTLOOK_DELETE_CONTACT",
8149 "name": "Delete Contact",
8150 - "description": "Permanently deletes an existing contact, using its `contact_id` (obtainable via 'List User Contacts' or 'Get Contact'), from the Outlook contacts of the user specified by `user_id`."
8150 + "description": "Permanently and irreversibly deletes an existing contact, using its `contact_id` (obtainable via 'List User Contacts' or 'Get Contact'), from the Outlook contacts of the user specified by `user_id`. Confirm user intent before executing — deletion cannot be undone."
8151 },
8152 {
8153 "slug": "OUTLOOK_DELETE_CONTACT_FOLDER",
@@ -8192,12 +8192,12 @@
8192 {
8193 "slug": "OUTLOOK_DELETE_EMAIL_RULE",
8194 "name": "Delete Email Rule",
8195 - "description": "Delete an email rule"
8195 + "description": "Delete an email rule permanently; deletion is irreversible. Confirm rule details with the user before executing. Removing a rule may alter the firing order and stop-processing behavior of remaining rules."
8196 },
8197 {
8198 "slug": "OUTLOOK_DELETE_EVENT",
8199 "name": "Delete calendar event (Deprecated)",
8200 - "description": "DEPRECATED: Use OUTLOOK_DELETE_CALENDAR_EVENT instead. Tool to delete an event from the user's calendar. Use when removing calendar events. If this is a meeting, deleting it removes it from the organizer's calendar and sends a cancellation message to attendees."
8200 + "description": "DEPRECATED: Use OUTLOOK_DELETE_CALENDAR_EVENT instead. Tool to delete an event from the user's calendar. Use when removing calendar events. If this is a meeting, deleting it removes it from the organizer's calendar and sends a cancellation message to all attendees. Require explicit user confirmation before calling this action."
8201 },
8202 {
8203 "slug": "OUTLOOK_DELETE_EVENT_ATTACHMENT",
@@ -8392,7 +8392,7 @@
8392 {
8393 "slug": "OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT",
8394 "name": "Download Outlook attachment",
8395 - "description": "Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain 'contentBytes' (binary data) and not be a link or embedded item."
8395 + "description": "Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain 'contentBytes' (binary data) and not be a link or embedded item. The returned data.file.s3url is temporary — download the file immediately after calling this tool; call again to get a fresh URL if needed. High-volume parallel calls may trigger HTTP 429 responses; honor the Retry-After header and use exponential backoff."
8396 },
8397 {
8398 "slug": "OUTLOOK_FIND_MEETING_TIMES",
@@ -8472,7 +8472,7 @@
8472 {
8473 "slug": "OUTLOOK_GET_CALENDAR_VIEW",
8474 "name": "Get Calendar View",
8475 - "description": "Get events ACTIVE during a time window (includes multi-day events). Use for \"what's on my calendar today/this week\" or availability checks. Returns events overlapping the time range. For keyword search or filters by category, use OUTLOOK_LIST_EVENTS instead."
8475 + "description": "Get events ACTIVE during a time window (includes multi-day events). Use for \"what's on my calendar today/this week\" or availability checks. Returns events overlapping the time range under the 'events' key; empty time windows return an empty array. If response includes @odata.nextLink, follow it to retrieve all events. Optional fields (joinUrl, webLink) may be absent on some event types. For keyword search or filters by category, use OUTLOOK_LIST_EVENTS instead."
8476 },
8477 {
8478 "slug": "OUTLOOK_GET_CHILD_FOLDER_MESSAGE",
@@ -8502,7 +8502,7 @@
8502 {
8503 "slug": "OUTLOOK_GET_CONTACT_FOLDERS",
8504 "name": "List user contact folders",
8505 - "description": "Tool to retrieve contact folders from a specific user's mailbox. Use when you need to list or browse contact folders for a given user."
8505 + "description": "Tool to retrieve contact folders from a specific user's mailbox. Use when you need to list or browse contact folders for a given user. Note: `displayName` is non-unique across folders; use the returned `id` field for any subsequent folder-targeting operations."
8506 },
8507 {
8508 "slug": "OUTLOOK_GET_CONTACT_FROM_FOLDER",
@@ -8562,12 +8562,12 @@
8562 {
8563 "slug": "OUTLOOK_GET_MAIL_TIPS",
8564 "name": "Get mail tips",
8565 - "description": "Tool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient status before sending mail."
8565 + "description": "Tool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient status before sending mail. Act on results — invalid addresses or full mailboxes can cause silent non-delivery even when the send call returns success."
8566 },
8567 {
8568 "slug": "OUTLOOK_GET_MASTER_CATEGORIES",
8569 "name": "Get master categories",
8570 - "description": "Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user."
8570 + "description": "Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user. Categories must exist here before they can be applied elsewhere; if a required category is absent, create it with OUTLOOK_CREATE_MASTER_CATEGORY first. Before creating a category, check this list for a case-insensitive match on `displayName` to avoid duplicates; paginate using `skip` when the list may span multiple pages. An empty list response means no categories are defined, not an error."
8571 },
8572 {
8573 "slug": "OUTLOOK_GET_MASTER_CATEGORY",
@@ -8657,7 +8657,7 @@
8657 {
8658 "slug": "OUTLOOK_GET_SCHEDULE",
8659 "name": "Get schedule",
8660 - "description": "Retrieves free/busy schedule information for specified email addresses within a defined time window."
8660 + "description": "Retrieves free/busy schedule information for specified email addresses within a defined time window. Read-only; does not reserve time or prevent conflicts — verify availability before creating events."
8661 },
8662 {
8663 "slug": "OUTLOOK_GET_SUPPORTED_LANGUAGES",
@@ -8667,7 +8667,7 @@
8667 {
8668 "slug": "OUTLOOK_GET_SUPPORTED_TIME_ZONES",
8669 "name": "Get supported time zones",
8670 - "description": "Tool to get the list of time zones supported for a user as configured on their mailbox server. Use when setting up an Outlook client or configuring user time zone preferences."
8670 + "description": "Tool to get the list of time zones supported for a user as configured on their mailbox server. Use when setting up an Outlook client or configuring user time zone preferences. Also use to validate timezone identifiers before passing them to scheduling or settings tools, as unrecognized identifiers can cause silent failures."
8671 },
8672 {
8673 "slug": "OUTLOOK_GET_USER_CALENDAR",
@@ -8752,7 +8752,7 @@
8752 {
8753 "slug": "OUTLOOK_LIST_CALENDARS",
8754 "name": "List Outlook calendars",
8755 - "description": "Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries."
8755 + "description": "Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries. Results may be partial; check @odata.nextLink in the response and paginate using top and skip to retrieve the full set. Use this tool to obtain calendar_id values before creating, updating, or querying events in non-primary calendars."
8756 },
8757 {
8758 "slug": "OUTLOOK_LIST_CALENDAR_VIEW_DELTA",
@@ -8797,7 +8797,7 @@
8797 {
8798 "slug": "OUTLOOK_LIST_CONTACTS",
8799 "name": "List Outlook contacts (Deprecated)",
8800 - "description": "DEPRECATED: Use OUTLOOK_LIST_USER_CONTACTS instead. Retrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder."
8800 + "description": "DEPRECATED: Use OUTLOOK_LIST_USER_CONTACTS instead. Retrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder. Response contacts are nested under `data.response_data.value`. Name-based lookups may return duplicate entries; verify `emailAddresses` before using a contact."
8801 },
8802 {
8803 "slug": "OUTLOOK_LIST_CONTACTS_DELTA",
@@ -8807,7 +8807,7 @@
8807 {
8808 "slug": "OUTLOOK_LIST_EMAIL_RULES",
8809 "name": "List Email Rules",
8810 - "description": "List all email rules from inbox"
8810 + "description": "List all email rules from inbox. No server-side filtering is supported; all rule narrowing must be done client-side after retrieval. Each rule includes a `sequence` field defining execution order and may include a `stopProcessingRules` flag affecting downstream rule execution."
8811 },
8812 {
8813 "slug": "OUTLOOK_LIST_EVENT_ATTACHMENTS",
@@ -8852,7 +8852,7 @@
8852 {
8853 "slug": "OUTLOOK_LIST_MAIL_FOLDERS",
8854 "name": "List mail folders",
8855 - "description": "Tool to list a user's top-level mail folders. Use when you need folders like Inbox, Drafts, Sent Items; set include_hidden_folders=True to include hidden folders."
8855 + "description": "Tool to list a user's top-level mail folders. Use when you need folders like Inbox, Drafts, Sent Items; set include_hidden_folders=True to include hidden folders. Returns only top-level folders — use OUTLOOK_LIST_CHILD_MAIL_FOLDERS for nested subfolders. Folder displayName values are localized and non-unique; always use the returned folder id when referencing folders in other operations like OUTLOOK_MOVE_MESSAGE or OUTLOOK_QUERY_EMAILS."
8856 },
8857 {
8858 "slug": "OUTLOOK_LIST_MAIL_FOLDERS_DELTA",
@@ -8887,7 +8887,7 @@
8887 {
8888 "slug": "OUTLOOK_LIST_OUTLOOK_ATTACHMENTS",
8889 "name": "List Outlook attachments",
8890 - "description": "Lists metadata (like name, size, and type, but not `contentBytes`) for all attachments of a specified Outlook email message."
8890 + "description": "Lists metadata (name, size, contentType, isInline — but not `contentBytes`) for all attachments of a specified Outlook email message. Returns fileAttachment, itemAttachment, and referenceAttachment types; only fileAttachment entries support download via OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT. Results include inline images and signatures — filter by `isInline == false` and check `contentType` to identify real document attachments. Results are nested under `data.response_data.value`."
8891 },
8892 {
8893 "slug": "OUTLOOK_LIST_PRIMARY_CALENDAR_PERMISSIONS",
@@ -8897,7 +8897,7 @@
8897 {
8898 "slug": "OUTLOOK_LIST_REMINDERS",
8899 "name": "List event reminders",
8900 - "description": "Tool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming reminders between two datetimes."
8900 + "description": "Tool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming reminders between two datetimes. Returned reminder times reflect the user's Outlook-configured timezone; supply datetimes with explicit UTC offsets or verify timezone alignment to avoid misinterpretation."
8901 },
8902 {
8903 "slug": "OUTLOOK_LIST_SENT_ITEMS_MESSAGES",
@@ -8947,7 +8947,7 @@
8947 {
8948 "slug": "OUTLOOK_LIST_USERS",
8949 "name": "List users",
8950 - "description": "Tool to list users in Microsoft Entra ID. Use when you need to retrieve a paginated list of users, optionally filtering or selecting specific properties."
8950 + "description": "Tool to list users in Microsoft Entra ID. Use when you need to retrieve a paginated list of users, optionally filtering or selecting specific properties. For single-user lookups, prefer a dedicated get-user tool — listing all users is significantly heavier and slower."
8951 },
8952 {
8953 "slug": "OUTLOOK_MOVE_MAIL_FOLDER",
@@ -8962,7 +8962,7 @@
8962 {
8963 "slug": "OUTLOOK_MOVE_MESSAGE",
8964 "name": "Move message to folder",
8965 - "description": "Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message."
8965 + "description": "Move a message to another folder within the specified user's mailbox. Creates a new copy in the destination folder and removes the original. The message_id changes after a successful move; use the ID returned in the response for any subsequent operations on the moved message. High-volume parallel moves can trigger HTTP 429 (MailboxConcurrency) throttling; honor the Retry-After header."
8966 },
8967 {
8968 "slug": "OUTLOOK_MOVE_MESSAGE_FROM_CHILD_FOLDER",
@@ -8992,7 +8992,7 @@
8992 {
8993 "slug": "OUTLOOK_REPLY_EMAIL",
8994 "name": "Reply to Email",
8995 - "description": "Sends a plain text reply to an Outlook email message, identified by `message_id`, allowing optional CC and BCC recipients."
8995 + "description": "Sends a plain text reply immediately and irreversibly to an Outlook email message, identified by `message_id`, allowing optional CC and BCC recipients. Confirm content and recipients before invoking."
8996 },
8997 {
8998 "slug": "OUTLOOK_SEARCH_MESSAGES",
@@ -9002,12 +9002,12 @@
9002 {
9003 "slug": "OUTLOOK_SEND_DRAFT",
9004 "name": "Send draft",
9005 - "description": "Tool to send an existing draft message. Use after creating a draft when you want to deliver it to recipients immediately. Example: Send a draft message with ID 'AAMkAG…'."
9005 + "description": "Tool to send an existing draft message immediately and irreversibly. Use after creating a draft when you want to deliver it to recipients. Confirm recipients, subject, and body with the user before calling — the send cannot be recalled. Example: Send a draft message with ID 'AAMkAG…'."
9006 },
9007 {
9008 "slug": "OUTLOOK_SEND_EMAIL",
9009 "name": "Send email",
9010 - "description": "Sends an email with subject, body, recipients, and an optional attachment via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Attachments require a non-empty file with valid name and mimetype."
9010 + "description": "Sends an email with subject, body, recipients, and an optional attachment via Microsoft Graph API. Supports comma-separated email addresses in the to field for multiple recipients. Attachments require a non-empty file with valid name and mimetype. Always starts a new thread; use OUTLOOK_REPLY_EMAIL to reply in-thread. Sends immediately and irreversibly — obtain explicit user confirmation before calling. On success, returns HTTP 202; do not retry a successful send as it will create duplicates. No scheduled send support."
9011 },
9012 {
9013 "slug": "OUTLOOK_SNOOZE_CALENDAR_GROUP_EVENT_REMINDER",
@@ -9117,7 +9117,7 @@
9117 {
9118 "slug": "OUTLOOK_UPDATE_MAILBOX_SETTINGS",
9119 "name": "Update mailbox settings",
9120 - "description": "Tool to update mailbox settings for the signed-in user. Use when you need to configure automatic replies, default time zone, language, or working hours. Example: schedule automatic replies for vacation."
9120 + "description": "Tool to update mailbox settings for the signed-in user. Use when you need to configure automatic replies, default time zone, language, or working hours. Example: schedule automatic replies for vacation. Changing timeZone or workingHours affects interpretation of all future calendar events and reminders."
9121 },
9122 {
9123 "slug": "OUTLOOK_UPDATE_MAIL_FOLDER",
@@ -9309,7 +9309,7 @@
9309 ],
9310 "toolCount": 1,
9311 "triggerCount": 0,
9312 - "version": "20260211_00",
9312 + "version": "20260316_00",
9313 "tools": [
9314 {
9315 "slug": "PERPLEXITYAI_PERPLEXITY_AI_SEARCH",
@@ -9355,7 +9355,7 @@
9355 ],
9356 "toolCount": 80,
9357 "triggerCount": 0,
9358 - "version": "20260312_00",
9358 + "version": "20260316_00",
9359 "tools": [
9360 {
9361 "slug": "TWITTER_ADD_LIST_MEMBER",
@@ -9480,7 +9480,7 @@
9480 {
9481 "slug": "TWITTER_GET_MEDIA_UPLOAD_STATUS",
9482 "name": "Get Media Upload Status",
9483 - "description": "Get the status of a media upload for X/Twitter. Use this to check the processing status of uploaded media, especially for videos and GIFs. Only needed if the FINALIZE command returned processing_info."
9483 + "description": "Get the processing status of uploaded media (videos/GIFs) on X/Twitter. Only call this when the FINALIZE command returned a processing_info field. Poll every 3–5 seconds with a 60–120 second maximum timeout to avoid HTTP 429 errors. Response state cycles through 'pending', 'in_progress', 'succeeded', and 'failed'. Only attach media_id to a tweet when state is 'succeeded'. State 'failed' is terminal — requires a completely new upload via TWITTER_UPLOAD_MEDIA or TWITTER_UPLOAD_LARGE_MEDIA. Video/GIF processing takes 30–120 seconds; posting before 'succeeded' results in non-playable media."
9484 },
9485 {
9486 "slug": "TWITTER_GET_MUTED_USERS",
@@ -9720,12 +9720,12 @@
9720 {
9721 "slug": "TWITTER_UPLOAD_LARGE_MEDIA",
9722 "name": "Upload Large Media",
9723 - "description": "Use this to upload media files to X/Twitter. Automatically uses chunked upload for GIFs, videos, and images larger than 5 MB to avoid size limit errors."
9723 + "description": "Use this to upload a single media file to X/Twitter. Automatically uses chunked upload for GIFs, videos, and images larger than 5 MB. Max file size: 512 MB; max video duration: 140 seconds. After upload, poll TWITTER_GET_MEDIA_UPLOAD_STATUS until processing_info.state=='succeeded' before attaching the media_id to a tweet — GIFs and videos take 30–120 seconds to process. A terminal 'failed' state means the media_id is unusable and the file must be re-uploaded."
9724 },
9725 {
9726 "slug": "TWITTER_UPLOAD_MEDIA",
9727 "name": "Upload Media",
9728 - "description": "Upload media (images only) to X/Twitter using the v2 API. This action only supports images (tweet_image, dm_image) and subtitle files. For GIFs, videos, or any file larger than ~5 MB, use TWITTER_UPLOAD_LARGE_MEDIA instead."
9728 + "description": "Upload media (images only) to X/Twitter using the v2 API. Supports tweet_image, dm_image, and subtitles media categories only. One file per call; the returned media_id expires (see expires_after_secs in response), so upload immediately before creating the tweet. For GIFs, videos, or any file larger than ~5 MB, use TWITTER_UPLOAD_LARGE_MEDIA instead."
9729 },
9730 {
9731 "slug": "TWITTER_UPLOAD_MEDIA_BASE64",
@@ -9832,12 +9832,12 @@
9832 ],
9833 "toolCount": 89,
9834 "triggerCount": 7,
9835 - "version": "20260313_01",
9835 + "version": "20260316_00",
9836 "tools": [
9837 {
9838 "slug": "GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE",
9839 "name": "Add file sharing preference (Deprecated)",
9840 - "description": "DEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead. Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or 'anyone'."
9840 + "description": "DEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead; use GOOGLEDRIVE_UPDATE_PERMISSION to modify existing permissions (avoids duplicate entries). Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or 'anyone'. Bulk calls may trigger 403 rateLimitExceeded (~100 req/100s/user); use jittered exponential backoff."
9841 },
9842 {
9843 "slug": "GOOGLEDRIVE_ADD_PARENT",
@@ -9852,7 +9852,7 @@
9852 {
9853 "slug": "GOOGLEDRIVE_COPY_FILE",
9854 "name": "Copy file (Deprecated)",
9855 - "description": "DEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. Duplicates an existing file in Google Drive, identified by its `file_id`."
9855 + "description": "DEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. Duplicates an existing file (not folders) in Google Drive by `file_id`; copy lands in same folder as original — use GOOGLEDRIVE_MOVE_FILE afterward for precise placement. Copy receives a new `file_id`; update stored references accordingly. For shared drives, requires organizer/manager rights."
9856 },
9857 {
9858 "slug": "GOOGLEDRIVE_COPY_FILE_ADVANCED",
@@ -9862,7 +9862,7 @@
9862 {
9863 "slug": "GOOGLEDRIVE_CREATE_COMMENT",
9864 "name": "Create Comment",
9865 - "description": "Tool to create a comment on a file. Use when you need to add a new comment to a specific file in Google Drive."
9865 + "description": "Tool to create a comment on a file in Google Drive. Returns a nested `data` object; extract `data.id` for the resulting comment identifier. Omit `anchor` and `quoted_file_content_*` for general file-level comments."
9866 },
9867 {
9868 "slug": "GOOGLEDRIVE_CREATE_DRIVE",
@@ -9872,17 +9872,17 @@
9872 {
9873 "slug": "GOOGLEDRIVE_CREATE_FILE",
9874 "name": "Create File or Folder",
9875 - "description": "Creates a new file or folder with metadata. Use to create empty files or folders, or files with content by providing it in the request body (though this action primarily focuses on metadata creation)."
9875 + "description": "Creates a new file or folder with metadata. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells; content must be added manually in the Google UI afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER."
9876 },
9877 {
9878 "slug": "GOOGLEDRIVE_CREATE_FILE_FROM_TEXT",
9879 "name": "Create a File from Text",
9880 - "description": "Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types."
9880 + "description": "Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types. Returns flat metadata fields (`id`, `mimeType`, `name`) at the top level — not nested under a `file` object. Created files are private by default; use a sharing tool afterward for collaborative access. Rapid successive calls may trigger `403 rateLimitExceeded` or `429 userRateLimitExceeded`; apply exponential backoff between retries. Does not support shared-drive targets in all cases."
9881 },
9882 {
9883 "slug": "GOOGLEDRIVE_CREATE_FOLDER",
9884 "name": "Create a folder",
9885 - "description": "Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the parent exists or find its ID."
9885 + "description": "Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the parent exists or find its ID. Google Drive permits duplicate folder names, so always store and reuse the folder ID returned by this action rather than relying on names for future lookups."
9886 },
9887 {
9888 "slug": "GOOGLEDRIVE_CREATE_PERMISSION",
@@ -9897,7 +9897,7 @@
9897 {
9898 "slug": "GOOGLEDRIVE_CREATE_SHORTCUT_TO_FILE",
9899 "name": "Create Shortcut to File/Folder",
9900 - "description": "Tool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it."
9900 + "description": "Tool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it. The shortcut receives its own distinct file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE_MOVE_FILE after creation to place the shortcut in the desired location."
9901 },
9902 {
9903 "slug": "GOOGLEDRIVE_CREATE_TEAM_DRIVE",
@@ -9912,7 +9912,7 @@
9912 {
9913 "slug": "GOOGLEDRIVE_DELETE_COMMENT",
9914 "name": "Delete Comment",
9915 - "description": "Deletes a comment from a file. Use when you need to remove a specific comment from a Google Drive file."
9915 + "description": "Permanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE_DELETE_REPLY instead. Verify the exact comment content and comment_id before calling."
9916 },
9917 {
9918 "slug": "GOOGLEDRIVE_DELETE_DRIVE",
@@ -9932,7 +9932,7 @@
9932 {
9933 "slug": "GOOGLEDRIVE_DELETE_PERMISSION",
9934 "name": "Delete Permission",
9935 - "description": "Deletes a permission from a file by permission ID. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMISSIONS to get valid permission IDs. Use when you need to revoke access for a specific user or group from a file."
9935 + "description": "Deletes a permission from a file by permission ID. Deletion is irreversible — confirm the target user, group, or permission type before executing. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMISSIONS to get valid permission IDs. To fully revoke public access, the type='anyone' (link-sharing) permission must be explicitly deleted; revoking other permissions leaves the file publicly accessible via link. Use when you need to revoke access for a specific user or group from a file."
9936 },
9937 {
9938 "slug": "GOOGLEDRIVE_DELETE_PROPERTY",
@@ -9942,7 +9942,7 @@
9942 {
9943 "slug": "GOOGLEDRIVE_DELETE_REPLY",
9944 "name": "Delete Reply",
9945 - "description": "Tool to delete a specific reply by reply ID. Use when you need to remove a reply from a comment on a file."
9945 + "description": "Tool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread — use GOOGLEDRIVE_DELETE_COMMENT to remove the entire thread."
9946 },
9947 {
9948 "slug": "GOOGLEDRIVE_DELETE_REVISION",
@@ -9967,17 +9967,17 @@
9967 {
9968 "slug": "GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION",
9969 "name": "Download file via operation",
9970 - "description": "Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation."
9970 + "description": "Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation. Returns a response containing `downloaded_file_content.s3url` — a short-lived S3 URL; fetch the actual file bytes from that URL promptly after the call."
9971 },
9972 {
9973 "slug": "GOOGLEDRIVE_EDIT_FILE",
9974 "name": "Edit File",
9975 - "description": "Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly."
9975 + "description": "Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly. Preserves the original file_id (unlike GOOGLEDRIVE_UPLOAD_FILE which creates a new ID)."
9976 },
9977 {
9978 "slug": "GOOGLEDRIVE_EMPTY_TRASH",
9979 "name": "Empty Trash",
9980 - "description": "Tool to permanently delete all of the user's trashed files. Use when you want to empty the trash in Google Drive. This action allows you to permanently remove all files that are currently in the trash of Google Drive. It can be applied to files in both the user's root trash and shared drives, ensuring a complete removal of unwanted files."
9980 + "description": "Tool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. Recovery is impossible after execution — no Drive tool can restore items once trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive's trash; omit to empty the user's root trash."
9981 },
9982 {
9983 "slug": "GOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILE",
@@ -10002,7 +10002,7 @@
10002 {
10003 "slug": "GOOGLEDRIVE_GET_ABOUT",
10004 "name": "Get about",
10005 - "description": "Tool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats."
10005 + "description": "Tool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats. Note: storageQuota reflects My Drive (personal) storage only — it does not cover shared drives; use GOOGLEDRIVE_LIST_SHARED_DRIVES and GOOGLEDRIVE_GET_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately."
10006 },
10007 {
10008 "slug": "GOOGLEDRIVE_GET_APP",
@@ -10017,7 +10017,7 @@
10017 {
10018 "slug": "GOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKEN",
10019 "name": "Get Changes Start Page Token",
10020 - "description": "Tool to get the starting pageToken for listing future changes in Google Drive. Use this when you need to track changes to files and folders."
10020 + "description": "Tool to get the starting pageToken for listing future changes in Google Drive. Returns only a token — pass it to GOOGLEDRIVE_LIST_CHANGES to retrieve actual changes. Persist this token; losing it requires a full rescan. The token is forward-looking: GOOGLEDRIVE_LIST_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE; use this tool only for incremental change-feed workflows."
10021 },
10022 {
10023 "slug": "GOOGLEDRIVE_GET_CHILD",
@@ -10032,12 +10032,12 @@
10032 {
10033 "slug": "GOOGLEDRIVE_GET_DRIVE",
10034 "name": "Get Shared Drive",
10035 - "description": "Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive."
10035 + "description": "Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. To discover drive_ids, use GOOGLEDRIVE_LIST_SHARED_DRIVES first; GOOGLEDRIVE_GET_ABOUT reflects overall user storage, not individual shared drive details. Permission changes may have a brief propagation delay before appearing in results."
10036 },
10037 {
10038 "slug": "GOOGLEDRIVE_GET_FILE_METADATA",
10039 "name": "Get File Metadata",
10040 - "description": "Tool to get a file's metadata by ID. Use when you need to retrieve the metadata for a specific file in Google Drive."
10040 + "description": "Tool to get a file's metadata by ID. Use to verify `mimeType`, `parents`, and `trashed` status before destructive operations (delete/move/export), or to confirm `mimeType='application/vnd.google-apps.document'` before calling GOOGLEDOCS_* tools (non-native files require GOOGLEDRIVE_DOWNLOAD_FILE). Only returns metadata visible to the connected account; public access requires GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE. High-frequency calls risk `403 rateLimitExceeded`; apply exponential backoff."
10041 },
10042 {
10043 "slug": "GOOGLEDRIVE_GET_FILE_PROPERTY",
@@ -10057,7 +10057,7 @@
10057 {
10058 "slug": "GOOGLEDRIVE_GET_PERMISSION",
10059 "name": "Get Permission",
10060 - "description": "Gets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive."
10060 + "description": "Gets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. Newly created or updated permissions on shared drives may have a brief propagation delay before appearing."
10061 },
10062 {
10063 "slug": "GOOGLEDRIVE_GET_PERMISSION_ID_FOR_EMAIL",
@@ -10072,7 +10072,7 @@
10072 {
10073 "slug": "GOOGLEDRIVE_GET_REVISION",
10074 "name": "Get Revision",
10075 - "description": "Tool to get a specific revision's metadata by revision ID. Use when you need to retrieve information about a particular version of a file."
10075 + "description": "Tool to get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID. Returns metadata only — not file content. Use a separate download tool to retrieve file content or restore a revision."
10076 },
10077 {
10078 "slug": "GOOGLEDRIVE_GET_TEAM_DRIVE",
@@ -10082,7 +10082,7 @@
10082 {
10083 "slug": "GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION",
10084 "name": "Delete folder or file",
10085 - "description": "Tool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. Note: This action is irreversible."
10085 + "description": "Tool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. Note: This action is irreversible. Deleting a folder permanently removes all nested files and subfolders."
10086 },
10087 {
10088 "slug": "GOOGLEDRIVE_HIDE_DRIVE",
@@ -10107,7 +10107,7 @@
10107 {
10108 "slug": "GOOGLEDRIVE_LIST_CHANGES",
10109 "name": "List Changes",
10110 - "description": "Tool to list the changes for a user or shared drive. Use when you need to track modifications to files and folders, such as creations, deletions, or permission changes. The pageToken is optional - if not provided, the current start page token will be automatically fetched to begin monitoring changes from now. Example usage (continuing with pageToken): ```json { \"pageToken\": \"22633\", \"pageSize\": 100, \"includeRemoved\": true } ``` Returns changes with timestamps, file IDs, and modification details. Save the `nextPageToken` from the response to continue paginating through changes, or save the `newStartPageToken` to monitor future changes efficiently."
10110 + "description": "Tool to list the changes for a user or shared drive. Use when a full incremental change feed is needed (for simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE instead). Tracks modifications such as creations, deletions, or permission changes. The pageToken is optional - if not provided, the current start page token will be automatically fetched; an empty result is valid if no recent activity has occurred. Example usage: ```json { \"pageToken\": \"22633\", \"pageSize\": 100, \"includeRemoved\": true } ``` Returns changes with timestamps, file IDs, and modification details. Paginate by following `nextPageToken` until it is absent — stopping early will silently omit changes. Save `newStartPageToken` to monitor future changes efficiently."
10111 },
10112 {
10113 "slug": "GOOGLEDRIVE_LIST_CHILDREN_V2",
@@ -10117,12 +10117,12 @@
10117 {
10118 "slug": "GOOGLEDRIVE_LIST_COMMENTS",
10119 "name": "List Comments",
10120 - "description": "Tool to list all comments for a file in Google Drive. Use when you need to retrieve comments associated with a specific file."
10120 + "description": "Tool to list all comments for a file in Google Drive. Results are paginated; iterate using nextPageToken until absent to retrieve all comments. Filtering by author, content, or other criteria must be done client-side. Use commentId, createdTime, and author from results to uniquely identify comments before acting on them."
10121 },
10122 {
10123 "slug": "GOOGLEDRIVE_LIST_FILE_LABELS",
10124 "name": "List File Labels",
10125 - "description": "Tool to list the labels on a file. Use when you need to retrieve all labels associated with a specific file in Google Drive."
10125 + "description": "Tool to list the labels already applied to a file in Google Drive. An empty labels array is a valid response indicating no labels are applied, not an error. This tool shows only applied labels; label_id and field_id values required by other Drive label tools must be obtained from admin configuration."
10126 },
10127 {
10128 "slug": "GOOGLEDRIVE_LIST_FILE_PROPERTIES",
@@ -10147,12 +10147,12 @@
10147 {
10148 "slug": "GOOGLEDRIVE_LIST_REVISIONS",
10149 "name": "List File Revisions",
10150 - "description": "Tool to list a file's revisions. Use when you need to retrieve the revision history of a specific file in Google Drive."
10150 + "description": "Tool to list a file's revision metadata (not content) in Google Drive. Drive may prune old revisions, so history may be incomplete for frequently edited files. Filter client-side for specific revisionIds; do not assume the last entry is the active version."
10151 },
10152 {
10153 "slug": "GOOGLEDRIVE_LIST_SHARED_DRIVES",
10154 "name": "List Shared Drives",
10155 - "description": "Tool to list the user's shared drives. Use when you need to get a list of all shared drives accessible to the authenticated user."
10155 + "description": "Tool to list the user's shared drives. Use when you need to get a list of all shared drives accessible to the authenticated user. Results may differ from the web UI due to admin policies; listing a drive does not guarantee access to its contents. Paginated calls may trigger 403 rateLimitExceeded or 429 tooManyRequests; apply exponential backoff when iterating many pages."
10156 },
10157 {
10158 "slug": "GOOGLEDRIVE_LIST_TEAM_DRIVES",
@@ -10167,7 +10167,7 @@
10167 {
10168 "slug": "GOOGLEDRIVE_MOVE_FILE",
10169 "name": "Move File",
10170 - "description": "Tool to move a file from one folder to another in Google Drive. Use when you need to reorganize files by changing their parent folder(s)."
10170 + "description": "Tool to move a file from one folder to another in Google Drive. To truly move (not just copy the parent), always provide both `add_parents` (destination folder ID) and `remove_parents` (source folder ID); omitting `remove_parents` leaves the file in multiple folders. Useful for reorganizing files, including newly created Google Docs/Sheets that default to Drive root."
10171 },
10172 {
10173 "slug": "GOOGLEDRIVE_PARSE_FILE",
@@ -10187,12 +10187,12 @@
10187 {
10188 "slug": "GOOGLEDRIVE_RESUMABLE_UPLOAD",
10189 "name": "Resumable Upload",
10190 - "description": "Tool to start and complete a Google Drive resumable upload session. Use when uploading large files that require resumable, chunked uploads."
10190 + "description": "Tool to start and complete a Google Drive resumable upload session. Use for files larger than ~5 MB to avoid timeouts or size-limit failures. HTTP 308 means continue the session from the correct byte offset; HTTP 410 means the session expired and a full restart with a new session is required."
10191 },
10192 {
10193 "slug": "GOOGLEDRIVE_STOP_WATCH_CHANNEL",
10194 "name": "Stop Watch Channel",
10195 - "description": "Tool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch."
10195 + "description": "Tool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch. Both `id` and `resourceId` must be saved from the original watch response — they cannot be retrieved after the fact."
10196 },
10197 {
10198 "slug": "GOOGLEDRIVE_TRASH_FILE",
@@ -10207,7 +10207,7 @@
10207 {
10208 "slug": "GOOGLEDRIVE_UNTRASH_FILE",
10209 "name": "Untrash File",
10210 - "description": "Tool to restore a file from the trash. Use when you need to recover a deleted file. This action updates the file's metadata to set the 'trashed' property to false."
10210 + "description": "Tool to restore a file from the trash. Use when you need to recover a deleted file. This action updates the file's metadata to set the 'trashed' property to false. Only works while the file remains in trash — recovery is impossible after trash is emptied via GOOGLEDRIVE_EMPTY_TRASH or auto-purged by policy."
10211 },
10212 {
10213 "slug": "GOOGLEDRIVE_UPDATE_COMMENT",
@@ -10232,7 +10232,7 @@
10232 {
10233 "slug": "GOOGLEDRIVE_UPDATE_FILE_PUT",
10234 "name": "Update File (Metadata)",
10235 - "description": "Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3. Use this tool to modify attributes of an existing file like its name, description, or parent folders. Note: This action currently supports metadata updates only. File content updates require multipart/related upload and are not yet implemented."
10235 + "description": "Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 — only explicitly provided fields are updated, so omit fields you do not intend to overwrite. Use this tool to modify attributes of an existing file like its name, description, or parent folders. To move a file, supply add_parents and remove_parents together; omitting remove_parents creates multiple parents, omitting add_parents can orphan the file. Bulk updates may trigger 429 Too Many Requests; apply exponential backoff. Note: supports metadata updates only; file content updates are not yet implemented."
10236 },
10237 {
10238 "slug": "GOOGLEDRIVE_UPDATE_FILE_REVISION_METADATA",
@@ -10242,7 +10242,7 @@
10242 {
10243 "slug": "GOOGLEDRIVE_UPDATE_PERMISSION",
10244 "name": "Update Permission",
10245 - "description": "Tool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive."
10245 + "description": "Tool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive. Inherited or domain-managed permissions may not be editable; verify editability with GOOGLEDRIVE_LIST_PERMISSIONS before updating."
10246 },
10247 {
10248 "slug": "GOOGLEDRIVE_UPDATE_REPLY",
@@ -10257,7 +10257,7 @@
10257 {
10258 "slug": "GOOGLEDRIVE_UPLOAD_FILE",
10259 "name": "Upload File",
10260 - "description": "Uploads a file (max 5MB) to Google Drive, moving it to a specified folder if a valid folder ID is provided, otherwise uploads to root."
10260 + "description": "Uploads a file (max 5MB) to Google Drive, placing it in the specified folder or root if no valid folder ID is provided. Always creates a new file (never updates existing); use GOOGLEDRIVE_EDIT_FILE to update with a stable file_id. Uploaded files are private by default; configure sharing via GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE."
10261 },
10262 {
10263 "slug": "GOOGLEDRIVE_UPLOAD_FROM_URL",
@@ -10272,7 +10272,7 @@
10272 {
10273 "slug": "GOOGLEDRIVE_WATCH_CHANGES",
10274 "name": "Watch Drive Changes",
10275 - "description": "Tool to subscribe to changes for a user or shared drive in Google Drive. Use when you need to monitor a Google Drive for modifications and receive notifications at a specified webhook URL."
10275 + "description": "Tool to subscribe to changes for a user or shared drive in Google Drive. Use when you need to monitor a Google Drive for modifications and receive notifications at a specified webhook URL. Notifications may be batched rather than per-change; design handlers to be idempotent and fetch all changes since the last known page_token on each notification."
10276 },
10277 {
10278 "slug": "GOOGLEDRIVE_WATCH_FILE",
@@ -10382,7 +10382,7 @@
10382 ],
10383 "toolCount": 35,
10384 "triggerCount": 10,
10385 - "version": "20260312_00",
10385 + "version": "20260316_00",
10386 "tools": [
10387 {
10388 "slug": "GOOGLEDOCS_COPY_DOCUMENT",
@@ -10678,7 +10678,7 @@
10678 ],
10679 "toolCount": 229,
10680 "triggerCount": 2,
10681 - "version": "20260312_00",
10681 + "version": "20260316_00",
10682 "tools": [
10683 {
10684 "slug": "HUBSPOT_ADD_ASSET_ASSOCIATION",
@@ -11935,7 +11935,7 @@
11935 ],
11936 "toolCount": 31,
11937 "triggerCount": 3,
11938 - "version": "20260312_00",
11938 + "version": "20260316_00",
11939 "tools": [
11940 {
11941 "slug": "LINEAR_CREATE_ATTACHMENT",
@@ -11950,12 +11950,12 @@
11950 {
11951 "slug": "LINEAR_CREATE_LINEAR_COMMENT",
11952 "name": "Create a comment",
11953 - "description": "Creates a new comment on a specified Linear issue."
11953 + "description": "Creates a new comment on a specified Linear issue. This action modifies shared workspace data and is not reversible — confirm the target issue and comment content before executing."
11954 },
11955 {
11956 "slug": "LINEAR_CREATE_LINEAR_ISSUE",
11957 "name": "Create linear issue",
11958 - "description": "Creates a new issue in a specified Linear project and team, requiring team_id and title, and allowing for optional properties like description, assignee, state, priority, cycle, and due date."
11958 + "description": "Creates a new issue in a specified Linear project and team, requiring team_id and title, and allowing optional properties like description, assignee, state, priority, cycle, and due date. All UUID parameters (state_id, assignee_id, cycle_id, label_ids, project_id) must belong to the same team as team_id. The created issue's id is returned in data.id — capture it for use as parent_id in sub-issues or follow-up operations. No template_id field exists; expand templates manually into title and description before calling."
11959 },
11960 {
11961 "slug": "LINEAR_CREATE_LINEAR_ISSUE_RELATION",
@@ -11965,7 +11965,7 @@
11965 {
11966 "slug": "LINEAR_CREATE_LINEAR_LABEL",
11967 "name": "Create a label",
11968 - "description": "Creates a new label in Linear for a specified team, used to categorize and organize issues. Label names must be unique within each team. If a label with the same name already exists, the existing label will be returned."
11968 + "description": "Creates a new label in Linear for a specified team, used to categorize and organize issues. Label names must be unique within each team. If a label with the same name already exists, the existing label will be returned. Both new and existing labels return the same object structure; check the label's `createdAt` or compare IDs to determine if creation occurred."
11969 },
11970 {
11971 "slug": "LINEAR_CREATE_LINEAR_PROJECT",
@@ -11975,12 +11975,12 @@
11975 {
11976 "slug": "LINEAR_DELETE_LINEAR_ISSUE",
11977 "name": "Delete issue",
11978 - "description": "Archives an existing Linear issue by its ID, which is Linear's standard way of deleting issues; the operation is idempotent."
11978 + "description": "Archives an existing Linear issue by its ID, which is Linear's standard way of deleting issues; the operation is idempotent. Archiving is permanent with no built-in undo — confirm the issue identifier and title with the user before executing, especially in bulk operations."
11979 },
11980 {
11981 "slug": "LINEAR_GET_ALL_LINEAR_TEAMS",
11982 "name": "Get all teams (Deprecated)",
11983 - "description": "DEPRECATED: Use ListLinearTeams instead. Retrieves all teams from the Linear workspace without requiring any parameters."
11983 + "description": "DEPRECATED: Use ListLinearTeams instead (returns paginated payloads with members and projects); this tool returns simpler id/name-level data for all teams visible to the connected workspace with no server-side filtering. Match teams on stable team id, not display name, as names are not guaranteed unique. Partial results reflect workspace permission scope, not tool failure. Skip this call if team_id values are already known."
11984 },
11985 {
11986 "slug": "LINEAR_GET_ATTACHMENT",
@@ -11990,12 +11990,12 @@
11990 {
11991 "slug": "LINEAR_GET_CURRENT_USER",
11992 "name": "Get current user",
11993 - "description": "Gets the currently authenticated user's ID, name, email, and other profile information. Use this to identify 'me' in other Linear operations that require user ID filtering."
11993 + "description": "Gets the currently authenticated user's ID, name, email, and other profile information — this is the account behind the API token, which may be a bot or service account rather than a human user. Use the returned `id` field (nested under `data.viewer`) for downstream Linear operations requiring user ID filtering. To search or compare other workspace members, use LINEAR_LIST_LINEAR_USERS instead."
11994 },
11995 {
11996 "slug": "LINEAR_GET_CYCLES_BY_TEAM_ID",
11997 "name": "Get cycles by team ID",
11998 - "description": "Retrieves all cycles for a specified Linear team ID; cycles are time-boxed work periods (like sprints) and the team ID must correspond to an existing team."
11998 + "description": "Retrieves all cycles for a specified Linear team ID; cycles are time-boxed work periods (like sprints). Results are team-scoped to the given team_id. To identify the active cycle, check that the current date (in UTC) falls between a cycle's startAt and endAt fields; either field may be null. Results may be paginated — follow page_info cursors to retrieve all cycles."
11999 },
12000 {
12001 "slug": "LINEAR_GET_ISSUE_DEFAULTS",
@@ -12005,7 +12005,7 @@
12005 {
12006 "slug": "LINEAR_GET_LINEAR_ISSUE",
12007 "name": "Get Linear issue",
12008 - "description": "Retrieves an existing Linear issue's comprehensive details, including id, identifier, title, description, timestamps, state, team, creator, attachments, comments (with user info and timestamps), subscribers, and due date."
12008 + "description": "Retrieves an existing Linear issue's comprehensive details, including id, identifier, title, description, timestamps, state, team, creator, attachments, comments (with user info and timestamps, use issue.comments.nodes for comment IDs), subscribers, and due date. Does not include parent, milestone, cycle, or relation graphs—use LINEAR_RUN_QUERY_OR_MUTATION for those. Optional fields (labels, project, state, assignee, cycle) may be null; guard against null when accessing nested properties. Returns null or 'Entity not found' for invalid IDs, cross-workspace IDs, or restricted teams. Rate limit: ~60 req/min; HTTP 429 on excess—apply exponential backoff and respect Retry-After headers."
12009 },
12010 {
12011 "slug": "LINEAR_GET_LINEAR_PROJECT",
@@ -12015,7 +12015,7 @@
12015 {
12016 "slug": "LINEAR_LIST_ISSUE_DRAFTS",
12017 "name": "List issue drafts",
12018 - "description": "Tool to list issue drafts. Use when you need to fetch draft issues for review or further editing."
12018 + "description": "Tool to list issue drafts. Use when you need to fetch draft issues for review or further editing. Check `pageInfo.hasNextPage` in the response to determine if additional drafts exist beyond the current page."
12019 },
12020 {
12021 "slug": "LINEAR_LIST_ISSUES_BY_TEAM_ID",
@@ -12025,42 +12025,42 @@
12025 {
12026 "slug": "LINEAR_LIST_LINEAR_CYCLES",
12027 "name": "Get all cycles",
12028 - "description": "Retrieves all cycles (time-boxed iterations for work) from the Linear account; no filters are applied."
12028 + "description": "Retrieves all cycles (time-boxed sprint iterations) org-wide from the Linear account; no filters applied. In large multi-team workspaces this produces heavy responses — filter client-side by team ID and date range using each cycle's startsAt/endsAt fields. Cycles are team-scoped; always group by team ID to avoid mixing sprints across teams. To identify the active sprint, verify the current UTC timestamp falls between startsAt and endsAt, and handle null startsAt/endsAt defensively. Timestamps are UTC. Results may be paginated; follow pageInfo.endCursor and hasNextPage until hasNextPage is false to avoid truncated lists."
12029 },
12030 {
12031 "slug": "LINEAR_LIST_LINEAR_ISSUES",
12032 "name": "List Linear issues",
12033 - "description": "Lists non-archived Linear issues; if project_id is not specified, issues from all accessible projects are returned. Can also filter by assignee_id to get issues assigned to a specific user."
12033 + "description": "Lists non-archived Linear issues; if project_id is not specified, issues from all accessible projects are returned. Can filter by assignee_id. Only project_id and assignee_id server-side filters are supported; label, state, team, cycle, or date filters must be done client-side or via LINEAR_RUN_QUERY_OR_MUTATION. Response is a flat issues array plus page_info object (not GraphQL nodes/pageInfo). Fields like cycle membership, dueDate, completedAt, comments, and attachments are absent; use LINEAR_GET_LINEAR_ISSUE for enrichment. state and labels are nested objects (labels as labels.nodes array). Response order is not guaranteed; sort client-side after collecting all pages. No team_id filter; scope by project_id or use LINEAR_RUN_QUERY_OR_MUTATION."
12034 },
12035 {
12036 "slug": "LINEAR_LIST_LINEAR_LABELS",
12037 "name": "Get labels",
12038 - "description": "Retrieves labels from Linear. If team_id is provided, returns labels for that specific team. If team_id is omitted, returns all labels across the workspace."
12038 + "description": "Retrieves labels from Linear. If team_id is provided, returns labels for that specific team; if omitted, returns all labels across the workspace. Label names are not unique across teams — always use returned IDs, not names, and track each label ID with its team ID. In large workspaces, results may paginate; follow pageInfo.hasNextPage and pageInfo.endCursor to retrieve all labels."
12039 },
12040 {
12041 "slug": "LINEAR_LIST_LINEAR_PROJECTS",
12042 "name": "List linear projects",
12043 - "description": "Retrieves all projects from the Linear account."
12043 + "description": "Retrieves all projects from the Linear account. Returns a flat array (not a GraphQL connection) with fields id and name; use LINEAR_RUN_QUERY_OR_MUTATION for progress, state, issues, or team linkage. No server-side filtering: all workspace projects are returned regardless of team or name — filter client-side. Multiple projects can share identical names; always confirm project_id before downstream use. Results are permission-scoped to the connected user. Pagination: loop while page_info.hasNextPage is true, passing page_info.endCursor as after, or results will be silently truncated. HTTP 429 may occur in large workspaces; apply exponential backoff between calls."
12044 },
12045 {
12046 "slug": "LINEAR_LIST_LINEAR_STATES",
12047 "name": "List Linear states",
12048 - "description": "Retrieves all workflow states for a specified team in Linear, representing the stages an issue progresses through in that team's workflow."
12048 + "description": "Retrieves all workflow states for a specified team in Linear, representing the stages an issue progresses through in that team's workflow. Returned state IDs are team-scoped — never reuse a stateId across different teams, as this causes validation errors or 'Entity not found' failures in tools like LINEAR_UPDATE_ISSUE. State names (e.g., 'Done', 'In Progress') are non-unique across teams; always resolve names to IDs via this tool for the specific team_id before using them in filters or mutations. Uses cursor-based pagination via pageInfo.hasNextPage and endCursor; iterate until hasNextPage is false to avoid missing states in large workspaces. Always fetch fresh state IDs rather than hardcoding or reusing stale values."
12049 },
12050 {
12051 "slug": "LINEAR_LIST_LINEAR_TEAMS",
12052 "name": "Get teams",
12053 - "description": "Retrieves all teams with their members. Optionally filters each team's associated projects by project_id."
12053 + "description": "Retrieves all teams with their members and projects. Use stable team IDs or keys (not display names) for subsequent operations — names are non-unique. Results reflect only teams visible to the authenticated token scope; missing teams or members indicate permission limits. Large workspaces paginate via pageInfo.hasNextPage/endCursor — incomplete pagination silently drops teams or members. Members may belong to multiple teams; deduplicate user IDs when aggregating. Use LINEAR_GET_ALL_LINEAR_TEAMS instead when only identifiers are needed."
12054 },
12055 {
12056 "slug": "LINEAR_LIST_LINEAR_USERS",
12057 "name": "List Linear users",
12058 - "description": "Lists all users in the Linear workspace with their IDs, names, emails, and active status."
12058 + "description": "Lists all workspace users (not team-scoped) with their IDs, names, emails, and active status. Display names are non-unique — use email to disambiguate before extracting an ID. Only assign users with `active: true`. Returned IDs are UUID strings; pass them as-is to fields like `assignee_id` — never substitute names, emails, or tokens. When joining with other tools, always join on IDs."
12059 },
12060 {
12061 "slug": "LINEAR_REMOVE_ISSUE_LABEL",
12062 "name": "Remove label from Linear issue",
12063 - "description": "Removes a specified label from an existing Linear issue using their IDs; successful even if the label isn't on the issue."
12063 + "description": "Removes a specified label from an existing Linear issue using their IDs; successful even if the label isn't on the issue. Operation is irreversible — obtain explicit user approval before executing. Use this tool instead of LINEAR_UPDATE_ISSUE to avoid replacing the entire label set."
12064 },
12065 {
12066 "slug": "LINEAR_REMOVE_REACTION",
@@ -12080,7 +12080,7 @@
12080 {
12081 "slug": "LINEAR_UPDATE_ISSUE",
12082 "name": "Update issue",
12083 - "description": "Updates an existing Linear issue using its `issue_id`; requires at least one other attribute for modification, and all provided entity IDs (for state, assignee, labels, etc.) must be valid."
12083 + "description": "Updates an existing Linear issue using its `issue_id`; requires at least one other attribute for modification, and all provided entity IDs (for state, assignee, labels, etc.) must be valid UUIDs — only `issueId` accepts key format (e.g., 'ENG-123'). All updated fields are fully overwritten, not merged; omit any field you do not intend to change."
12084 },
12085 {
12086 "slug": "LINEAR_UPDATE_LINEAR_COMMENT",
@@ -12199,7 +12199,7 @@
12199 ],
12200 "toolCount": 25,
12201 "triggerCount": 6,
12202 - "version": "20260312_00",
12202 + "version": "20260316_00",
12203 "tools": [
12204 {
12205 "slug": "AIRTABLE_CREATE_BASE",
@@ -12501,7 +12501,7 @@
12501 ],
12502 "toolCount": 48,
12503 "triggerCount": 0,
12504 - "version": "20260312_00",
12504 + "version": "20260316_00",
12505 "tools": [
12506 {
12507 "slug": "SERPAPI_BAIDU_SEARCH",
@@ -12516,7 +12516,7 @@
12516 {
12517 "slug": "SERPAPI_BING_SEARCH",
12518 "name": "Bing Search",
12519 - "description": "Retrieve Bing Search Engine Results. Supports parameters for query, location, language, and device."
12519 + "description": "Retrieve Bing Search Engine Results via SerpAPI (requires active SerpAPI connection; if unavailable, use COMPOSIO_SEARCH_WEB or COMPOSIO_SEARCH_NEWS). Consumes SerpAPI credits per call; throttle to ~1–2 calls/second and apply exponential backoff on HTTP 429. Supports query, location, language, and device parameters. Set `location`, `mkt`, or `cc` explicitly when local relevance matters — result ranking is highly sensitive to localization."
12520 },
12521 {
12522 "slug": "SERPAPI_DUCK_DUCK_GO_LIGHT_SEARCH",
@@ -12531,12 +12531,12 @@
12531 {
12532 "slug": "SERPAPI_DUCK_DUCK_GO_SEARCH",
12533 "name": "DuckDuckGo search",
12534 - "description": "Performs a DuckDuckGo search via SerpApi to retrieve SERP data, including organic results, ads, and structured information."
12534 + "description": "Performs a DuckDuckGo search via SerpApi to retrieve SERP data, including organic results, ads, and structured information. Requires a valid SerpApi connection configured in Composio. Results may be localized by region by default."
12535 },
12536 {
12537 "slug": "SERPAPI_EBAY_SEARCH",
12538 "name": "eBay Search",
12539 - "description": "Retrieve eBay Search Results. Supports parameters like nkw (query), location, etc. Returns product SERP data in JSON format."
12539 + "description": "Retrieve eBay Search Results via SerpApi (requires active SerpApi connected account). Supports parameters like nkw (query), location, etc. Returns product SERP data in JSON format. Listing prices and fees may be incomplete or inconsistent; verify total cost on the source page before comparing results."
12540 },
12541 {
12542 "slug": "SERPAPI_EVENT_SEARCH",
@@ -12546,7 +12546,7 @@
12546 {
12547 "slug": "SERPAPI_FINANCE_SEARCH",
12548 "name": "Search finance",
12549 - "description": "Retrieves structured financial information (e.g., company data, stock details, market trends, news) from Google Finance via SERP API based on a query."
12549 + "description": "Retrieves structured financial information (e.g., company data, stock details, market trends, news) from Google Finance via SERP API based on a query. Requires active SerpApi credentials. Empty results for delisted, illiquid, or newly listed assets are valid 'no data' responses. High query volumes may trigger HTTP 429 rate limits; apply backoff on retries."
12550 },
12551 {
12552 "slug": "SERPAPI_GET_AVAILABLE_LOCATION_OPTIONS_FOR_GOOGLE_SEARCHES",
@@ -12596,7 +12596,7 @@
12596 {
12597 "slug": "SERPAPI_GOOGLE_JOBS_SEARCH",
12598 "name": "Google Jobs Search",
12599 - "description": "Retrieve Google Jobs Search Results. Supports parameters like q (query), location, etc. Returns job SERP data in JSON format."
12599 + "description": "Retrieve Google Jobs Search Results via SerpApi. Returns job SERP data in JSON; key attributes like `work_from_home`, `posted_at`, `salary`, and `schedule_type` are nested under `detected_extensions` per job object and are often absent — treat as optional. Results may include stale postings; verify recency via `detected_extensions.posted_at`. Supports pagination, location filtering, and remote-job filtering."
12600 },
12601 {
12602 "slug": "SERPAPI_GOOGLE_LENS_SEARCH",
@@ -12606,7 +12606,7 @@
12606 {
12607 "slug": "SERPAPI_GOOGLE_LIGHT_SEARCH",
12608 "name": "Google Light Search",
12609 - "description": "Retrieve Google Light Search Results. Supports parameters like q (query), location, etc. Returns lightweight SERP data in JSON format."
12609 + "description": "Retrieve Google Light Search Results via SerpApi. Requires an active SerpApi connection. Supports q, location, gl, hl, and other SERP parameters. Returns lightweight JSON SERP data; results are in organic_results (handle missing/empty gracefully). Snippets are shallow — follow citation URLs with BROWSER_TOOL_FETCH_WEBPAGE for full content. Rate limit: HTTP 429 under heavy use; keep to ~1–2 requests/sec with exponential backoff on retry."
12610 },
12611 {
12612 "slug": "SERPAPI_GOOGLE_MAPS_POSTS",
@@ -12646,7 +12646,7 @@
12646 {
12647 "slug": "SERPAPI_IMAGE_SEARCH",
12648 "name": "Image search",
12649 - "description": "Searches Google Images via SERP API for a given query, returning structured image results. The number of results can be controlled using the 'num' parameter (1-100). If not specified, it defaults to 20 results."
12649 + "description": "Searches Google Images via SERP API for a given query, returning structured image results. Requires a valid SerpAPI authenticated connection. The number of results can be controlled using the 'num' parameter (1-100). If not specified, it defaults to 20 results."
12650 },
12651 {
12652 "slug": "SERPAPI_NAVER_SEARCH",
@@ -12656,7 +12656,7 @@
12656 {
12657 "slug": "SERPAPI_NEWS_SEARCH",
12658 "name": "Search for news articles",
12659 - "description": "Searches Google News (via SerpApi, using the `tbm=nws` parameter) for articles matching a query; precise queries yield best results."
12659 + "description": "Searches Google News (via SerpApi, `tbm=nws`) for articles matching a query; precise key-phrase queries yield best results. Auth is handled via SerpApi connection — do not pass api_key as a parameter. Results returned under `news_results` field (~10 items/page). Rate-limited: throttle to ~1 req/s; HTTP 429 on bursts — apply exponential backoff (1s, 2s, 4s). Covers news content only; pair with SERPAPI_SEARCH for broader web sources. Headlines/snippets only — use EXA_GET_CONTENTS_ACTION for full article text."
12660 },
12661 {
12662 "slug": "SERPAPI_OPEN_TABLE_REVIEWS",
@@ -12671,12 +12671,12 @@
12671 {
12672 "slug": "SERPAPI_SCHOLAR_SEARCH",
12673 "name": "Search Google Scholar",
12674 - "description": "Searches Google Scholar via SerpApi for academic literature, papers, articles, and citations based on a query."
12674 + "description": "Searches Google Scholar via SerpApi for academic literature, papers, articles, and citations based on a query. Response results may include `inline_links.cited_by` and `resources` (PDF links), but these fields are not guaranteed; check for their existence and type before accessing."
12675 },
12676 {
12677 "slug": "SERPAPI_SEARCH",
12678 "name": "Serp API search",
12679 - "description": "Performs a real-time Google search via the SERP API for a non-empty query."
12679 + "description": "Performs a real-time Google search via the SerpAPI connection (must be active; if unavailable, use COMPOSIO_SEARCH_WEB or other COMPOSIO_SEARCH_* tools). Returns ~10 organic results per page nested under results.organic_results — not a flat list; handle missing/empty arrays. Paginate via start offset or serpapi_pagination.next; max num=100; stop when domains plateau to avoid quota exhaustion. Rate-limited: throttle to 1–2 req/s; HTTP 429 on bursts — apply exponential backoff (1s, 2s, 4s). Derive result rank from array index (absolute rank = start + index; no explicit rank field). Lacks date-bound controls — embed recency terms in query or use SERPAPI_NEWS_SEARCH for time-sensitive queries. Results may include ads and sponsored content; prefer authoritative domains. Use vertical tools (SERPAPI_IMAGE_SEARCH, SERPAPI_NEWS_SEARCH, SERPAPI_YOU_TUBE_SEARCH, SERPAPI_GOOGLE_JOBS_SEARCH) for specialized query types."
12680 },
12681 {
12682 "slug": "SERPAPI_SEARCH_APPLE_APP_STORE",
@@ -12701,12 +12701,12 @@
12701 {
12702 "slug": "SERPAPI_SHOPPING_SEARCH",
12703 "name": "Shopping search",
12704 - "description": "Searches Google Shopping for a specific product or item to retrieve structured product listings."
12704 + "description": "Searches Google Shopping via SerpAPI for a specific product, returning structured listings in results.shopping_results. Requires an active SerpAPI connection. Response fields such as rating, review_count, extracted_price, and extracted_old_price may be absent; null-check before ranking or computing discounts. Discount percentages in listings may reflect aggregate promotional claims, not per-item pricing."
12705 },
12706 {
12707 "slug": "SERPAPI_TRENDS_SEARCH",
12708 "name": "Google Trends search",
12709 - "description": "Fetches Google Trends data; the `query`'s format (single/multiple terms) must comply with the selected `data_type` (see its field description for details)."
12709 + "description": "Fetches Google Trends data; returns relative 0–100 interest indices (not absolute volumes) meaningful only when comparing queries within the same request. The `query`'s format (single/multiple terms) must comply with the selected `data_type`."
12710 },
12711 {
12712 "slug": "SERPAPI_WALMART_PRODUCT_REVIEWS",
@@ -12782,7 +12782,7 @@
12782 ],
12783 "toolCount": 96,
12784 "triggerCount": 3,
12785 - "version": "20260312_00",
12785 + "version": "20260316_00",
12786 "tools": [
12787 {
12788 "slug": "JIRA_ADD_ATTACHMENT",
@@ -12807,7 +12807,7 @@
12807 {
12808 "slug": "JIRA_ADD_WATCHER_TO_ISSUE",
12809 "name": "Add Watcher to Issue",
12810 - "description": "Adds a user to an issue's watcher list by account ID."
12810 + "description": "Adds a user to an issue's watcher list by account ID. Requires the authenticated user to have permission to view the issue and manage watchers; insufficient permissions may result in silent failure or an error response."
12811 },
12812 {
12813 "slug": "JIRA_ANALYSE_EXPRESSION",
@@ -12822,7 +12822,7 @@
12822 {
12823 "slug": "JIRA_BULK_CREATE_ISSUE",
12824 "name": "Bulk Create Issues",
12825 - "description": "Creates multiple Jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling."
12825 + "description": "Creates multiple Jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling. On HTTP 429, honor the Retry-After response header with bounded backoff before retrying."
12826 },
12827 {
12828 "slug": "JIRA_CHECK_PERMISSIONS",
@@ -12837,7 +12837,7 @@
12837 {
12838 "slug": "JIRA_CREATE_ISSUE",
12839 "name": "Create Issue",
12840 - "description": "Creates a new Jira issue (e.g., bug, task, story) in a specified project. IMPORTANT: Different Jira projects may have custom required fields beyond the standard ones (summary, project_key, issue_type). If issue creation fails with 'field X is required', use JIRA_GET_FIELDS to discover available fields for your project, or check your Jira project's configuration. Custom fields can be provided via the 'additional_properties' parameter as a JSON string (e.g., '{\"customfield_12345\": \"value\"}')."
12840 + "description": "Creates a new Jira issue (e.g., bug, task, story) in a specified project. IMPORTANT: Different Jira projects may have custom required fields beyond the standard ones (summary, project_key, issue_type). If issue creation fails with 'field X is required', use JIRA_GET_FIELDS to discover available fields for your project, or check your Jira project's configuration. Custom fields can be provided via the 'additional_properties' parameter as a JSON string (e.g., '{\"customfield_12345\": \"value\"}'). Rapid bulk creation may trigger HTTP 429 rate limiting; throttle calls and use exponential backoff on 429 responses."
12841 },
12842 {
12843 "slug": "JIRA_CREATE_ISSUE_LINK",
@@ -12872,7 +12872,7 @@
12872 {
12873 "slug": "JIRA_DELETE_ISSUE",
12874 "name": "Delete Issue",
12875 - "description": "Deletes a Jira issue by its ID or key."
12875 + "description": "Permanently and irreversibly deletes a Jira issue by its ID or key. Obtain explicit user confirmation before calling."
12876 },
12877 {
12878 "slug": "JIRA_DELETE_VERSION",
@@ -12902,7 +12902,7 @@
12902 {
12903 "slug": "JIRA_FIND_USERS",
12904 "name": "Find Users (Deprecated)",
12905 - "description": "DEPRECATED: Use JIRA_FIND_USERS2 instead. Searches for Jira users by email or display name to find account IDs; essential for assigning issues, adding watchers, and other user-related operations."
12905 + "description": "DEPRECATED: Use JIRA_FIND_USERS2 instead. Searches for Jira users by email or display name to find account IDs; essential for assigning issues, adding watchers, and other user-related operations. Broad queries may return multiple matches — always disambiguate using full email before selecting an account_id. Results may include app/bot accounts; verify account_type is a human user before use in downstream operations."
12906 },
12907 {
12908 "slug": "JIRA_FIND_USERS2",
@@ -12917,7 +12917,7 @@
12917 {
12918 "slug": "JIRA_GET_ALL_GROUPS",
12919 "name": "Get All Groups",
12920 - "description": "Retrieves all groups from the Jira instance with pagination support."
12920 + "description": "Retrieves all groups from the Jira instance with pagination support. Useful for resolving correct group names or IDs before passing them to other tools. Some returned groups are system-managed and may be inaccessible via other group operations. On large instances, omitting both pagination parameters to fetch all groups can be expensive; prefer targeted lookups with max_results and start_at when possible."
12921 },
12922 {
12923 "slug": "JIRA_GET_ALL_ISSUE_TYPE_SCHEMES",
@@ -12927,17 +12927,17 @@
12927 {
12928 "slug": "JIRA_GET_ALL_PROJECTS",
12929 "name": "Get all projects",
12930 - "description": "Retrieves all visible projects using the modern paginated Jira API with server-side filtering and pagination support."
12930 + "description": "Retrieves all visible projects using the modern paginated Jira API with server-side filtering and pagination support. Results reflect only projects the authenticated user can access — small or empty result sets may indicate permission restrictions, not absence of projects. An empty `values` array means no projects matched the filters; relax `query`, `status`, or `categoryId` if unexpected. Project keys are mutable; prefer the stable numeric project ID for durable references in follow-up calls."
12931 },
12932 {
12933 "slug": "JIRA_GET_ALL_STATUSES",
12934 "name": "Get Issue Statuses",
12935 - "description": "Retrieves issue statuses associated with workflows from Jira."
12935 + "description": "Retrieves all issue statuses associated with workflows from Jira. Returns global statuses that may not be valid for every project or workflow scheme; verify a returned status is applicable to the specific project before use."
12936 },
12937 {
12938 "slug": "JIRA_GET_ALL_USERS",
12939 "name": "Get All Users",
12940 - "description": "Retrieves all users from the Jira instance including active, inactive, and other user states with pagination support."
12940 + "description": "Retrieves all users from the Jira instance including active, inactive, app accounts, and system accounts, with pagination support. On Jira Cloud, fields like `email_address` may be redacted due to privacy settings — never treat them as guaranteed present. Successful responses may silently omit users due to permission restrictions; a smaller-than-expected result set may reflect access limits, not absence of users."
12941 },
12942 {
12943 "slug": "JIRA_GET_ATTACHMENT",
@@ -12962,7 +12962,7 @@
12962 {
12963 "slug": "JIRA_GET_CURRENT_USER",
12964 "name": "Get Current User",
12965 - "description": "Retrieves detailed information about the currently authenticated Jira user."
12965 + "description": "Retrieves detailed information about the currently authenticated Jira user. The returned `accountId` is the correct identifier for fields like `lead_account_id` in JIRA_CREATE_PROJECT, JIRA_ADD_WATCHER_TO_ISSUE, and JIRA_REMOVE_WATCHER_FROM_ISSUE — never use email or username in those fields."
12966 },
12967 {
12968 "slug": "JIRA_GET_DASHBOARDS",
@@ -12977,7 +12977,7 @@
12977 {
12978 "slug": "JIRA_GET_FIELDS",
12979 "name": "Get fields",
12980 - "description": "Tool to retrieve Jira issue fields metadata. Use before editing an issue to discover custom field IDs and names."
12980 + "description": "Tool to retrieve Jira issue fields metadata. Use before editing an issue to discover custom field IDs and names. Custom fields are addressed as customfield_XXXXX in API calls and cf[XXXXX] in JQL; using display names instead causes 400 Unknown field errors. Returns global metadata — cross-reference with JIRA_GET_ISSUE_EDIT_META before editing, as globally visible fields not listed there will also cause 400 errors when sent to JIRA_EDIT_ISSUE. Results are scoped to the authenticated user's permissions, so field sets may differ between users."
12981 },
12982 {
12983 "slug": "JIRA_GET_FIELDS_PAGINATED",
@@ -12992,7 +12992,7 @@
12992 {
12993 "slug": "JIRA_GET_GROUP",
12994 "name": "Get Group",
12995 - "description": "Retrieves details of a specific Jira group by name or ID."
12995 + "description": "Retrieves details of a specific Jira group by name or ID. Use JIRA_GET_ALL_GROUPS to discover valid group names/IDs first. Some system-managed groups may be inaccessible due to permission restrictions even when name/ID is known."
12996 },
12997 {
12998 "slug": "JIRA_GET_INFO",
@@ -13002,7 +13002,7 @@
13002 {
13003 "slug": "JIRA_GET_ISSUE",
13004 "name": "Get Issue",
13005 - "description": "Retrieves a Jira issue by ID or key with customizable fields and expansions."
13005 + "description": "Retrieves a Jira issue by ID or key with customizable fields and expansions. Request only needed fields and expansions to avoid large responses. Use specific `customfield_*` keys in `fields` to verify updated values programmatically."
13006 },
13007 {
13008 "slug": "JIRA_GET_ISSUE_CREATE_METADATA",
@@ -13037,7 +13037,7 @@
13037 {
13038 "slug": "JIRA_GET_ISSUE_TYPES",
13039 "name": "Get issue types",
13040 - "description": "Retrieves all Jira issue types available to the user using the modern API v3 endpoint; results vary based on 'Administer Jira' global or 'Browse projects' project permissions."
13040 + "description": "Retrieves all Jira issue types available to the user using the modern API v3 endpoint; results vary based on 'Administer Jira' global or 'Browse projects' project permissions. Response includes two shapes: global issue types (no scope field) and project-scoped types (include scope.project.id); deduplicate by id, not name. Always use issuetype.id (not display name) when referencing issue types in other API calls to avoid validation errors."
13041 },
13042 {
13043 "slug": "JIRA_GET_ISSUE_TYPE_SCHEME",
@@ -13047,7 +13047,7 @@
13047 {
13048 "slug": "JIRA_GET_ISSUE_WATCHERS",
13049 "name": "Get Issue Watchers",
13050 - "description": "Retrieves users watching a Jira issue for update notifications."
13050 + "description": "Retrieves users watching a Jira issue for update notifications. Watcher data access may be restricted by Jira permissions. Returns all watchers; filter client-side by `accountId` to check if a specific user is watching."
13051 },
13052 {
13053 "slug": "JIRA_GET_ISSUE_WORKLOGS",
@@ -13092,7 +13092,7 @@
13092 {
13093 "slug": "JIRA_GET_PROJECT_ROLES",
13094 "name": "Get Project Roles",
13095 - "description": "Retrieves all available roles for a Jira project."
13095 + "description": "Retrieves all available roles for a Jira project. Role IDs are project-specific and must not be reused across projects; call this action per project to obtain correct role IDs."
13096 },
13097 {
13098 "slug": "JIRA_GET_PROJECT_TYPE",
@@ -13102,7 +13102,7 @@
13102 {
13103 "slug": "JIRA_GET_PROJECT_VERSIONS",
13104 "name": "Get Project Versions",
13105 - "description": "Retrieves all versions for a Jira project with optional expansion."
13105 + "description": "Retrieves all versions for a Jira project with optional expansion. Use version IDs from the response (not names) when setting fixVersions or affectedVersions on issues — submitting names alone causes 400 validation errors."
13106 },
13107 {
13108 "slug": "JIRA_GET_RECENT_PROJECTS",
@@ -13132,7 +13132,7 @@
13132 {
13133 "slug": "JIRA_GET_TRANSITIONS",
13134 "name": "Get Transitions",
13135 - "description": "Retrieves available workflow transitions for a Jira issue."
13135 + "description": "Retrieves available workflow transitions for a Jira issue. Always use the numeric `id` from the response when calling JIRA_TRANSITION_ISSUE — transition IDs are project/workflow-specific and must not be hardcoded or reused across different issues or projects. When multiple transitions share similar names, use `id` to disambiguate."
13136 },
13137 {
13138 "slug": "JIRA_GET_UNIVERSAL_AVATAR_TYPE_OWNER",
@@ -13167,7 +13167,7 @@
13167 {
13168 "slug": "JIRA_LIST_BOARDS",
13169 "name": "List Boards",
13170 - "description": "Retrieves paginated Jira boards with filtering and sorting options."
13170 + "description": "Retrieves paginated Jira boards with filtering and sorting options. Use `start_at` and `max_results` together, looping through pages to retrieve all results."
13171 },
13172 {
13173 "slug": "JIRA_LIST_COMMENTS",
@@ -13187,7 +13187,7 @@
13187 {
13188 "slug": "JIRA_LIST_ISSUE_COMMENTS",
13189 "name": "List Issue Comments",
13190 - "description": "Retrieves paginated comments from a Jira issue with optional ordering."
13190 + "description": "Retrieves paginated comments from a Jira issue with optional ordering. Paginate by incrementing `start_at` by `max_results` until the cumulative count reaches the `total` field in the response. A response with `total=0` and an empty comments array means the issue has no comments."
13191 },
13192 {
13193 "slug": "JIRA_LIST_PROJECT_TYPES",
@@ -13212,7 +13212,7 @@
13212 {
13213 "slug": "JIRA_REMOVE_USER_FROM_GROUP",
13214 "name": "Remove User from Group",
13215 - "description": "Removes a user from a Jira group."
13215 + "description": "Removes a user from a Jira group. This is a destructive operation that revokes group-based permissions; confirm intent before calling."
13216 },
13217 {
13218 "slug": "JIRA_REMOVE_USER_FROM_PROJECT_ROLE",
@@ -13242,12 +13242,12 @@
13242 {
13243 "slug": "JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST",
13244 "name": "Search Issues Using JQL Enhanced (POST)",
13245 - "description": "Searches for Jira Cloud issues using Enhanced JQL via POST request; supports eventual consistency and token-based pagination. IMPORTANT: This action is for Jira Cloud only and will not work with Jira Server or Data Center instances."
13245 + "description": "Searches for Jira Cloud issues using Enhanced JQL via POST request; supports eventual consistency and token-based pagination. Use this POST endpoint for long/complex JQL to avoid HTTP 414 errors on GET-based search. IMPORTANT: This action is for Jira Cloud only and will not work with Jira Server or Data Center instances."
13246 },
13247 {
13248 "slug": "JIRA_SEARCH_ISSUES",
13249 "name": "Search issues",
13250 - "description": "Advanced Jira issue search supporting structured filters and raw JQL."
13250 + "description": "Advanced Jira issue search supporting structured filters and raw JQL. At least one filter parameter (e.g., jql, project_key, updated_after) is required; calls with no parameters will be rejected."
13251 },
13252 {
13253 "slug": "JIRA_SEND_NOTIFICATION_FOR_ISSUE",
@@ -13353,7 +13353,7 @@
13353 ],
13354 "toolCount": 30,
13355 "triggerCount": 0,
13356 - "version": "20260312_00",
13356 + "version": "20260316_00",
13357 "tools": [
13358 {
13359 "slug": "FIRECRAWL_AGENT_CANCEL",
@@ -13433,7 +13433,7 @@
13433 {
13434 "slug": "FIRECRAWL_DEEP_RESEARCH",
13435 "name": "Perform deep research",
13436 - "description": "Initiates an AI-powered deep research operation that autonomously explores the web to investigate any topic and synthesizes findings from multiple sources. The research process iteratively searches, analyzes, and synthesizes information across multiple web sources, providing comprehensive insights with source citations. Results include a final analysis, detailed activity timeline, and curated source list. Billing: 1 credit per URL analyzed. Control costs with the maxUrls parameter. Note: This API is in Alpha and being deprecated in favor of the Search API after June 30, 2025."
13436 + "description": "Initiates an AI-powered deep research operation that autonomously explores the web to investigate any topic and synthesizes findings from multiple sources. Requires an active Firecrawl connection. The research process iteratively searches, analyzes, and synthesizes information across multiple web sources, providing comprehensive insights with source citations. Results include a final analysis, detailed activity timeline, and curated source list. Billing: 1 credit per URL analyzed. Control costs with the maxUrls parameter. Note: This API is in Alpha and being deprecated after June 30, 2025; prefer FIRECRAWL_SEARCH + FIRECRAWL_EXTRACT or COMPOSIO_SEARCH_WEB for durable workflows. Reserve this tool for cases requiring synthesized multi-source analysis — it is slower and more resource-intensive than FIRECRAWL_SEARCH."
13437 },
13438 {
13439 "slug": "FIRECRAWL_EXTRACT",
@@ -13552,7 +13552,7 @@
13552 ],
13553 "toolCount": 5,
13554 "triggerCount": 0,
13555 - "version": "20260223_00",
13555 + "version": "20260316_00",
13556 "tools": [
13557 {
13558 "slug": "TAVILY_CRAWL",
@@ -13577,7 +13577,7 @@
13577 {
13578 "slug": "TAVILY_SEARCH",
13579 "name": "Tavily search",
13580 - "description": "Use this to perform a web search via the Tavily API; offers controls for search depth, content types, result count, and domain filtering."
13580 + "description": "Use this to perform a web search via the Tavily API; offers controls for search depth, content types, result count, and domain filtering. Requires an active Tavily connection (401 = auth failure). Rate limit: ~2 req/s; apply exponential backoff on HTTP 429. Results are nested under response_data.results (not a flat list). Subject to HTTP 429 on rapid bursts."
13581 }
13582 ],
13583 "triggers": [],
@@ -13966,7 +13966,7 @@
13966 ],
13967 "toolCount": 87,
13968 "triggerCount": 9,
13969 - "version": "20260312_00",
13969 + "version": "20260316_00",
13970 "tools": [
13971 {
13972 "slug": "SLACKBOT_ADD_CALL_PARTICIPANTS",
@@ -14006,7 +14006,7 @@
14006 {
14007 "slug": "SLACKBOT_CREATE_CHANNEL",
14008 "name": "Create channel",
14009 - "description": "Initiates a public or private channel-based conversation"
14009 + "description": "Initiates a public or private channel-based conversation in a Slack workspace. Immediately creates the channel; invoke only after explicit user confirmation."
14010 },
14011 {
14012 "slug": "SLACKBOT_CREATE_USER_GROUP",
@@ -14021,7 +14021,7 @@
14021 {
14022 "slug": "SLACKBOT_DELETE_CANVAS",
14023 "name": "Delete Slack Canvas",
14024 - "description": "Deletes a Slack Canvas permanently."
14024 + "description": "Deletes a Slack Canvas permanently and irreversibly. Always confirm with the user before calling this tool."
14025 },
14026 {
14027 "slug": "SLACKBOT_DELETE_FILE",
@@ -14066,7 +14066,7 @@
14066 {
14067 "slug": "SLACKBOT_ENABLE_PUBLIC_SHARING_OF_A_FILE",
14068 "name": "Share file public url",
14069 - "description": "Enables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files."
14069 + "description": "Enables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files. Once enabled, the file is accessible to anyone with the URL — verify intent before sharing sensitive or confidential files."
14070 },
14071 {
14072 "slug": "SLACKBOT_ENABLE_USER_GROUP",
@@ -14086,7 +14086,7 @@
14086 {
14087 "slug": "SLACKBOT_FETCH_ITEM_REACTIONS",
14088 "name": "Fetch item reactions",
14089 - "description": "Fetches reactions for a Slack message, file, or file comment, requiring one of: channel and timestamp; file ID; or file comment ID."
14089 + "description": "Fetches reactions for a Slack message, file, or file comment. Exactly one identifier path must be provided: `channel`+`timestamp`, `file`, or `file_comment`. Mixing identifiers (e.g., providing both `channel`+`timestamp` and `file`) causes errors. If the response omits the `reactions` field, the item has zero reactions."
14090 },
14091 {
14092 "slug": "SLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION",
@@ -14101,17 +14101,17 @@
14101 {
14102 "slug": "SLACKBOT_FIND_CHANNELS",
14103 "name": "Find channels",
14104 - "description": "Find channels in a Slack workspace by any criteria - name, topic, purpose, or description. NOTE: This action can only search channels visible to the bot. Empty results may indicate: - No channels match the search query in name, topic, or purpose - The target channel is private and the bot hasn't been invited - The bot lacks required scopes (channels:read, groups:read) Check 'composio_execution_message' and 'total_channels_searched' in the response for details."
14104 + "description": "Find channels in a Slack workspace by any criteria - name, topic, purpose, or description. Returns channel IDs (C*/G* prefixed) required by most Slack tools — always resolve names to IDs here before passing to other tools. NOTE: This action can only search channels visible to the bot. Empty results may indicate: - No channels match the search query in name, topic, or purpose - The target channel is private and the bot hasn't been invited - The bot lacks required scopes (channels:read, groups:read). If empty, retry with exact_match=false or exclude_archived=false to avoid false negatives. In large workspaces, paginate using next_cursor to avoid missing matches. Check 'composio_execution_message' and 'total_channels_searched' in the response for details."
14105 },
14106 {
14107 "slug": "SLACKBOT_FIND_USER_BY_EMAIL_ADDRESS",
14108 "name": "Lookup users by email (Deprecated)",
14109 - "description": "DEPRECATED: Use FindUsers instead. Retrieves the Slack user object for an active user by their registered email address; fails with 'users_not_found' if the email is unregistered or the user is inactive."
14109 + "description": "DEPRECATED: Use FindUsers instead. Retrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with 'users_not_found' if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings."
14110 },
14111 {
14112 "slug": "SLACKBOT_FIND_USERS",
14113 "name": "Find users",
14114 - "description": "Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches."
14114 + "description": "Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches. Zero results may reflect email visibility restrictions or workspace policies, not global absence. Repeated calls may trigger HTTP 429; honor the Retry-After header."
14115 },
14116 {
14117 "slug": "SLACKBOT_GET_BOT_USER",
@@ -14136,7 +14136,7 @@
14136 {
14137 "slug": "SLACKBOT_GET_REMOTE_FILE",
14138 "name": "Get remote file",
14139 - "description": "Retrieve information about a remote file added to Slack."
14139 + "description": "Retrieve information about a remote file added to Slack via the files.remote API. Does not work for standard Slack-hosted file uploads."
14140 },
14141 {
14142 "slug": "SLACKBOT_GET_TEAM_PROFILE",
@@ -14156,12 +14156,12 @@
14156 {
14157 "slug": "SLACKBOT_INVITE_USERS_TO_A_CHANNEL",
14158 "name": "Invite users to a Slack channel",
14159 - "description": "Invites users to an existing Slack channel using their valid Slack User IDs."
14159 + "description": "Invites users to an existing Slack channel using their valid Slack User IDs. Response is always HTTP 200; inspect `ok`, `error`, and `errors` fields to confirm users were added."
14160 },
14161 {
14162 "slug": "SLACKBOT_JOIN_AN_EXISTING_CONVERSATION",
14163 "name": "Join conversation by channel id",
14164 - "description": "Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission."
14164 + "description": "Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission. Joining an already-joined channel returns a non-fatal no-op response. Private or restricted channel joins may fail with a permission error."
14165 },
14166 {
14167 "slug": "SLACKBOT_LEAVE_CONVERSATION",
@@ -14171,22 +14171,22 @@
14171 {
14172 "slug": "SLACKBOT_LIST_ALL_CHANNELS",
14173 "name": "List all channels",
14174 - "description": "Lists conversations available to the user with various filters and search options."
14174 + "description": "Lists conversations available to the user with various filters and search options. Always use resolved `channel_id` (not display names) for downstream operations, as names may be non-unique. The `created` field in results is a Unix epoch timestamp (UTC). Pagination across large workspaces may return HTTP 429 with a `Retry-After` header; honor the delay and resume from the last successful cursor."
14175 },
14176 {
14177 "slug": "SLACKBOT_LIST_ALL_USERS",
14178 "name": "List all users",
14179 - "description": "Retrieves a paginated list of all users, including comprehensive details, profile information, status, and team memberships, in a Slack workspace; data may not be real-time."
14179 + "description": "Retrieves a paginated list of all users with profile details, status, and team memberships in a Slack workspace; data may not be real-time. Filter response fields `is_bot`, `is_app_user`, and `deleted` to build human-only rosters. Profile fields like `email` and `phone` may be absent depending on OAuth scopes and workspace privacy settings. Guest/restricted accounts may be omitted based on scopes—do not treat results as a complete directory. High-frequency calls risk HTTP 429; honor the `Retry-After` header and throttle to ~1–2 requests/second. Use stable user IDs rather than display names for mapping. Prefer SLACK_FIND_USERS for targeted lookups; cache results to avoid full-workspace fetches."
14180 },
14181 {
14182 "slug": "SLACKBOT_LIST_CANVASES",
14183 "name": "List Slack Canvases",
14184 - "description": "Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter. Known limitations: - The 'user' filter may return canvases accessible to the specified user, not just canvases they created. This is a known behavior of the Slack files.list API with canvas types. - The 'ts_from' and 'ts_to' timestamp filters may not work reliably for canvas types. Consider using client-side filtering on the 'created' field in the response if precise date filtering is required."
14184 + "description": "Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter. Only canvases accessible to the authenticated app are returned; missing canvases indicate permissions restrictions, not empty data. Use `paging.pages` in the response to determine total pages; iterate `page` with `count` to retrieve all results. Known limitations: - The 'user' filter may return canvases accessible to the specified user, not just canvases they created. - The 'ts_from' and 'ts_to' timestamp filters may not work reliably for canvas types. Consider client-side filtering on the 'created' field in the response if precise date filtering is required."
14185 },
14186 {
14187 "slug": "SLACKBOT_LIST_CONVERSATIONS",
14188 "name": "List conversations",
14189 - "description": "List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels."
14189 + "description": "List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels. Returns conversation IDs (C* for channels, G* for group DMs), not display names. Absence of private channels, DMs, or MPIMs from results indicates token scope or membership limits, not that the conversation is nonexistent."
14190 },
14191 {
14192 "slug": "SLACKBOT_LIST_CUSTOM_EMOJIS",
@@ -14196,7 +14196,7 @@
14196 {
14197 "slug": "SLACKBOT_LIST_FILES_WITH_FILTERS_IN_SLACK",
14198 "name": "List Slack files",
14199 - "description": "Lists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; this action returns metadata only, not file content."
14199 + "description": "Lists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; returns metadata only, not file content. Results are limited to files visible to the authenticated user — files in private channels or restricted to certain members require appropriate membership and permissions. For large workspaces, check `paging.pages` in the response to determine total pages when paginating."
14200 },
14201 {
14202 "slug": "SLACKBOT_LIST_PINNED_ITEMS",
@@ -14206,7 +14206,7 @@
14206 {
14207 "slug": "SLACKBOT_LIST_REMINDERS",
14208 "name": "List reminders",
14209 - "description": "Lists all reminders with their details for the authenticated Slack user; returns an empty list if no reminders exist."
14209 + "description": "Lists all reminders with their details for the authenticated Slack user; returns an empty array if no reminders exist (valid state, not an error). Reminder text is not unique—perform client-side matching on returned objects before extracting a reminder ID for use with SLACK_MARK_REMINDER_AS_COMPLETE or SLACK_DELETE_A_SLACK_REMINDER."
14210 },
14211 {
14212 "slug": "SLACKBOT_LIST_REMOTE_FILES",
@@ -14226,7 +14226,7 @@
14226 {
14227 "slug": "SLACKBOT_LIST_USER_REACTIONS",
14228 "name": "List user reactions",
14229 - "description": "Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required."
14229 + "description": "Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required. Results are paginated; check `response_metadata.next_cursor` and iterate with the `cursor` parameter to retrieve complete reaction history."
14230 },
14231 {
14232 "slug": "SLACKBOT_LOOKUP_CANVAS_SECTIONS",
@@ -14241,7 +14241,7 @@
14241 {
14242 "slug": "SLACKBOT_OPEN_DM",
14243 "name": "Open DM",
14244 - "description": "Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID."
14244 + "description": "Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID. Returns `already_open=true` when the DM exists — treat as success and reuse the returned `channel.id` (starts with 'D') for subsequent SLACK_SEND_MESSAGE calls; passing a username, email, or user ID directly to SLACK_SEND_MESSAGE causes `channel_not_found`. Avoid redundant calls when an existing DM channel ID is available."
14245 },
14246 {
14247 "slug": "SLACKBOT_PIN_ITEM",
@@ -14256,7 +14256,7 @@
14256 {
14257 "slug": "SLACKBOT_REMOVE_REACTION_FROM_ITEM",
14258 "name": "Remove reaction from item",
14259 - "description": "Removes an emoji reaction from a message, file, or file comment in Slack."
14259 + "description": "Removes an emoji reaction from a message, file, or file comment in Slack. Provide exactly one targeting method: channel+timestamp together, file, or file_comment. Mixing methods or omitting all returns invalid_arguments."
14260 },
14261 {
14262 "slug": "SLACKBOT_REMOVE_REMOTE_FILE",
@@ -14276,12 +14276,12 @@
14276 {
14277 "slug": "SLACKBOT_RETRIEVE_CONVERSATION_INFORMATION",
14278 "name": "Retrieve conversation information",
14279 - "description": "Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content; requires a valid channel ID."
14279 + "description": "Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content. The `channel` parameter is effectively required. Private channels, DMs, or channels where the app lacks membership may return restricted data; check `is_archived` and `is_member` fields in the response to diagnose access issues. Bulk lookups may trigger HTTP 429 rate limiting; honor the `Retry-After` response header."
14280 },
14281 {
14282 "slug": "SLACKBOT_RETRIEVE_CONVERSATION_MEMBERS_LIST",
14283 "name": "Get conversation members",
14284 - "description": "Retrieves a paginated list of active member IDs for a specified Slack public channel, private channel, direct message (DM), or multi-person direct message (MPIM)."
14284 + "description": "Retrieves a paginated list of active member IDs (not names, emails, or presence) for a specified Slack public channel, private channel, DM, or MPIM. Returns only user IDs; use a user-lookup tool to enrich member data."
14285 },
14286 {
14287 "slug": "SLACKBOT_RETRIEVE_CURRENT_USER_DND_STATUS",
@@ -14296,12 +14296,12 @@
14296 {
14297 "slug": "SLACKBOT_RETRIEVE_DETAILED_USER_INFORMATION",
14298 "name": "Retrieve detailed user information",
14299 - "description": "Retrieves comprehensive information for a valid Slack user ID, excluding message history and channel memberships."
14299 + "description": "Retrieves comprehensive information for a valid Slack user ID, excluding message history and channel memberships. Sensitive fields like `email` and `phone` require the `users:read.email` scope and may be silently omitted based on workspace privacy policies."
14300 },
14301 {
14302 "slug": "SLACKBOT_RETRIEVE_USER_PROFILE_INFORMATION",
14303 "name": "Retrieve user profile information",
14304 - "description": "Retrieves profile information for a specified Slack user (defaults to the authenticated user if `user` ID is omitted); a provided `user` ID must be valid."
14304 + "description": "Retrieves profile information for a specified Slack user (defaults to the authenticated user if `user` ID is omitted); a provided `user` ID must be valid. Sensitive fields like email and phone may be silently omitted if required scopes (e.g., `users:read.email`) are not granted or workspace privacy policies restrict access."
14305 },
14306 {
14307 "slug": "SLACKBOT_REVOKE_FILE_PUBLIC_SHARING",
@@ -14316,7 +14316,7 @@
14316 {
14317 "slug": "SLACKBOT_SEND_EPHEMERAL_MESSAGE",
14318 "name": "Send ephemeral message",
14319 - "description": "Sends an ephemeral message to a user in a channel."
14319 + "description": "Sends an ephemeral message visible only to the specified `user` in a channel; other channel members cannot see it. Both the bot and the target user must be members of the specified channel."
14320 },
14321 {
14322 "slug": "SLACKBOT_SEND_ME_MESSAGE",
@@ -14326,7 +14326,7 @@
14326 {
14327 "slug": "SLACKBOT_SEND_MESSAGE",
14328 "name": "Send message",
14329 - "description": "Posts a message to a Slack channel, direct message, or private group; requires content via `text`, `blocks`, or `attachments`."
14329 + "description": "Posts a message to a Slack channel, DM, or private group; requires at least one content field (`markdown_text`, `text`, `blocks`, or `attachments`) — omitting all causes a `no_text` error. Fails with `not_in_channel`, `channel_not_found`, or `channel_is_archived` if the bot lacks access. Body limit ~4000 characters. Rate-limited at ~1 req/sec (HTTP 429, honor `Retry-After`). Not idempotent — duplicate calls post duplicate messages."
14330 },
14331 {
14332 "slug": "SLACKBOT_SET_CONVERSATION_PURPOSE",
@@ -14401,7 +14401,7 @@
14401 {
14402 "slug": "SLACKBOT_UPLOAD_OR_CREATE_A_FILE_IN_SLACK",
14403 "name": "Upload or create a file in Slack",
14404 - "description": "Upload files, images, screenshots, documents, or any media to Slack channels or threads. Supports all file types including images (PNG, JPG, JPEG, GIF), documents (PDF, DOCX, TXT), code files, and more. Can share files publicly in channels or as thread replies with optional comments."
14404 + "description": "Upload files, images, screenshots, documents, or any media to Slack channels or threads. Supports all file types including images (PNG, JPG, JPEG, GIF), documents (PDF, DOCX, TXT), code files, and more. Can share files publicly in channels or as thread replies with optional comments. Large files may fail with `upload_too_large`; use SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE for large uploads. If the API returns `ok=false` with `method_deprecated`, fall back to SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE or SLACK_SEND_MESSAGE with a URL."
14405 }
14406 ],
14407 "triggers": [
@@ -14522,7 +14522,7 @@
14522 ],
14523 "toolCount": 566,
14524 "triggerCount": 6,
14525 - "version": "20260312_00",
14525 + "version": "20260316_00",
14526 "tools": [
14527 {
14528 "slug": "CANVAS_ABORT_QUIZ_REPORT_GENERATION",
@@ -14672,7 +14672,7 @@
14672 {
14673 "slug": "CANVAS_CREATE_COURSE",
14674 "name": "Create a course",
14675 - "description": "Creates a new course in Canvas within a specified account, with comprehensive configuration options."
14675 + "description": "Creates a new course in Canvas within a specified account, with comprehensive configuration options. Returns a course object including `id` (course_id); retain this for subsequent module, page, and upload calls."
14676 },
14677 {
14678 "slug": "CANVAS_CREATE_COURSE_GRADING_STANDARD",
@@ -15187,7 +15187,7 @@
15187 {
15188 "slug": "CANVAS_GET_ACCOUNTS",
15189 "name": "List Canvas accounts",
15190 - "description": "Retrieves Canvas accounts accessible to the authenticated user (typically only account administrators receive non-empty results; students and teachers usually get empty lists)."
15190 + "description": "Retrieves Canvas accounts accessible to the authenticated user (typically only account administrators receive non-empty results; students and teachers usually get empty lists). If empty, infer a valid account_id via CANVAS_LIST_COURSES instead. Returned account_id values are commonly required inputs for CANVAS_CREATE_COURSE, module, page, and upload operations."
15191 },
15192 {
15193 "slug": "CANVAS_GET_ACCOUNTS_OUTCOME_GROUPS",
@@ -15222,7 +15222,7 @@
15222 {
15223 "slug": "CANVAS_GET_ALL_ASSIGNMENTS",
15224 "name": "Get assignments for a specific course (requires course_id)",
15225 - "description": "Retrieves assignments for a specific Canvas course. IMPORTANT: This action requires a course_id parameter - it does NOT retrieve assignments globally across all courses. You must first obtain a valid course_id (e.g., from CANVAS_LIST_COURSES) and provide it to retrieve that course's assignments."
15225 + "description": "Retrieves assignments for a specific Canvas course. IMPORTANT: This action requires a course_id parameter - it does NOT retrieve assignments globally across all courses. You must first obtain a valid course_id (e.g., from CANVAS_LIST_COURSES) and provide it to retrieve that course's assignments. Results may be nested under a `response_data` array; inspect the JSON structure before iterating. `due_at` values are ISO 8601 strings in UTC. Filter on `published`, `locked_for_user`, and `has_submitted_submissions` fields to identify actionable assignments."
15226 },
15227 {
15228 "slug": "CANVAS_GET_ALL_E_PORTFOLIOS_FOR_USER",
@@ -15737,7 +15737,7 @@
15737 {
15738 "slug": "CANVAS_GET_SINGLE_COURSE",
15739 "name": "Get a single course",
15740 - "description": "Retrieves detailed information for a specific Canvas course using its `course_id`, which must be valid, and allows for including additional data fields in the response via the `include` parameter."
15740 + "description": "Retrieves detailed information for a specific Canvas course using its `course_id`, which must be valid, and allows for including additional data fields in the response via the `include` parameter. Concluded or unpublished courses may have restricted visibility depending on the caller's role; include 'concluded' in `include` to retrieve richer metadata for such courses."
15741 },
15742 {
15743 "slug": "CANVAS_GET_SINGLE_EXTERNAL_TOOL",
@@ -15812,7 +15812,7 @@
15812 {
15813 "slug": "CANVAS_GET_SUBMISSION_FILES",
15814 "name": "Get submission files",
15815 - "description": "Retrieves files from a student's Canvas assignment submission, processing text, binary, and ZIP files, and providing S3 download URLs if S3 integration is active and uploads are successful."
15815 + "description": "Retrieves files from a student's Canvas assignment submission, processing text, binary, and ZIP files, and providing S3 download URLs if S3 integration is active and uploads are successful. S3 URLs are short-lived signed URLs; use them immediately and do not cache for later."
15816 },
15817 {
15818 "slug": "CANVAS_GET_SUBMISSION_SUMMARY",
@@ -15922,7 +15922,7 @@
15922 {
15923 "slug": "CANVAS_GRADE_COMMENT_SUBMISSION",
15924 "name": "Grade or comment on a submission",
15925 - "description": "Updates a student's assignment submission with a grade, comment, sticker, or status change; requires `course_id`, `assignment_id`, `user_id`, and at least one update field."
15925 + "description": "Updates a student's assignment submission with a grade, comment, sticker, or status change; requires `course_id`, `assignment_id`, `user_id`, and at least one update field. Rubric assessments are not supported and require a separate Canvas API call."
15926 },
15927 {
15928 "slug": "CANVAS_GRADE_OR_COMMENT_ON_SUBMISSION_SECTIONS",
@@ -16092,7 +16092,7 @@
16092 {
16093 "slug": "CANVAS_LIST_CALENDAR_EVENTS_FOR_USER",
16094 "name": "List calendar events for a user",
16095 - "description": "Retrieves calendar events and assignments for a specific user from Canvas LMS, supporting extensive filtering options detailed in the request schema."
16095 + "description": "Retrieves calendar events and assignments for a specific user from Canvas LMS, supporting extensive filtering options detailed in the request schema. Returned due_at values are ISO 8601 UTC; convert to user's local timezone before display. For pending task identification, exclude items where locked_for_user is true or has_submitted_submissions is true. Results may be incomplete even when assignments exist; do not use as the sole source for pending task lists."
16096 },
16097 {
16098 "slug": "CANVAS_LIST_CANVAS_ENABLED_FEATURES3",
@@ -16172,7 +16172,7 @@
16172 {
16173 "slug": "CANVAS_LIST_COURSES",
16174 "name": "List courses",
16175 - "description": "Retrieves a list of the current user's courses from Canvas, optionally filtered by enrollment type and state."
16175 + "description": "Retrieves a list of the current user's courses from Canvas, optionally filtered by enrollment type and state. Excessive request frequency may return HTTP 429; respect the Retry-After header before retrying."
16176 },
16177 {
16178 "slug": "CANVAS_LIST_COURSE_SECTIONS",
@@ -16497,7 +16497,7 @@
16497 {
16498 "slug": "CANVAS_LIST_PAGES_FOR_COURSE",
16499 "name": "List pages for a course",
16500 - "description": "Retrieves a list of wiki pages associated with a specific, existing course in Canvas."
16500 + "description": "Retrieves a list of wiki pages associated with a specific, existing course in Canvas. Supports pagination via `page` and `per_page` query parameters for courses with many pages."
16501 },
16502 {
16503 "slug": "CANVAS_LIST_PAGES_FOR_GROUP",
@@ -17491,7 +17491,7 @@
17491 ],
17492 "toolCount": 104,
17493 "triggerCount": 0,
17494 - "version": "20260312_00",
17494 + "version": "20260316_00",
17495 "tools": [
17496 {
17497 "slug": "BITBUCKET_APPROVE_PULL_REQUEST",
@@ -17931,7 +17931,7 @@
17931 {
17932 "slug": "BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE",
17933 "name": "List repositories in workspace",
17934 - "description": "Lists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results."
17934 + "description": "Lists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results. Responses are paginated; iterate using the `next` field in each response until it is absent to retrieve all repositories."
17935 },
17936 {
17937 "slug": "BITBUCKET_LIST_REPOSITORY_PATHS",
@@ -17966,7 +17966,7 @@
17966 {
17967 "slug": "BITBUCKET_LIST_WORKSPACES",
17968 "name": "List workspaces",
17969 - "description": "Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted."
17969 + "description": "Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted. Results are paginated; follow the `next` field in each response to retrieve subsequent pages until `next` is absent. When multiple workspaces are returned, verify the correct `slug` or UUID before passing to downstream tools."
17970 },
17971 {
17972 "slug": "BITBUCKET_REQUEST_PULL_REQUEST_CHANGES",
@@ -18080,7 +18080,7 @@
18080 ],
18081 "toolCount": 18,
18082 "triggerCount": 5,
18083 - "version": "20260312_00",
18083 + "version": "20260316_00",
18084 "tools": [
18085 {
18086 "slug": "GOOGLETASKS_BATCH_EXECUTE",
@@ -18095,27 +18095,27 @@
18095 {
18096 "slug": "GOOGLETASKS_CLEAR_TASKS",
18097 "name": "Clear tasks",
18098 - "description": "Permanently clears all completed tasks from a specified Google Tasks list; this action is destructive and idempotent."
18098 + "description": "Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone. Always require explicit user confirmation before invoking."
18099 },
18100 {
18101 "slug": "GOOGLETASKS_CREATE_TASK_LIST",
18102 "name": "Create a task list",
18103 - "description": "Creates a new task list with the specified title."
18103 + "description": "Creates a new task list with the specified title and returns a tasklist_id. Use the returned tasklist_id (not the title) when calling GOOGLETASKS_INSERT_TASK or other task operations. Duplicate titles are permitted by the API, so verify existing lists before creating to avoid unintended duplicates."
18104 },
18105 {
18106 "slug": "GOOGLETASKS_DELETE_TASK",
18107 "name": "Delete task",
18108 - "description": "Deletes a specified task from a Google Tasks list. Both tasklist_id and task_id are required parameters. Important: The Google Tasks API does not support deleting tasks by task_id alone - you must specify which task list contains the task. Use 'List Task Lists' to get available list IDs, then 'List Tasks' to find the task_id within that list."
18108 + "description": "Deletes a specified task from a Google Tasks list. Deletion is permanent and irreversible — confirm with the user before executing, and consider GOOGLETASKS_UPDATE_TASK or GOOGLETASKS_MOVE_TASK as non-destructive alternatives. Both tasklist_id and task_id are required parameters. The Google Tasks API does not support deleting tasks by task_id alone — you must specify which task list contains the task. Use 'List Task Lists' to get available list IDs, then 'List Tasks' to find the task_id within that list."
18109 },
18110 {
18111 "slug": "GOOGLETASKS_DELETE_TASK_LIST",
18112 "name": "Delete task list",
18113 - "description": "Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible."
18113 + "description": "Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible. Require explicit user confirmation before calling; do not invoke in read-only or exploratory flows."
18114 },
18115 {
18116 "slug": "GOOGLETASKS_GET_TASK",
18117 "name": "Get Task",
18118 - "description": "Retrieve a specific Google Task. REQUIRES both `tasklist_id` and `task_id`. Tasks cannot be retrieved by ID alone - you must always specify which task list contains the task."
18118 + "description": "Retrieve a specific Google Task. REQUIRES both `tasklist_id` and `task_id`. Tasks cannot be retrieved by ID alone - you must always specify which task list contains the task. Use this to refresh task details before display or edits rather than relying on potentially stale results from GOOGLETASKS_LIST_TASKS."
18119 },
18120 {
18121 "slug": "GOOGLETASKS_GET_TASK_LIST",
@@ -18125,7 +18125,7 @@
18125 {
18126 "slug": "GOOGLETASKS_INSERT_TASK",
18127 "name": "Insert Task",
18128 - "description": "Creates a new task in a given `tasklist_id`, optionally as a subtask of an existing `task_parent` or positioned after an existing `task_previous` sibling, where both `task_parent` and `task_previous` must belong to the same `tasklist_id` if specified. IMPORTANT: Date fields (due, completed) accept various formats like '28 Sep 2025', '11:59 PM, 22 Sep 2025', or ISO format '2025-09-21T15:30:00Z' and will automatically convert them to RFC3339 format required by the API."
18128 + "description": "Creates a new task in a given `tasklist_id`, optionally as a subtask of an existing `task_parent` or positioned after an existing `task_previous` sibling, where both `task_parent` and `task_previous` must belong to the same `tasklist_id` if specified. IMPORTANT: Date fields (due, completed) accept various formats like '28 Sep 2025', '11:59 PM, 22 Sep 2025', or ISO format '2025-09-21T15:30:00Z' and will automatically convert them to RFC3339 format required by the API. Not idempotent — repeated calls with identical parameters create duplicate tasks; track returned task IDs to avoid duplication. High-volume inserts may trigger 403 rateLimitExceeded or 429; apply exponential backoff."
18129 },
18130 {
18131 "slug": "GOOGLETASKS_LIST_ALL_TASKS",
@@ -18135,12 +18135,12 @@
18135 {
18136 "slug": "GOOGLETASKS_LIST_TASK_LISTS",
18137 "name": "List task lists",
18138 - "description": "Fetches the authenticated user's task lists from Google Tasks; results may be paginated."
18138 + "description": "Fetches the authenticated user's task lists from Google Tasks; results may be paginated. Response contains task lists under the `items` key. Multiple lists may share similar names — confirm the correct list by ID before passing to other tools."
18139 },
18140 {
18141 "slug": "GOOGLETASKS_LIST_TASKS",
18142 "name": "List Tasks",
18143 - "description": "Retrieves tasks from a Google Tasks list; all date/time strings must be RFC3339 UTC, and `showCompleted` must be true if `completedMin` or `completedMax` are specified."
18143 + "description": "Retrieves tasks from a Google Tasks list; all date/time strings must be RFC3339 UTC, and `showCompleted` must be true if `completedMin` or `completedMax` are specified. Response key for tasks is `tasks` (not `items`). No full-text search; filter client-side by title/notes. Results ordered by position, not by date."
18144 },
18145 {
18146 "slug": "GOOGLETASKS_MOVE_TASK",
@@ -18160,7 +18160,7 @@
18160 {
18161 "slug": "GOOGLETASKS_UPDATE_TASK",
18162 "name": "Update Task (Deprecated)",
18163 - "description": "DEPRECATED: Use GOOGLETASKS_PATCH_TASK instead. Updates the specified task."
18163 + "description": "DEPRECATED: Use GOOGLETASKS_PATCH_TASK instead. Full-update (PUT-style) operation that overwrites unspecified fields with empty/default values, which can cause data loss. Prefer GOOGLETASKS_PATCH_TASK unless a complete field replacement is explicitly required."
18164 },
18165 {
18166 "slug": "GOOGLETASKS_UPDATE_TASK_FULL",
@@ -18265,7 +18265,7 @@
18265 ],
18266 "toolCount": 16,
18267 "triggerCount": 1,
18268 - "version": "20260312_00",
18268 + "version": "20260316_00",
18269 "tools": [
18270 {
18271 "slug": "DISCORD_GET_CURRENT_USER_APPLICATION_ENTITLEMENTS",
@@ -18295,7 +18295,7 @@
18295 {
18296 "slug": "DISCORD_GET_INVITE",
18297 "name": "Get Invite (Deprecated)",
18298 - "description": "DEPRECATED: Use DISCORD_INVITE_RESOLVE instead. Tool to retrieve information about a specific invite code. Use when you need to get details about a guild or channel associated with an invite."
18298 + "description": "DEPRECATED: Use DISCORD_INVITE_RESOLVE instead. Tool to retrieve information about a specific invite code. Use when you need to get details about a guild or channel associated with an invite. Response may be null or partial for expired, revoked, or inaccessible invites; do not infer guild membership or channel access from the response."
18299 },
18300 {
18301 "slug": "DISCORD_GET_MY_GUILD_MEMBER",
@@ -18421,7 +18421,7 @@
18421 ],
18422 "toolCount": 53,
18423 "triggerCount": 0,
18424 - "version": "20260312_00",
18424 + "version": "20260316_00",
18425 "tools": [
18426 {
18427 "slug": "FIGMA_ADD_A_COMMENT_TO_A_FILE",
@@ -18486,12 +18486,12 @@
18486 {
18487 "slug": "FIGMA_DOWNLOAD_FIGMA_IMAGES",
18488 "name": "Download Figma Images",
18489 - "description": "Download images from Figma file nodes. Renders specified nodes as images and downloads them. Supports PNG, SVG, JPG, and PDF formats. REQUIRED PARAMETERS: - file_key (string): The Figma file key from the URL - images (array): List of objects, each containing: - node_id (string, required): The node ID to export (e.g., \"1:2\") - file_name (string, required): Output filename with extension (e.g., \"logo.png\") - format (string, optional): One of 'png', 'svg', 'jpg', 'pdf'. Defaults to 'png' Example usage: { \"file_key\": \"abc123XYZ\", \"images\": [ {\"node_id\": \"1:2\", \"file_name\": \"logo.png\", \"format\": \"png\"} ] } To find node IDs, use FIGMA_GET_FILE_JSON or look in Figma URLs after 'node-id='."
18489 + "description": "Download images from Figma file nodes. Renders specified nodes as images and downloads them. Supports PNG, SVG, JPG, and PDF formats. REQUIRED PARAMETERS: - file_key (string): The Figma file key from the URL - images (array): List of objects, each containing: - node_id (string, required): The node ID to export (e.g., \"1:2\") - file_name (string, required): Output filename with extension (e.g., \"logo.png\") - format (string, optional): One of 'png', 'svg', 'jpg', 'pdf'. Defaults to 'png' Example usage: { \"file_key\": \"abc123XYZ\", \"images\": [ {\"node_id\": \"1:2\", \"file_name\": \"logo.png\", \"format\": \"png\"} ] } To find node IDs, use FIGMA_GET_FILE_JSON or look in Figma URLs after 'node-id='. NOTE: Returned image URLs expire shortly after generation — download them immediately."
18490 },
18491 {
18492 "slug": "FIGMA_EXTRACT_DESIGN_TOKENS",
18493 "name": "Extract design tokens",
18494 - "description": "Extract design tokens from Figma files. Combines styles, variables, and extracted values to create a comprehensive design token system."
18494 + "description": "Extract design tokens from Figma files by combining styles, variables, and node-extracted values. Only values defined as Figma styles or variables are captured — any design values not encoded as styles/variables are silently omitted. Requires `file_variables:read` scope and a Figma plan that supports variables for full output; if variables return empty, supplement with FIGMA_GET_LOCAL_VARIABLES."
18495 },
18496 {
18497 "slug": "FIGMA_EXTRACT_PROTOTYPE_INTERACTIONS",
@@ -18791,7 +18791,7 @@
18791 ],
18792 "toolCount": 23,
18793 "triggerCount": 0,
18794 - "version": "20260312_00",
18794 + "version": "20260316_00",
18795 "tools": [
18796 {
18797 "slug": "COMPOSIO_SEARCH_AMAZON",
@@ -18806,7 +18806,7 @@
18806 {
18807 "slug": "COMPOSIO_SEARCH_EVENT",
18808 "name": "Composio Google Events Search",
18809 - "description": "Search for upcoming events, concerts, festivals, conferences, and other activities. This tool finds local and global events with powerful filtering options. Supports location-based search (city, neighborhood, address), date filtering (today, tomorrow, weekend, next week/month), virtual event discovery, international search with 100+ languages and countries, and pagination for comprehensive results. Perfect for discovering entertainment events, business conferences, sports games, cultural festivals, workshops, meetups, and scheduled activities. Examples: \"Tech conferences\" in \"San Francisco, CA\" with gl=\"us\" and hl=\"en\" \"Virtual networking events\" with htichips=\"event_type:Virtual-Event,date:next_week\" \"Music festivals\" in \"London, UK\" with gl=\"uk\" and hl=\"en\""
18809 + "description": "Search for upcoming events, concerts, festivals, conferences, and other activities. Supports location-based search (city, neighborhood, address), date filtering (today, tomorrow, weekend, next week/month), virtual event discovery, international search with 100+ languages and countries, and pagination. If results are sparse or events_results_state is 'Fully empty', treat as limited coverage and try COMPOSIO_SEARCH_WEB instead of retrying. Rate limit: ~2 requests/second; apply exponential backoff (1s, 2s, 4s) on 429 errors. Examples: \"Tech conferences\" in \"San Francisco, CA\" with gl=\"us\" and hl=\"en\" | \"Virtual networking events\" with htichips=\"event_type:Virtual-Event,date:next_week\" | \"Music festivals\" in \"London, UK\" with gl=\"uk\" and hl=\"en\""
18810 },
18811 {
18812 "slug": "COMPOSIO_SEARCH_EXA_ANSWER",
@@ -18826,7 +18826,7 @@
18826 {
18827 "slug": "COMPOSIO_SEARCH_FINANCE",
18828 "name": "Composio Finance Search",
18829 - "description": "Get real-time stock prices, market data, financial news, and company information with historical analysis. This tool retrieves comprehensive financial data including stock quotes, market indices, cryptocurrency prices, exchange rates, and financial news. Supports multiple time ranges (1D to MAX history) for charts and historical analysis. Returns detailed graph data, summary information, and key events (for 6M+ windows). Perfect for tracking investments, analyzing market trends, and research. Examples: query=\"AAPL:NASDAQ\" + window=\"1Y\" for Apple's 1-year chart with key events query=\"GOOGL:NASDAQ\" + window=\"6M\" + hl=\"en\" for Alphabet with news events timeline query=\"WMT:NYSE\" + window=\"MAX\" for Walmart's complete historical data since 1983 query=\"BTC-USD\" for Bitcoin price data query=\"EUR-USD\" for Euro/USD exchange rate"
18829 + "description": "Get real-time stock prices, market data, financial news, and company information with historical analysis. Retrieves stock quotes, market indices, cryptocurrency prices, exchange rates, and financial news. Supports discrete time windows (1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX) for historical analysis. Returns numeric time-series graph data, summary information, and key events (6M+ windows only). Always verify finance_results_state in the response — HTTP 200 with status='Success' can still return empty data. Derived indicators (MACD, moving averages) are not included and must be computed from returned price series. Examples: query=\"AAPL:NASDAQ\" + window=\"1Y\" for Apple's 1-year chart query=\"GOOGL:NASDAQ\" + window=\"6M\" + hl=\"en\" for Alphabet with news events query=\"WMT:NYSE\" + window=\"MAX\" for Walmart's full history query=\"BTC-USD\" for Bitcoin query=\"EUR-USD\" for Euro/USD rate"
18830 },
18831 {
18832 "slug": "COMPOSIO_SEARCH_FLIGHTS",
@@ -18836,27 +18836,27 @@
18836 {
18837 "slug": "COMPOSIO_SEARCH_GOOGLE_MAPS",
18838 "name": "Composio Google Maps Search",
18839 - "description": "The GoogleMapsSearch class performs a location-specific search using the Composio Google Maps Search API. This class extends the functionality of the base Action class to specifically target locations related to the given query. By utilizing the Google Maps search engine through the Composio Google Maps Search API, it fetches the most relevant location data based on the input query. The `GoogleMapsSearch` class is particularly useful for applications that need to retrieve and display location information about a specific area. It leverages the powerful search capabilities of Google's maps search engine, ensuring that the returned results are accurate and relevant."
18839 + "description": "Performs a location-specific search via the Composio Google Maps Search API, returning results under `results.local_results` (multi-place queries) or `results.place_results` (single place); always handle both branches. Fields like `opening_hours`, `phone`, `rating`, and `user_reviews` may be absent — treat missing values as unknown. Check `business_status`: closed businesses (`CLOSED_PERMANENTLY`, `TEMPORARILY_CLOSED`) can appear in results; filter for `OPERATIONAL` entries. Rate-limit calls to ~1 req/sec; HTTP 429 / `OVER_QUERY_LIMIT` indicates quota exhaustion. `gps_coordinates` may appear under `place_results` or inside individual `local_results` items."
18840 },
18841 {
18842 "slug": "COMPOSIO_SEARCH_GROQ_CHAT",
18843 "name": "Groq Chat Completion",
18844 - "description": "Execute fast LLM inference using Groq's optimized hardware and API. Groq provides ultra-fast inference for various open-source models including LLaMA 3, Mixtral, and Gemma. This action enables chat completions with OpenAI-compatible API format, offering exceptional speed and performance for AI-powered applications. Use cases: - Real-time chat applications requiring low latency - Content generation and text analysis - Question answering and information extraction - Code generation and explanation - Summarization and translation tasks"
18844 + "description": "Execute fast LLM inference using Groq's optimized hardware and API. Groq provides ultra-fast inference for open-source models including LLaMA 3, Mixtral, and Gemma via OpenAI-compatible chat completions API. Use cases: real-time chat, content generation, Q&A, code generation, summarization, translation. For structured JSON output, instruct the model explicitly to return valid JSON with no markdown code fences or prose; validate with json.loads — batches of 150+ items are prone to malformed JSON. Strip triple-backtick wrappers from code/JSON outputs before parsing. Always validate that the response contains at least one choice with non-empty message.content before downstream use. On HTTP 429 or 5xx errors, use exponential backoff with a small retry cap; limit concurrency to ~3 concurrent calls. Model-reported character/word counts are approximate — verify independently when strict limits matter."
18845 },
18846 {
18847 "slug": "COMPOSIO_SEARCH_HOTELS",
18848 "name": "Hotel Search",
18849 - "description": "Search for hotels and vacation rentals with comprehensive filtering and pricing. This tool finds available accommodations with detailed information including pricing, ratings, amenities, photos, and booking options. Supports price range filtering, star rating selection, sorting by various criteria (price, rating, distance), free cancellation options, and vacation rental inclusion. Perfect for travel planning, accommodation comparison, and finding the best lodging options for any destination. Examples: q=\"New York\" + check_in_date=\"2025-06-01\" + check_out_date=\"2025-06-05\" + adults=2 q=\"Paris\" + check_in_date=\"2025-03-15\" + check_out_date=\"2025-03-18\" + min_price=100 + max_price=300 q=\"Tokyo\" + check_in_date=\"2025-12-20\" + check_out_date=\"2025-12-25\" + hotel_class=\"4,5\" + sort_by=3"
18849 + "description": "Search for hotels and vacation rentals with comprehensive filtering and pricing. Returns results under results.properties and results.ads; extract numeric pricing from rate_per_night.extracted_lowest, total_rate.extracted_lowest, or extracted_price (fields vary by property). Deduplicate across sections using property_token. Additional pages available via serpapi_pagination.next_page_token. Start with minimal filters — combining max_price, min_price, hotel_class, free_cancellation, gl, or hl too strictly can return empty results. Examples: q=\"New York\" + check_in_date=\"2025-06-01\" + check_out_date=\"2025-06-05\" + adults=2 q=\"Paris\" + check_in_date=\"2025-03-15\" + check_out_date=\"2025-03-18\" + min_price=100 + max_price=300 q=\"Tokyo\" + check_in_date=\"2025-12-20\" + check_out_date=\"2025-12-25\" + hotel_class=\"4,5\" + sort_by=3"
18850 },
18851 {
18852 "slug": "COMPOSIO_SEARCH_IMAGE",
18853 "name": "Composio Image Search",
18854 - "description": "The ImageSearch class performs an image search using the Composio Image Search API, to target image data and information. It uses the Google Images search engine through the Composio Image Search API to fetch relevant image information based on the input query. The number of results can be controlled using the 'num' parameter (1-100). If not specified, it defaults to 20 results."
18854 + "description": "The ImageSearch class performs an image search using the Composio Image Search API, targeting image metadata and URLs (not binary data) via Google Images. Returns results under `results.images_results`; each entry exposes `original` (full resolution) and `thumbnail` (low resolution) URLs — verify URLs are publicly accessible before passing downstream. Check `license_details_url` per result before commercial reuse. The number of results is controlled by `num` (1–100, default 20). For >100 images, paginate using `serpapi_pagination.next`. Rate limit: throttle to ~1–2 calls/second; apply exponential backoff on HTTP 429."
18855 },
18856 {
18857 "slug": "COMPOSIO_SEARCH_NEWS",
18858 "name": "Composio News Search",
18859 - "description": "Search for the latest news articles and current events with smart filtering. This tool searches for news articles with time constraints and international support. Supports 100+ languages and countries. Use advanced operators like 'site:' for publisher filtering directly in your query. Examples: query=\"artificial intelligence\" + when=\"w\" for past week's AI news query=\"climate change\" + gl=\"us\" + hl=\"en\" for US climate news query=\"business news\" + when=\"d\" for today's business news query=\"site:bbc.com tesla\" + when=\"d\" for today's BBC Tesla news"
18859 + "description": "Search for the latest news articles and current events with smart filtering. Searches news-oriented sources only (not blogs, docs, or company pages). Results nest under `data.results.news_results`; a 200 response with empty `news_results` or `news_results_state: 'Fully empty'` means no results — broaden query or `when` window. Auto-correction (`showing_results_for`) can silently redirect queries; verify returned articles match intended topic. Only first page returned by default; follow `pagination.next` for more pages. Supports 100+ languages and countries. Use advanced operators like 'site:' for publisher filtering directly in your query. Examples: query=\"artificial intelligence\" + when=\"w\" for past week's AI news query=\"climate change\" + gl=\"us\" + hl=\"en\" for US climate news query=\"business news\" + when=\"d\" for today's business news query=\"site:bbc.com tesla\" + when=\"d\" for today's BBC Tesla news"
18860 },
18861 {
18862 "slug": "COMPOSIO_SEARCH_NPPESNPI_LOOKUP",
@@ -18866,7 +18866,7 @@
18866 {
18867 "slug": "COMPOSIO_SEARCH_SCHOLAR",
18868 "name": "Composio Scholar Search",
18869 - "description": "Scholar API allows you to scrape results from a Google Scholar search query. The ScholarSearch class performs an academic search using the Composio Scholar Search API, academic papers and scholarly articles. It uses the Google Scholar search engine through the SERP API to fetch relevant academic information based on the input query."
18869 + "description": "Scholar API scrapes Google Scholar search results via SERP API, returning academic papers and scholarly articles. Results are nested under results.organic_results; access this key explicitly and use defensive .get() patterns as fields like DOI, citation_count, and author may be absent. Many results are paywalled — rely on titles, abstracts, and snippets when full text is unavailable. Results may include duplicate preprint and journal versions of the same work — deduplicate by DOI or normalized title. Only the first page is returned by default; follow pagination.next for additional pages. PDF links appear only under organic_results[n].resources where file_format is 'PDF'. Results may lag on recent work."
18870 },
18871 {
18872 "slug": "COMPOSIO_SEARCH_SEC_FILINGS",
@@ -18886,12 +18886,12 @@
18886 {
18887 "slug": "COMPOSIO_SEARCH_TRENDS",
18888 "name": "Composio Trends Search",
18889 - "description": "Discover trending topics, search patterns, and popularity data. This tool analyzes search interest over time, compares multiple topics, and identifies rising trends. Ideal for market research, content planning, SEO analysis, and understanding public interest patterns. Returns data on search volume trends, regional interest breakdowns, related topics, and suggested queries."
18889 + "description": "Discover trending topics, search patterns, and popularity data. Analyzes search interest over time, compares multiple topics, and identifies rising trends. Returns normalized 0–100 relative interest indices (not absolute search volumes) via interest_over_time.timeline_data; values are objects with 'extracted_value' (may be string '<1'). The final timeline entry may have partial_data=true for incomplete periods. Data typically lags ~24–48 hours. Response schema varies by data_type: TIMESERIES returns timeline_data, GEO_MAP returns regional breakdowns, RELATED_TOPICS/RELATED_QUERIES return topic/query lists — parse accordingly. Ideal for market research, content planning, and SEO analysis."
18890 },
18891 {
18892 "slug": "COMPOSIO_SEARCH_TRIP_ADVISOR",
18893 "name": "TripAdvisor Travel Search",
18894 - "description": "Search TripAdvisor for travel recommendations and itinerary planning. This tool searches TripAdvisor's comprehensive travel database for attractions, restaurants, hotels, tours, and activities. Perfect for creating travel itineraries, finding top-rated experiences, discovering local recommendations, and planning trips. Returns detailed information including ratings, reviews, photos, and traveler recommendations to help create amazing travel experiences and comprehensive itineraries. Examples: query=\"things to do in Paris\" + ssrc=\"A\" for attractions only query=\"best restaurants in Tokyo\" + ssrc=\"r\" for restaurants only query=\"hotels in Bali\" + ssrc=\"h\" + tripadvisor_domain=\"tripadvisor.com\""
18894 + "description": "Search TripAdvisor for travel recommendations and itinerary planning without authentication (unlike TRIPADVISOR_CONTENT_API_SEARCH_LOCATIONS and other TripAdvisor tools requiring an active connection). Searches attractions, restaurants, hotels, tours, and activities. Returns detailed ratings, reviews, photos, and traveler recommendations. Response data is nested under results → locations. Results may include evergreen articles alongside specific venues; verify result type before use in itineraries. Examples: query=\"things to do in Paris\" + ssrc=\"A\" for attractions only | query=\"best restaurants in Tokyo\" + ssrc=\"r\" | query=\"hotels in Bali\" + ssrc=\"h\" + tripadvisor_domain=\"tripadvisor.com\""
18895 },
18896 {
18897 "slug": "COMPOSIO_SEARCH_VERCEL_AI_CHAT",
@@ -18901,12 +18901,12 @@
18901 {
18902 "slug": "COMPOSIO_SEARCH_WALMART",
18903 "name": "Walmart Product Search",
18904 - "description": "Search Walmart for products with price filtering. This tool searches Walmart's product catalog including groceries, electronics, clothing, home goods, pharmacy, and auto services. Supports basic price range filtering for finding products within budget. Perfect for finding everyday essentials, comparing Walmart prices, and discovering Walmart's full range of products and services. Examples: query=\"wireless headphones\" + min_price=50 + max_price=200 query=\"gaming laptop\" + max_price=800 query=\"organic coffee\" + min_price=10"
18904 + "description": "Search Walmart for products with price filtering. This tool searches Walmart's product catalog including groceries, electronics, clothing, home goods, pharmacy, and auto services. Supports basic price range filtering for finding products within budget. Results may appear under response.data.results.shopping_results or data.products — do not hardcode a single response shape. Results mix sponsored and organic listings; check ad/sponsorship flags when ranking. Some products omit fields like bought_last_month; handle nulls in sorting logic. Examples: query=\"wireless headphones\" + min_price=50 + max_price=200 query=\"gaming laptop\" + max_price=800 query=\"organic coffee\" + min_price=10"
18905 },
18906 {
18907 "slug": "COMPOSIO_SEARCH_WEB",
18908 "name": "Composio Web Search",
18909 - "description": "Perform a web search using the Exa API."
18909 + "description": "Perform a web search using the Exa API. Returns a nested structure: narrative summary under results.answer, sources under results.citations (and optionally results.organic_results). Prioritize results.citations as primary evidence over results.answer, which can be vague. Only indexes publicly available content — no paywalled, login-gated, or private content. No date filters enforced; include recency terms in query and verify dates in snippets manually. Throttle to ~1–2 requests/second; bursty queries trigger HTTP 429. Large responses may be stored remotely — use structure_info to locate results.answer and results.citations."
18910 }
18911 ],
18912 "triggers": [],
@@ -18941,22 +18941,22 @@
18941 ],
18942 "toolCount": 23,
18943 "triggerCount": 0,
18944 - "version": "20260312_00",
18944 + "version": "20260316_00",
18945 "tools": [
18946 {
18947 "slug": "REDDIT_CREATE_REDDIT_POST",
18948 "name": "Create a Reddit post",
18949 - "description": "Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair."
18949 + "description": "Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair. Immediately publishes publicly visible content — confirm subreddit, title, and body with the user before executing. Posts may be silently removed post-submission by automoderator or subreddit rules (errors: SUBMIT_VALIDATION_BODY_BLACKLISTED_STRING, POST_GUIDANCE_VALIDATION_FAILED); verify visibility via the returned permalink. Rapid consecutive calls trigger RATELIMIT errors with cooldown hints."
18950 },
18951 {
18952 "slug": "REDDIT_DELETE_REDDIT_COMMENT",
18953 "name": "Delete Reddit comment",
18954 - "description": "Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user."
18954 + "description": "Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user. Deletion is permanent and irreversible."
18955 },
18956 {
18957 "slug": "REDDIT_DELETE_REDDIT_POST",
18958 "name": "Delete a Reddit post",
18959 - "description": "Permanently deletes a Reddit post by its ID, provided the authenticated user has deletion permissions for that post."
18959 + "description": "Permanently and irreversibly deletes a Reddit post by its ID. Confirm with the user before calling. Only works on posts authored by the authenticated account; attempting to delete another user's post will fail."
18960 },
18961 {
18962 "slug": "REDDIT_EDIT_REDDIT_COMMENT_OR_POST",
@@ -19016,7 +19016,7 @@
19016 {
19017 "slug": "REDDIT_GET_USER_FLAIR",
19018 "name": "Get user flair",
19019 - "description": "Fetches the list of user flair assignments for a given subreddit. Returns paginated results with user flair details."
19019 + "description": "Fetches the list of user flair assignments for a given subreddit. Returns paginated results with user flair details. Returned flair_id values are scoped to the specific subreddit and must not be reused across different subreddits."
19020 },
19021 {
19022 "slug": "REDDIT_GET_USERNAME_AVAILABLE",
@@ -19031,27 +19031,27 @@
19031 {
19032 "slug": "REDDIT_POST_REDDIT_COMMENT",
19033 "name": "Post a comment",
19034 - "description": "Posts a comment on Reddit, replying to an existing and accessible submission (post) or another comment."
19034 + "description": "Posts a comment on Reddit, replying to an existing submission (post) or another comment. Fails if the target thread is locked, archived, or restricted — verify thread state beforehand. Rapid successive calls trigger Reddit RATELIMIT errors with explicit cooldown hints (e.g., 'take a break for 9 minutes'); honor the specified wait before retrying. A successful API response does not guarantee public visibility — automod or spam filters may silently remove the comment. Publishes immediately and publicly; confirm target and text before executing."
19035 },
19036 {
19037 "slug": "REDDIT_RETRIEVE_POST_COMMENTS",
19038 "name": "Retrieve Comments for a Post",
19039 - "description": "Retrieves all comments for a Reddit post given its article ID (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing."
19039 + "description": "Retrieves all comments for a Reddit post given its base-36 article ID. Response is a two-element listings array: post metadata in `listings[0]`; comments in `listings[1].data.children` with text at each `[].data.body` and nested replies under each comment's `replies` field. Replies require recursive traversal to capture full discussion. Large, locked, or archived threads may return truncated trees or `more` placeholders rather than full results. Filter out comments where `body` is `[deleted]` or `[removed]`; use `parent_id` to reconstruct conversation flow. No time-filter parameter — compare `created_utc` against a UTC cutoff to filter by date."
19040 },
19041 {
19042 "slug": "REDDIT_RETRIEVE_REDDIT_POST",
19043 "name": "Retrieve posts from subreddit",
19044 - "description": "Retrieves the current hot posts from a specified, publicly accessible subreddit."
19044 + "description": "Retrieves posts from a specified, publicly accessible subreddit. Responses nest post data under `data.children[].data`; inspect the structure before parsing. Pagination uses a `data.after` cursor; deduplicate across pages by post `id`. No built-in date filtering; compare `created_utc` (Unix seconds, UTC) client-side. Rate limit: ~1–2 requests/second; back off on HTTP 429."
19045 },
19046 {
19047 "slug": "REDDIT_RETRIEVE_SPECIFIC_COMMENT",
19048 "name": "Retrieve specific comment or post",
19049 - "description": "Retrieves detailed information for a specific Reddit comment or post using its fullname."
19049 + "description": "Retrieves detailed information for a single Reddit comment or post using its fullname. Returns only the specified item, not surrounding thread context; use REDDIT_RETRIEVE_POST_COMMENTS for full discussion retrieval. Deleted, removed, or quarantined items may return empty or partial payloads."
19050 },
19051 {
19052 "slug": "REDDIT_SEARCH_ACROSS_SUBREDDITS",
19053 "name": "Search across subreddits",
19054 - "description": "Searches Reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict_sr` is set to False."
19054 + "description": "Searches Reddit for posts/comments using a query. Results nested under `data.children[i].data` (kind `t3` for posts); a `posts` array may also appear — inspect actual response path. No native time-range filter; compare `created_utc` (Unix epoch, UTC) client-side for recency filtering. Empty `children` is a valid no-results outcome. Key post fields: `score`, `num_comments`, `created_utc`, `permalink`. Rate limit: ~1–2 requests/sec; HTTP 429 indicates throttling."
19055 },
19056 {
19057 "slug": "REDDIT_TOGGLE_INBOX_REPLIES",
@@ -20110,7 +20110,7 @@
20110 ],
20111 "toolCount": 144,
20112 "triggerCount": 0,
20113 - "version": "20260312_00",
20113 + "version": "20260316_00",
20114 "tools": [
20115 {
20116 "slug": "WRIKE_BULK_MODIFY_GROUPS",
@@ -20904,12 +20904,12 @@
20904 ],
20905 "toolCount": 18,
20906 "triggerCount": 0,
20907 - "version": "20260227_00",
20907 + "version": "20260316_00",
20908 "tools": [
20909 {
20910 "slug": "EXA_ANSWER",
20911 "name": "Generate an answer",
20912 - "description": "Generates a direct, citation-backed answer to a clear natural language question or topic using Exa's search, adept at both specific answers and detailed summaries for open-ended queries."
20912 + "description": "Generates a direct, citation-backed answer to a clear natural language question or topic using Exa's search, adept at both specific answers and detailed summaries for open-ended queries. Response contains an `answer` field (summary) and a `citations` field (supporting URLs). Citations may include low-credibility sources; verify authoritative references for factual use."
20913 },
20914 {
20915 "slug": "EXA_CREATE_IMPORT",
@@ -20954,7 +20954,7 @@
20954 {
20955 "slug": "EXA_GET_CONTENTS_ACTION",
20956 "name": "Get contents from URLs or document IDs",
20957 - "description": "Retrieves configurable text and highlights from a list of Exa document IDs or publicly accessible URLs."
20957 + "description": "Retrieves configurable text and highlights from a list of Exa document IDs or publicly accessible URLs. Calls may partially succeed — always inspect the per-item `statuses` array for errors like CRAWL_NOT_FOUND, CRAWL_LIVECRAWL_TIMEOUT, CRAWL_UNKNOWN_ERROR, or SOURCE_NOT_AVAILABLE. Retrieved text is nested under `results[i].text`, not a top-level field."
20958 },
20959 {
20960 "slug": "EXA_GET_EVENT",
@@ -20989,7 +20989,7 @@
20989 {
20990 "slug": "EXA_SEARCH",
20991 "name": "Search",
20992 - "description": "Performs a web search using the Exa engine, useful for queries requiring advanced filtering, specific content categories, or AI-optimized prompting. IMPORTANT CONSTRAINTS: - includeDomains and excludeDomains are MUTUALLY EXCLUSIVE: You can use ONE or the OTHER, but NEVER both in the same request. Providing both will cause a validation error. TYPE-SPECIFIC PARAMETER COMPATIBILITY: - type='keyword': Fast exact matching. Does NOT support useAutoprompt, includeDomains, or excludeDomains. - type='neural': AI semantic search. Supports all parameters including useAutoprompt and domain filters. - type='auto': Smart routing. Supports all parameters."
20992 + "description": "Performs a web search using the Exa engine, useful for queries requiring advanced filtering, specific content categories, or AI-optimized prompting. Returns snippets and metadata only — use EXA_GET_CONTENTS_ACTION on returned URLs to retrieve full page content. No pagination; issue multiple calls with varied queries or date windows for broader coverage. IMPORTANT CONSTRAINTS: - includeDomains and excludeDomains are MUTUALLY EXCLUSIVE: You can use ONE or the OTHER, but NEVER both in the same request. Providing both will cause a validation error. TYPE-SPECIFIC PARAMETER COMPATIBILITY: - type='keyword': Fast exact matching. Does NOT support useAutoprompt, includeDomains, or excludeDomains. - type='neural': AI semantic search. Supports all parameters including useAutoprompt and domain filters. - type='auto': Smart routing. Supports all parameters."
20993 },
20994 {
20995 "slug": "EXA_UPDATE_IMPORT",
@@ -21039,7 +21039,7 @@
21039 ],
21040 "toolCount": 208,
21041 "triggerCount": 0,
21042 - "version": "20260312_00",
21042 + "version": "20260316_00",
21043 "tools": [
21044 {
21045 "slug": "SENTRY_ACCESS_PROJECT_INFORMATION",
@@ -22168,7 +22168,7 @@
22168 ],
22169 "toolCount": 15,
22170 "triggerCount": 0,
22171 - "version": "20260312_00",
22171 + "version": "20260316_00",
22172 "tools": [
22173 {
22174 "slug": "SNOWFLAKE_CANCEL_STATEMENT_EXECUTION",
@@ -22178,12 +22178,12 @@
22178 {
22179 "slug": "SNOWFLAKE_CHECK_STATEMENT_STATUS",
22180 "name": "Check Statement Status",
22181 - "description": "Retrieves the status and results of a previously submitted SQL statement using its statement handle."
22181 + "description": "Retrieves the status and results of a previously submitted SQL statement using its statement handle. Use this to poll async queries submitted via SNOWFLAKE_SUBMIT_SQL_STATEMENT; call repeatedly until status is no longer pending. Use SNOWFLAKE_CANCEL_STATEMENT to abort a hanging query."
22182 },
22183 {
22184 "slug": "SNOWFLAKE_EXECUTE_SQL",
22185 "name": "Execute SQL",
22186 - "description": "Execute SQL statements in Snowflake and retrieve results. Supports SELECT queries for data retrieval, DDL statements (CREATE, ALTER, DROP) for schema management, and DML statements (INSERT, UPDATE, DELETE) for data modification. Returns comprehensive result metadata including column types, row counts, and execution status."
22186 + "description": "Execute SQL statements in Snowflake and retrieve results. Supports SELECT queries for data retrieval, DDL statements (CREATE, ALTER, DROP) for schema management, and DML statements (INSERT, UPDATE, DELETE) for data modification. Returns comprehensive result metadata including column types, row counts, and execution status. Unquoted SQL identifiers are auto-uppercased by Snowflake — use matching case in `database`, `schema_name`, `warehouse`, and `role` parameters to avoid 'object not found' errors. Always apply explicit time-range filters and a LIMIT clause to unbounded SELECT queries to prevent large, slow result sets."
22187 },
22188 {
22189 "slug": "SNOWFLAKE_FETCH_CATALOG_INTEGRATION",
@@ -22243,7 +22243,7 @@
22243 {
22244 "slug": "SNOWFLAKE_SUBMIT_SQL_STATEMENT",
22245 "name": "Submit SQL Statement (Deprecated)",
22246 - "description": "DEPRECATED: Use ExecuteSql instead. Submits a SQL statement for execution."
22246 + "description": "DEPRECATED: Use ExecuteSql instead. Submits a SQL statement for execution. Execution is asynchronous; monitor status with SNOWFLAKE_CHECK_STATEMENT_STATUS for long-running queries."
22247 }
22248 ],
22249 "triggers": [],
@@ -22430,7 +22430,7 @@
22430 ],
22431 "toolCount": 155,
22432 "triggerCount": 0,
22433 - "version": "20260312_00",
22433 + "version": "20260316_00",
22434 "tools": [
22435 {
22436 "slug": "ELEVENLABS_ADD_A_PRONUNCIATION_DICTIONARY",
@@ -22695,7 +22695,7 @@
22695 {
22696 "slug": "ELEVENLABS_GET_AGENT_DETAILS",
22697 "name": "Get agent details",
22698 - "description": "Tool to retrieve available Conversational AI agents and outbound-capable Twilio phone numbers. Use when selecting an agent and phone number for outbound calls."
22698 + "description": "Tool to retrieve available Conversational AI agents and outbound-capable Twilio phone numbers. Use when selecting an agent and phone number for outbound calls. Always reference agents by agent_id (stable identifier), not agent_name (mutable). Returns basic metadata only — conversation_config and webhook settings require a separate ConvAI agent API call. Pass agent_id and agent_phone_number_id directly to ELEVENLABS_OUTBOUND_CALL; IDs must be current and owned by the authenticated account."
22699 },
22700 {
22701 "slug": "ELEVENLABS_GET_AGENT_LINK",
@@ -23135,17 +23135,17 @@
23135 {
23136 "slug": "ELEVENLABS_SUBMIT_BATCH_CALL",
23137 "name": "Submit Batch Call",
23138 - "description": "Tool to submit a batch call. Use when you need to initiate multiple calls (voice or WhatsApp) at once."
23138 + "description": "Tool to submit a batch call. Use when you need to initiate multiple calls (voice or WhatsApp) at once. Triggers real outbound calls immediately (if no scheduled_time_unix is set) or at the scheduled time — always confirm recipient list and call count with the user before executing."
23139 },
23140 {
23141 "slug": "ELEVENLABS_TEXT_TO_SPEECH",
23142 "name": "Text to speech",
23143 - "description": "Converts text to speech using a specified ElevenLabs voice and model, returning a downloadable audio file."
23143 + "description": "Converts text to speech using a specified ElevenLabs voice and model, returning a downloadable audio file (use ELEVENLABS_TEXT_TO_SPEECH_STREAM for streaming instead). Audio URL is nested at `data.file.s3url` in the response. Keep `voice_id`, `model_id`, and `output_format` consistent across all chunks to avoid audible artifacts when concatenating. Some voice/model/format combinations require specific subscription tiers; test with a short sample before full runs. HTTP 429 on burst batches; respect `Retry-After` headers."
23144 },
23145 {
23146 "slug": "ELEVENLABS_TEXT_TO_SPEECH_STREAM",
23147 "name": "Text to speech stream",
23148 - "description": "Converts text to a spoken audio stream, allowing latency optimization, specific output formats (some tier-dependent), and custom pronunciations; ensure the chosen model supports text-to-speech and text is preferably under 5000 characters."
23148 + "description": "Converts text to a spoken audio stream (no saved file or history entry); use the non-streaming text-to-speech tool when a persistent audio URL is needed. Allows latency optimization, specific output formats (some tier-dependent), and custom pronunciations; ensure the chosen model supports text-to-speech and text is preferably under 5000 characters. Keep voice_id, model_id, and output_format consistent across multi-chunk sessions to avoid audio artifacts."
23149 },
23150 {
23151 "slug": "ELEVENLABS_UPDATE_AUDIO_NATIVE_CONTENT",
@@ -24138,7 +24138,7 @@
24138 ],
24139 "toolCount": 153,
24140 "triggerCount": 1,
24141 - "version": "20260312_00",
24141 + "version": "20260316_00",
24142 "tools": [
24143 {
24144 "slug": "ASANA_ADD_FOLLOWERS_TO_PROJECT",
@@ -24975,7 +24975,7 @@
24975 ],
24976 "toolCount": 24,
24977 "triggerCount": 0,
24978 - "version": "20260312_00",
24978 + "version": "20260316_00",
24979 "tools": [
24980 {
24981 "slug": "PEOPLEDATALABS_CLEAN_COMPANY_DATA",
@@ -25020,7 +25020,7 @@
25020 {
25021 "slug": "PEOPLEDATALABS_ENRICH_COMPANY_DATA",
25022 "name": "Enrich Company Data",
25023 - "description": "Enriches company data from People Data Labs with details like firmographics and employee counts. CRITICAL: This action REQUIRES at least one company identifier. DO NOT send empty {} requests. You MUST provide at least one of: pdl_id, name, profile, ticker, or website. Valid request examples: - {\"name\": \"Apple Inc.\"} - enrich by company name - {\"website\": \"google.com\"} - enrich by website URL - {\"ticker\": \"MSFT\"} - enrich by stock ticker - {\"profile\": \"linkedin.com/company/microsoft\"} - enrich by social profile"
25023 + "description": "Enriches company data from People Data Labs with details like firmographics and employee counts. CRITICAL: This action REQUIRES at least one company identifier. DO NOT send empty {} requests. You MUST provide at least one of: pdl_id, name, profile, ticker, or website. Valid request examples: - {\"name\": \"Apple Inc.\"} - enrich by company name - {\"website\": \"google.com\"} - enrich by website URL - {\"ticker\": \"MSFT\"} - enrich by stock ticker - {\"profile\": \"linkedin.com/company/microsoft\"} - enrich by social profile. Each call consumes API credits; use specific identifiers rather than exploratory requests."
25024 },
25025 {
25026 "slug": "PEOPLEDATALABS_ENRICH_IP_DATA",
@@ -25075,7 +25075,7 @@
25075 {
25076 "slug": "PEOPLEDATALABS_IDENTIFY_PERSON_DATA",
25077 "name": "Identify person data",
25078 - "description": "Retrieves detailed profile information for an individual from People Data Labs (PDL), requiring at least one identifier such as email, phone, profile URL, name, or company."
25078 + "description": "Retrieves detailed profile information for an individual from People Data Labs (PDL), requiring at least one identifier such as email, phone, or profile URL. If using name alone, it must be paired with at least one additional attribute (company, location, school, etc.) — name-only queries return no match."
25079 },
25080 {
25081 "slug": "PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC",
@@ -25137,7 +25137,7 @@
25137 ],
25138 "toolCount": 432,
25139 "triggerCount": 0,
25140 - "version": "20260312_00",
25140 + "version": "20260316_00",
25141 "tools": [
25142 {
25143 "slug": "SHOPIFY_ACTIVATE_ONE_TIME_CHARGE",
@@ -25367,12 +25367,12 @@
25367 {
25368 "slug": "SHOPIFY_CREATE_CUSTOM_COLLECTION",
25369 "name": "Create a custom collection",
25370 - "description": "Create a new custom collection in Shopify. Use when you need to manually curate and group products for easier store browsing. Custom collections require a title and support optional fields like description, image, publication settings, and sort order."
25370 + "description": "Create a new custom (manually curated) collection in Shopify. Does not support smart collections. Use when you need to manually curate and group products for easier store browsing. Custom collections require a title and support optional fields like description, image, publication settings, and sort order. After creation, use the returned `collection_id` with SHOPIFY_ADD_PRODUCT_TO_COLLECTION to associate products."
25371 },
25372 {
25373 "slug": "SHOPIFY_CREATE_CUSTOMER",
25374 "name": "Create Customer",
25375 - "description": "Create a new customer in Shopify. Use to add a customer record to the store with contact details, addresses, and marketing preferences. Requires at least one of: email, phone, or both first_name and last_name."
25375 + "description": "Create a new customer in Shopify. Use to add a customer record to the store with contact details, addresses, and marketing preferences. Requires at least one of: email, phone, or both first_name and last_name. Errors (e.g., duplicate email, invalid fields) are returned in the response body's userErrors array, not as HTTP error codes — always inspect userErrors to detect failures."
25376 },
25377 {
25378 "slug": "SHOPIFY_CREATE_CUSTOMER_ACCOUNT_ACTIVATION_URL",
@@ -25447,7 +25447,7 @@
25447 {
25448 "slug": "SHOPIFY_CREATE_ORDER",
25449 "name": "Create an order",
25450 - "description": "Create a new order in Shopify without payment processing. Use when programmatically generating orders with line items, customer information, and addresses."
25450 + "description": "Create a fully committed (real) order in Shopify without payment processing. Use when programmatically generating orders with line items, customer information, and addresses. Creates a live order immediately — not a draft; use draftOrderCreate for draft workflows."
25451 },
25452 {
25453 "slug": "SHOPIFY_CREATE_ORDER_RISK",
@@ -25472,7 +25472,7 @@
25472 {
25473 "slug": "SHOPIFY_CREATE_PRODUCT",
25474 "name": "Create a product (Deprecated)",
25475 - "description": "DEPRECATED: Use SHOPIFY_CREATES_A_NEW_PRODUCT instead. Creates a new product in a Shopify store; a product title is generally required. Note: The Product REST API is deprecated as of API version 2025-10. While it continues to function, Shopify recommends migrating to the GraphQL Admin API for product management in new implementations. Inventory Management: inventory_quantity is read-only and cannot be set during product creation. To manage inventory, first create the product, then use the InventoryLevel resource with the variant's inventory_item_id (returned in the response) to adjust quantities at specific locations."
25475 + "description": "DEPRECATED: Use SHOPIFY_CREATES_A_NEW_PRODUCT instead. Creates a new product in a Shopify store; a product title is generally required. Note: The Product REST API is deprecated as of API version 2025-10. While it continues to function, Shopify recommends migrating to the GraphQL Admin API for product management in new implementations. Inventory Management: inventory_quantity is read-only and cannot be set during product creation. To manage inventory, first create the product, then use the InventoryLevel resource with the variant's inventory_item_id (returned in the response) to adjust quantities at specific locations. Response: product data nested at `data.response_data.product`; extract `id` and `variants[0].id` for subsequent image or collection calls."
25476 },
25477 {
25478 "slug": "SHOPIFY_CREATE_PRODUCT_IMAGE",
@@ -25482,7 +25482,7 @@
25482 {
25483 "slug": "SHOPIFY_CREATE_PRODUCT_METAFIELD",
25484 "name": "Create product metafield",
25485 - "description": "Creates a new metafield for a specific Shopify product."
25485 + "description": "Creates a new metafield for a specific Shopify product. Each namespace+key combination must be unique per product; use the update action if the metafield already exists."
25486 },
25487 {
25488 "slug": "SHOPIFY_CREATE_PRODUCT_VARIANT",
@@ -25667,7 +25667,7 @@
25667 {
25668 "slug": "SHOPIFY_DELETE_PRODUCT",
25669 "name": "Delete a product",
25670 - "description": "Permanently deletes a product from a Shopify store by its product ID. This action is irreversible - deleted products cannot be recovered. Deleting a product also removes all associated variants, images, and inventory. If the product has already been deleted, a 404 error will be returned."
25670 + "description": "Permanently deletes a product from a Shopify store by its product ID. This action is irreversible - deleted products cannot be recovered. Deleting a product also removes all associated variants, images, inventory, and removes the product from all collections and sales channels store-wide. If the goal is collection-only cleanup, adjust collection membership instead."
25671 },
25672 {
25673 "slug": "SHOPIFY_DELETE_PRODUCT_IMAGE",
@@ -25772,7 +25772,7 @@
25772 {
25773 "slug": "SHOPIFY_GET_ALL_CUSTOMERS",
25774 "name": "Get All Customers",
25775 - "description": "Retrieves customer records from a Shopify store, with options for filtering, selecting specific fields, and paginating through the results."
25775 + "description": "Retrieves customer records from a Shopify store, with options for filtering, selecting specific fields, and paginating through results. No server-side name or email filter exists; retrieve via pagination and match client-side across email, first_name, last_name, company, and address fields. REST field names (e.g., orders_count, total_spent) differ from GraphQL equivalents."
25776 },
25777 {
25778 "slug": "SHOPIFY_GET_APP",
@@ -25872,7 +25872,7 @@
25872 {
25873 "slug": "SHOPIFY_GET_COLLECTS",
25874 "name": "Get collects",
25875 - "description": "Retrieves a list of collects from a Shopify store, where a collect links a product to a custom collection."
25875 + "description": "Retrieves a list of collects from a Shopify store, where a collect links a product to a custom collection. Returns only collect mapping records (collect_id, collection_id, product_id, position, etc.), not full product details — use SHOPIFY_GET_PRODUCTS_IN_COLLECTION if product details are needed."
25876 },
25877 {
25878 "slug": "SHOPIFY_GET_COLLECTS_COUNT",
@@ -25932,7 +25932,7 @@
25932 {
25933 "slug": "SHOPIFY_GET_CUSTOM_COLLECTIONS",
25934 "name": "Get custom collections",
25935 - "description": "Retrieves a list of custom collections from a Shopify store. Supports filtering by IDs, handle, title, product ID, publication status, and date ranges (published/updated). Use the fields parameter to retrieve only specific properties, and limit/since_id for pagination."
25935 + "description": "Retrieves a list of custom collections from a Shopify store. Supports filtering by IDs, handle, title, product ID, publication status, and date ranges (published/updated). Use the fields parameter to retrieve only specific properties, and limit/since_id for pagination. Combining multiple filters (handle, ids, product_id) simultaneously may return empty sets; use broad filters first. Newly created collections may not appear immediately; use GetCollectionById to verify a specific collection shortly after creation."
25936 },
25937 {
25938 "slug": "SHOPIFY_GET_CUSTOM_COLLECTIONS_COUNT",
@@ -26167,7 +26167,7 @@
26167 {
26168 "slug": "SHOPIFY_GET_ORDERS_WITH_FILTERS",
26169 "name": "Get orders with filters",
26170 - "description": "Retrieves Shopify orders filtered by dates and other filters. Uses server-side filtering."
26170 + "description": "Retrieves Shopify orders filtered by dates and other filters. Uses server-side filtering. Results are paginated; follow `page_info` cursors until exhausted to retrieve all matching orders — a single request returns at most `limit` orders (max 250) and omits the rest."
26171 },
26172 {
26173 "slug": "SHOPIFY_GET_ORDER_TRANSACTIONS_COUNT",
@@ -26222,12 +26222,12 @@
26222 {
26223 "slug": "SHOPIFY_GET_PRODUCT_METAFIELDS",
26224 "name": "Get product metafields",
26225 - "description": "Retrieves all metafields for a specific Shopify product. Metafields can be filtered by namespace and/or key."
26225 + "description": "Retrieves all metafields for a specific Shopify product. Metafields are returned under `data.response_data.metafields`. Can be filtered by namespace and/or key; empty results are valid when no metafields match. Always fetch current metafield IDs via this tool rather than using cached values, as IDs can change after schema updates."
26226 },
26227 {
26228 "slug": "SHOPIFY_GET_PRODUCTS",
26229 "name": "Get products",
26230 - "description": "Retrieves a list of products from a Shopify store."
26230 + "description": "Retrieves a list of products from a Shopify store. Results are paginated; for large catalogs, use SHOPIFY_GET_PRODUCTS_PAGINATED to iterate all pages, as this tool may return only a partial set. Product handles and SKUs must be unique — use this tool to check for existing products before creating new ones."
26231 },
26232 {
26233 "slug": "SHOPIFY_GET_PRODUCTS_COUNT",
@@ -26237,12 +26237,12 @@
26237 {
26238 "slug": "SHOPIFY_GET_PRODUCTS_IN_COLLECTION",
26239 "name": "Get products in collection",
26240 - "description": "Retrieves products that belong to a specific Shopify collection. Returns detailed product information including variants, images, and options. Products are sorted according to the collection's configured sort order. Use this action when you need to: - List all products in a specific collection - Get product details for items within a collection - Display collection contents to users"
26240 + "description": "Retrieves products that belong to a specific Shopify collection. Returns detailed product information including variants, images, and options. Products are sorted according to the collection's configured sort order. Use this action when you need to: - List all products in a specific collection - Get product details for items within a collection - Display collection contents to users. For collection-product membership mappings without full product details, use SHOPIFY_GET_COLLECTS instead."
26241 },
26242 {
26243 "slug": "SHOPIFY_GET_PRODUCTS_PAGINATED",
26244 "name": "Get products (paginated)",
26245 - "description": "List products with Shopify cursor-based pagination. Use when iterating over large product catalogs via the Link header."
26245 + "description": "List products with Shopify cursor-based pagination. Iterate until `next_page_info` is null; stopping early silently truncates the product list. Products are at `data.response_data.products`; the next cursor is at `data.next_page_info`."
26246 },
26247 {
26248 "slug": "SHOPIFY_GET_PRODUCT_VARIANT",
@@ -26307,7 +26307,7 @@
26307 {
26308 "slug": "SHOPIFY_GET_SHOP_DETAILS",
26309 "name": "Get Shop Details",
26310 - "description": "Retrieves comprehensive administrative information about the authenticated Shopify store, as defined by the Shopify API."
26310 + "description": "Retrieves comprehensive administrative information about the authenticated Shopify store. The returned `iana_timezone` field is critical for date-based filtering in other tools (e.g., `created_at_min`/`created_at_max` in order queries), since Shopify stores timestamps in UTC and boundary-day orders can be dropped or double-counted without timezone adjustment. Also useful as a first-step connection validity check; an empty or malformed shop object indicates an invalid connection."
26311 },
26312 {
26313 "slug": "SHOPIFY_GET_SHOP_METAFIELD",
@@ -26387,7 +26387,7 @@
26387 {
26388 "slug": "SHOPIFY_GRAPH_QL_QUERY",
26389 "name": "Execute Shopify GraphQL query",
26390 - "description": "Executes a GraphQL query against the Shopify Admin API. This allows for flexible data retrieval and mutations including metafields operations."
26390 + "description": "Executes a GraphQL query against the Shopify Admin API for flexible data retrieval and mutations including metafields. Response data is nested under result['data']['data'], not result['data']. Always inspect both response_data.errors (top-level) and mutation-level userErrors—HTTP 200 can accompany GraphQL validation failures. Query costs draw from a ~1000-point bucket (~50 points/second refill); monitor extensions.cost.throttleStatus to avoid THROTTLED errors. Paginate list queries using pageInfo.hasNextPage and endCursor to avoid silently missing records. productUpdate replaces the entire tags array—send the complete final tag list. refundCreate requires orderId at both the top level and inside each transactions element. transaction parentId must reference a CAPTURE-kind transaction. Numeric fields like numberOfOrders may be returned as strings—cast before aggregating."
26391 },
26392 {
26393 "slug": "SHOPIFY_LIST_ABANDONED_CHECKOUTS",
@@ -27406,7 +27406,7 @@
27406 ],
27407 "toolCount": 22,
27408 "triggerCount": 0,
27409 - "version": "20260312_00",
27409 + "version": "20260316_00",
27410 "tools": [
27411 {
27412 "slug": "LINKEDIN_CREATE_ARTICLE_OR_URL_SHARE",
@@ -27586,7 +27586,7 @@
27586 ],
27587 "toolCount": 22,
27588 "triggerCount": 0,
27589 - "version": "20260312_00",
27589 + "version": "20260316_00",
27590 "tools": [
27591 {
27592 "slug": "GOOGLE_MAPS_AUTOCOMPLETE",
@@ -27596,12 +27596,12 @@
27596 {
27597 "slug": "GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX",
27598 "name": "Compute Route Matrix",
27599 - "description": "Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes."
27599 + "description": "Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes. Matrix is capped at 625 elements (e.g., 25×25); chunk larger sets to avoid RESOURCE_EXHAUSTED errors. Response elements may be returned out of input order — always use originIndex and destinationIndex to map results. Only use elements where condition='ROUTE_EXISTS'; the matrix may be incomplete."
27600 },
27601 {
27602 "slug": "GOOGLE_MAPS_DISTANCE_MATRIX_API",
27603 "name": "Distance Matrix (Legacy)",
27604 - "description": "DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern 'Compute Route Matrix' action instead, which supports OAuth2 authentication. Supports different modes of transportation and options like departure/arrival times."
27604 + "description": "DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern 'Compute Route Matrix' action instead, which supports OAuth2 authentication. Supports different modes of transportation and options like departure/arrival times. Capped at 100 elements per request (elements = origins × destinations count); split large sets into batches."
27605 },
27606 {
27607 "slug": "GOOGLE_MAPS_GEOCODE_ADDRESS",
@@ -27611,7 +27611,7 @@
27611 {
27612 "slug": "GOOGLE_MAPS_GEOCODE_ADDRESS_WITH_QUERY",
27613 "name": "Geocode Address With Query",
27614 - "description": "Tool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API."
27614 + "description": "Tool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API. Results may match multiple places — always verify `formattedAddress`, `region`, and `addressComponents` in the response before using returned coordinates."
27615 },
27616 {
27617 "slug": "GOOGLE_MAPS_GEOCODE_DESTINATIONS",
@@ -27621,7 +27621,7 @@
27621 {
27622 "slug": "GOOGLE_MAPS_GEOCODE_LOCATION",
27623 "name": "Reverse Geocode Location",
27624 - "description": "Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates."
27624 + "description": "Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates. A single coordinate pair may return multiple results; verify formattedAddress, region, and addressComponents before committing to a result."
27625 },
27626 {
27627 "slug": "GOOGLE_MAPS_GEOCODE_PLACE",
@@ -27631,7 +27631,7 @@
27631 {
27632 "slug": "GOOGLE_MAPS_GEOCODING_API",
27633 "name": "Geocoding API",
27634 - "description": "Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. Uses the Geocoding API v4 (v4beta) which supports OAuth2 authentication."
27634 + "description": "Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. Uses the Geocoding API v4 (v4beta) which supports OAuth2 authentication. Exactly one of `address`, `latlng`, or `place_id` must be provided per request; omitting all three or mixing incompatible combinations yields no useful results."
27635 },
27636 {
27637 "slug": "GOOGLE_MAPS_GEOLOCATE",
@@ -27646,7 +27646,7 @@
27646 {
27647 "slug": "GOOGLE_MAPS_GET3D_TILES_ROOT",
27648 "name": "Get 3D Tiles Root",
27649 - "description": "Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google's photorealistic tiles following the OGC 3D Tiles specification."
27649 + "description": "Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google's photorealistic tiles following the OGC 3D Tiles specification. The Map Tiles API is billable per request; cache the root response client-side and avoid repeated calls."
27650 },
27651 {
27652 "slug": "GOOGLE_MAPS_GET_DIRECTION",
@@ -27661,7 +27661,7 @@
27661 {
27662 "slug": "GOOGLE_MAPS_GET_ROUTE",
27663 "name": "Get Route",
27664 - "description": "Calculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps."
27664 + "description": "Calculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps. Response `duration` is a string with 's' suffix (e.g., `\"4557s\"`); parse before displaying."
27665 },
27666 {
27667 "slug": "GOOGLE_MAPS_LOOKUP_AERIAL_VIDEO",
@@ -27671,7 +27671,7 @@
27671 {
27672 "slug": "GOOGLE_MAPS_MAPS_EMBED_API",
27673 "name": "Embed Google Map",
27674 - "description": "Tool to generate an embeddable Google Map URL and HTML iframe code. Use when you need to display a map (place, view, directions, street view, search) on a webpage without JavaScript. Note: This API only works with API keys (no OAuth2 support). It generates embed URLs and does not make direct API calls."
27674 + "description": "Tool to generate an embeddable Google Map URL and HTML iframe code. Use when you need to display a map (place, view, directions, street view, search) on a webpage without JavaScript. Note: This API only works with API keys (no OAuth2 support). It generates embed URLs and does not make direct API calls. Generated embed URLs are publicly accessible; avoid passing sensitive or internal location queries."
27675 },
27676 {
27677 "slug": "GOOGLE_MAPS_NEARBY_SEARCH",
@@ -27691,12 +27691,12 @@
27691 {
27692 "slug": "GOOGLE_MAPS_TEXT_SEARCH",
27693 "name": "Text Search",
27694 - "description": "Searches for places on Google Maps using a textual query (e.g., \"restaurants in London\", \"Eiffel Tower\")."
27694 + "description": "Searches for places on Google Maps using a textual query (e.g., \"restaurants in London\", \"Eiffel Tower\"). Results may include CLOSED_PERMANENTLY or TEMPORARILY_CLOSED places — filter by businessStatus=OPERATIONAL. Include city/region and business type in textQuery to avoid empty or irrelevant results. Deduplicate using id or formattedAddress, not name alone. Throttle to ~1 req/s; OVER_QUERY_LIMIT (HTTP 429) requires exponential backoff."
27695 },
27696 {
27697 "slug": "GOOGLE_MAPS_TILES_CREATE_SESSION",
27698 "name": "Create Tiles Session",
27699 - "description": "Tool to create a session token required for accessing 2D Tiles and Street View imagery. Use when you need to initialize tile-based map rendering or street view display. The session token is valid for approximately two weeks and must be included in all subsequent tile requests."
27699 + "description": "Tool to create a session token required for accessing 2D Tiles and Street View imagery. Use when you need to initialize tile-based map rendering or street view display. The session token is valid for approximately two weeks and must be included in all subsequent tile requests. Each call consumes quota — cache and reuse the returned token across all tile requests within its validity window rather than creating a new session per request."
27700 }
27701 ],
27702 "triggers": [],
@@ -27788,7 +27788,7 @@
27788 ],
27789 "toolCount": 61,
27790 "triggerCount": 9,
27791 - "version": "20260313_00",
27791 + "version": "20260316_00",
27792 "tools": [
27793 {
27794 "slug": "ONE_DRIVE_CHECKIN_ITEM",
@@ -27803,7 +27803,7 @@
27803 {
27804 "slug": "ONE_DRIVE_COPY_ITEM",
27805 "name": "Copy Item",
27806 - "description": "Tool to copy a DriveItem (file or folder) to a new location asynchronously. Use when you need to duplicate an item, optionally renaming it or specifying a different parent folder. The operation is asynchronous; the response provides a URL to monitor the copy progress."
27806 + "description": "Tool to copy a DriveItem (file or folder) to a new location asynchronously. Use when you need to duplicate an item, optionally renaming it or specifying a different parent folder. The operation is asynchronous; the response provides a URL to monitor the copy progress. Do not assume the copy is complete immediately; verify via ONE_DRIVE_GET_ITEM or by listing the destination, especially for large folder trees."
27807 },
27808 {
27809 "slug": "ONE_DRIVE_CREATE_ITEM_PERMISSION",
@@ -27818,7 +27818,7 @@
27818 {
27819 "slug": "ONE_DRIVE_DELETE_ITEM",
27820 "name": "Delete Item",
27821 - "description": "Tool to delete a DriveItem (file or folder) by its unique ID from the authenticated user's OneDrive. Use when you need to remove an item from OneDrive. This action moves the item to the recycle bin, not permanently deleting it."
27821 + "description": "Tool to delete a DriveItem (file or folder) by its unique ID from the authenticated user's OneDrive. Use when you need to remove an item from OneDrive. This action moves the item to the recycle bin, not permanently deleting it; storage quota is not freed until the recycle bin is emptied. Bulk deletions can trigger 429 (rate limit) or 5xx responses — limit concurrency and use exponential backoff."
27822 },
27823 {
27824 "slug": "ONE_DRIVE_DELETE_ITEM_PERMANENTLY",
@@ -27843,7 +27843,7 @@
27843 {
27844 "slug": "ONE_DRIVE_DOWNLOAD_FILE",
27845 "name": "Download a file",
27846 - "description": "Downloads a file from a user's OneDrive using its item ID, which must refer to a file and not a folder."
27846 + "description": "Downloads a file from a user's OneDrive using its item ID, which must refer to a file and not a folder. Response contains a content object with fields: s3url (URL to fetch raw file bytes), mimetype, and name; raw file data is not returned directly. Parsing content from Excel, Word, PDF, or other formats requires additional tooling. The response also includes attachment.s3key, required when passing this file to downstream tools such as OUTLOOK_SEND_EMAIL or OUTLOOK_CREATE_DRAFT."
27847 },
27848 {
27849 "slug": "ONE_DRIVE_DOWNLOAD_FILE_BY_PATH",
@@ -27868,7 +27868,7 @@
27868 {
27869 "slug": "ONE_DRIVE_GET_DRIVE",
27870 "name": "Get Drive",
27871 - "description": "Retrieves the properties and relationships of a Drive resource by its unique ID. Use this action when you need to get details about a specific OneDrive, user's OneDrive, group's document library, or a site's document library."
27871 + "description": "Retrieves the properties and relationships of a Drive resource by its unique ID. Use this action when you need to get details about a specific OneDrive, user's OneDrive, group's document library, or a site's document library. Only drives accessible to the authenticated user are returned; missing drives indicate insufficient OAuth scope or tenant permissions."
27872 },
27873 {
27874 "slug": "ONE_DRIVE_GET_DRIVE_ITEM_BY_SHARING_URL",
@@ -27893,27 +27893,27 @@
27893 {
27894 "slug": "ONE_DRIVE_GET_ITEM_PERMISSIONS",
27895 "name": "Get Item Permissions",
27896 - "description": "Retrieves the permissions of a DriveItem by its unique ID or path within a specific Drive. Use when you need to check who has access to a file or folder and what level of access they have."
27896 + "description": "Retrieves the permissions of a DriveItem by its unique ID within a specific Drive. Use when you need to check who has access to a file or folder and what level of access they have. Response nests permission entries under `data.value`; check top-level `success`/`error` flags before processing results. Results include inherited permissions, owner entries, and anonymous link entries — not just explicitly granted permissions. Sharing links may have differing scopes (org-only vs. anonymous); verify `link.scope` before treating a permission as externally accessible."
27897 },
27898 {
27899 "slug": "ONE_DRIVE_GET_ITEM_THUMBNAILS",
27900 "name": "Get Item Thumbnails",
27901 - "description": "Tool to retrieve the thumbnails associated with a DriveItem. Use when you need to display visual previews of files."
27901 + "description": "Tool to retrieve the thumbnails associated with a DriveItem. Use when you need to display visual previews of files. Response contains a `value` array with size keys (`small`, `medium`, `large`); thumbnails may not be generated for all file types or newly uploaded items, so handle an empty or missing `value` array. Returned thumbnail URLs are external HTTP endpoints with independent availability."
27902 },
27903 {
27904 "slug": "ONE_DRIVE_GET_ITEM_VERSIONS",
27905 "name": "Get Item Versions",
27906 - "description": "Tool to retrieve the version history of a DriveItem by its unique ID. Use when you need to access or list previous versions of a file."
27906 + "description": "Tool to retrieve the version history of a DriveItem by its unique ID. Use when you need to access or list previous versions of a file. Version history may be unavailable or empty for folders or items in drives without versioning enabled."
27907 },
27908 {
27909 "slug": "ONE_DRIVE_GET_QUOTA",
27910 "name": "Get Drive Quota",
27911 - "description": "Tool to retrieve the quota information for the authenticated user's OneDrive. Use this action to check the storage space details like total, used, and remaining space on the user's OneDrive."
27911 + "description": "Tool to retrieve the quota information for the authenticated user's primary OneDrive only (not secondary or shared drives). Use this action to check storage space details like total, used, and remaining space; quota values are returned as integers in bytes."
27912 },
27913 {
27914 "slug": "ONE_DRIVE_GET_RECENT_ITEMS",
27915 "name": "Get Recent Items",
27916 - "description": "Get files and folders recently accessed by the user. Returns items based on activity history (opened, edited, viewed), sorted by most recent first. Use when you need to see what the user worked on recently (e.g., 'Show me files I worked on today'). Different from search - this tracks activity, not content."
27916 + "description": "Get files and folders recently accessed by the user. Returns items based on activity history (opened, edited, viewed), sorted by most recent first — NOT by modification time; use ONE_DRIVE_ONEDRIVE_LIST_ITEMS or ONE_DRIVE_LIST_ROOT_DRIVE_CHANGES for strictly modification-based queries. Use when you need to see what the user worked on recently (e.g., 'Show me files I worked on today'). Different from search - this tracks activity, not content. Results may contain duplicate names; disambiguate using lastModifiedDateTime, parentReference.path, and the file/folder property before acting on a specific item."
27917 },
27918 {
27919 "slug": "ONE_DRIVE_GET_ROOT",
@@ -27928,7 +27928,7 @@
27928 {
27929 "slug": "ONE_DRIVE_GET_SHARED_ITEMS",
27930 "name": "Get Shared Items",
27931 - "description": "Tool to retrieve a list of items that have been shared with the authenticated user. Use this action to get details of files and folders shared with the current user."
27931 + "description": "Tool to retrieve items shared with the authenticated user (not items the user has shared with others). Returns files and folders shared with the current user; response value array may be empty if no items exist. Use webUrl field from results for clickable links to items."
27932 },
27933 {
27934 "slug": "ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS",
@@ -27973,7 +27973,7 @@
27973 {
27974 "slug": "ONE_DRIVE_LIST_DRIVES",
27975 "name": "List Drives",
27976 - "description": "Tool to retrieve a list of Drive resources available to the authenticated user, or for a specific user, group, or site. Use when you need to find out what drives are accessible."
27976 + "description": "Tool to retrieve a list of Drive resources available to the authenticated user, or for a specific user, group, or site. Use when you need to find out what drives are accessible. Returns only drives within the signed-in account's permission scope; missing drives indicate insufficient permissions or different tenant scope. Results are paginated — follow skip_token across all pages to avoid missing drives. Returned drives represent document libraries and may not reflect full SharePoint site structure; use SHARE_POINT_GET_SITE_COLLECTION_INFO or SHARE_POINT_SEARCH_QUERY for broader coverage. Use driveType and webUrl to distinguish personal, system, and SharePoint-backed drives."
27977 },
27978 {
27979 "slug": "ONE_DRIVE_LIST_FOLDER_CHILDREN",
@@ -27988,7 +27988,7 @@
27988 {
27989 "slug": "ONE_DRIVE_LIST_ROOT_DRIVE_CHANGES",
27990 "name": "List Root Drive Changes",
27991 - "description": "Tool to list changes in the root of the user's primary drive using a delta token. Use when you need to track file and folder modifications, additions, or deletions in the main OneDrive directory."
27991 + "description": "Tool to list changes in the root of the user's primary drive using a delta token. Use when you need to track file and folder modifications, additions, or deletions in the main OneDrive directory. First call without `token` returns all current items plus an `@odata.deltaLink`; store that token and pass it on subsequent calls to retrieve only incremental changes. Losing the deltaLink token forces a full resync. Responses include deleted items (check `deleted` property) and the root item itself alongside files and folders."
27992 },
27993 {
27994 "slug": "ONE_DRIVE_LIST_SHARE_PERMISSIONS",
@@ -28013,22 +28013,22 @@
28013 {
28014 "slug": "ONE_DRIVE_LIST_SITE_LISTS",
28015 "name": "List Site Lists",
28016 - "description": "Tool to list all lists under a specific SharePoint site. Use when you need to enumerate lists within a known site. IMPORTANT: This action only works with organizational Microsoft 365 accounts (Azure AD/Entra ID accounts). It is NOT supported for personal Microsoft accounts (MSA/Outlook.com/Hotmail accounts). Personal OneDrive users cannot access SharePoint sites through this endpoint."
28016 + "description": "Tool to list all lists under a specific SharePoint site. Use when you need to enumerate lists within a known site. Returns only Microsoft Graph-supported lists — internal/system lists are excluded, so results may be a strict subset of all site lists (e.g., 13 returned where 108 exist). Results are in the `data.value` array. IMPORTANT: Only works with organizational Microsoft 365 accounts (Azure AD/Entra ID). NOT supported for personal Microsoft accounts (MSA/Outlook.com/Hotmail). Personal OneDrive users cannot access SharePoint sites through this endpoint."
28017 },
28018 {
28019 "slug": "ONE_DRIVE_LIST_SITE_SUBSITES",
28020 "name": "List Site Subsites",
28021 - "description": "Tool to list all subsites of a SharePoint site. Use when you need to retrieve a collection of subsites for a given parent site. IMPORTANT: This action only works with organizational Microsoft 365 accounts (Azure AD/Entra ID accounts). It is NOT supported for personal Microsoft accounts (MSA/Outlook.com/Hotmail accounts). Personal OneDrive users cannot access SharePoint sites through this endpoint."
28021 + "description": "Tool to list all subsites of a SharePoint site. Use when you need to retrieve a collection of subsites for a given parent site. IMPORTANT: This action only works with organizational Microsoft 365 accounts (Azure AD/Entra ID accounts). It is NOT supported for personal Microsoft accounts (MSA/Outlook.com/Hotmail accounts). Personal OneDrive users cannot access SharePoint sites through this endpoint. An empty `value` array in the response means the site has no subsites, not a failure."
28022 },
28023 {
28024 "slug": "ONE_DRIVE_LIST_SUBSCRIPTIONS",
28025 "name": "List Subscriptions",
28026 - "description": "Tool to list the current subscriptions for the authenticated user or app. Use this to retrieve details of existing webhook subscriptions."
28026 + "description": "Tool to list the current subscriptions for the authenticated user or app. Use this to retrieve details of existing webhook subscriptions. Results may span multiple drives and resources; filter client-side by resource URL or type to narrow to a specific scope. An empty `value` array means no subscriptions exist, not a failed call."
28027 },
28028 {
28029 "slug": "ONE_DRIVE_MOVE_ITEM",
28030 "name": "Move Item",
28031 - "description": "Tool to move a file or folder to a new parent folder in OneDrive. Use when you need to reorganize your files or folders by changing their location. You can optionally rename the item during the move."
28031 + "description": "Tool to move a file or folder to a new parent folder in OneDrive. Use when you need to reorganize your files or folders by changing their location. You can optionally rename the item during the move. If a file with the same name exists at the destination, the API returns `nameAlreadyExists`; use the `name` parameter to provide a unique name or resolve the conflict beforehand."
28032 },
28033 {
28034 "slug": "ONE_DRIVE_ONEDRIVE_CREATE_FOLDER",
@@ -28038,22 +28038,22 @@
28038 {
28039 "slug": "ONE_DRIVE_ONEDRIVE_CREATE_TEXT_FILE",
28040 "name": "Create a new text file",
28041 - "description": "Creates a new text file with specified content in the authenticated user's personal OneDrive, using either the folder's unique ID or its absolute path relative to the user's OneDrive root (paths are automatically resolved to IDs); note that OneDrive may rename or create a new version if the filename already exists. This action only works with the user's personal OneDrive (/me/drive) and does not support SharePoint document libraries or shared drives."
28041 + "description": "Creates a new plain-text file with specified content in the authenticated user's personal OneDrive, using either the folder's unique ID or its absolute path relative to the user's OneDrive root (paths are automatically resolved to IDs); note that OneDrive may rename or create a new version if the filename already exists. All files are written as plain text regardless of extension — specifying .docx or .xlsx does not produce a true Office document. This action only works with the user's personal OneDrive (/me/drive) and does not support SharePoint document libraries or shared drives."
28042 },
28043 {
28044 "slug": "ONE_DRIVE_ONEDRIVE_FIND_FILE",
28045 "name": "Find Item",
28046 - "description": "Non-recursively finds an item (file or folder) in a specified OneDrive folder; if `folder` is provided as a path, it must actually exist."
28046 + "description": "Non-recursively finds an item (file or folder) in a specified OneDrive folder; if `folder` is provided as a path, it must actually exist. Results in large folders may be paginated via `@odata.nextLink`; iterate all pages to avoid missing files. For searches where the subfolder is unknown, use ONE_DRIVE_SEARCH_ITEMS instead."
28047 },
28048 {
28049 "slug": "ONE_DRIVE_ONEDRIVE_FIND_FOLDER",
28050 "name": "Find Folder",
28051 - "description": "Finds folders by name within an accessible parent folder in OneDrive, or lists all its direct child folders if no name is specified."
28051 + "description": "Finds folders by name within an accessible parent folder in OneDrive, or lists all its direct child folders if no name is specified. Search is non-recursive: only immediate children of `folder` are checked, not deeper hierarchy levels."
28052 },
28053 {
28054 "slug": "ONE_DRIVE_ONEDRIVE_LIST_ITEMS",
28055 "name": "List OneDrive items",
28056 - "description": "Retrieves all files and folders as `driveItem` resources from the root of a specified user's OneDrive, automatically handling pagination."
28056 + "description": "Retrieves all files and folders as `driveItem` resources from the root of a specified user's OneDrive, automatically handling pagination. Non-recursive: returns only root-level items; subfolder contents require separate calls. Results may include `remoteItem` pointers (shared items from other drives) — use `remoteItem.driveId` and `remoteItem.id` for those in downstream calls. Distinguish files from folders by presence of `file` or `folder` property. Always use `id` values returned by this tool directly; never construct item IDs manually. Items may be absent from results due to permission restrictions, not drive absence."
28057 },
28058 {
28059 "slug": "ONE_DRIVE_ONEDRIVE_UPLOAD_FILE",
@@ -28063,7 +28063,7 @@
28063 {
28064 "slug": "ONE_DRIVE_PREVIEW_DRIVE_ITEM",
28065 "name": "Preview Drive Item",
28066 - "description": "Generates or retrieves a short-lived embeddable URL for a preview of a specific item. Use when you need to display a temporary preview of a file."
28066 + "description": "Generates or retrieves a short-lived, permission-bound embeddable URL for a preview of a specific item. URLs expire and must be regenerated per session — do not cache. Use when you need to display a temporary preview of a file."
28067 },
28068 {
28069 "slug": "ONE_DRIVE_RESTORE_DRIVE_ITEM",
@@ -28073,7 +28073,7 @@
28073 {
28074 "slug": "ONE_DRIVE_SEARCH_ITEMS",
28075 "name": "Search Items",
28076 - "description": "Search OneDrive for files and folders by keyword. Searches filenames, metadata, and file content to find matching items. Use when you need to find specific files based on keywords, file types, or content (e.g., 'Find all PDFs containing budget'). Supports filtering, sorting, and pagination."
28076 + "description": "Search OneDrive for files and folders by keyword. Searches filenames, metadata, and file content to find matching items. Use when you need to find specific files based on keywords, file types, or content. Supports filtering, sorting, and pagination. Results are mixed files and folders — filter client-side using file vs folder properties. Disambiguate similarly named items using parentReference.path, lastModifiedDateTime, and size before passing item IDs downstream. Newly created or recently moved files may not appear due to indexing delays; fall back to ONE_DRIVE_LIST_FOLDER_CHILDREN if expected items are missing. No server-side date filtering — apply lastModifiedDateTime/createdDateTime filtering in your own logic. HTTP 429 responses include a Retry-After header; use exponential backoff."
28077 },
28078 {
28079 "slug": "ONE_DRIVE_UNFOLLOW_ITEM",
@@ -28205,7 +28205,7 @@
28205 ],
28206 "toolCount": 339,
28207 "triggerCount": 0,
28208 - "version": "20260313_00",
28208 + "version": "20260316_00",
28209 "tools": [
28210 {
28211 "slug": "DOCUSIGN_ADD_CONTACTS_TO_CONTACTS_LIST",
@@ -29745,7 +29745,7 @@
29745 {
29746 "slug": "DOCUSIGN_UPDATE_ENVELOPE_DOC_GEN_FORM_FIELDS",
29747 "name": "Update Envelope DocGen Form Fields",
29748 - "description": "This method dynamically generates an envelope's documents by populating its sender fields. The envelope must be in a draft state. Use the DocumentGeneration::getEnvelopeDocGenFormFields response to retrieve the list of sender fields for your envelope. Use that list to build the request for this method. For each field, specify the field name and the value to populate. Important notes: - If update_docgen_formfields_only is false (the default), the documentId changes after the update. - This endpoint does not validate number, date, or select data field values. The request can succeed even if a number or date field value is not a valid number or date, or if a select field value is not one of the allowed values."
29748 + "description": "This method dynamically generates an envelope's documents by populating its sender fields. The envelope must be in a draft state. Use the DocumentGeneration::getEnvelopeDocGenFormFields response to retrieve the list of sender fields for your envelope. Use that list to build the request for this method. For each field, specify the field name and the value to populate. Important notes: - If update_docgen_formfields_only is false (the default), the documentId changes after the update. - This endpoint does not validate number, date, or select data field values. The request can succeed even if a number or date field value is not a valid number or date, or if a select field value is not one of the allowed values. The envelope's template must be configured with document generation capabilities; this method has no effect on standard envelopes without doc-gen templates."
29749 },
29750 {
29751 "slug": "DOCUSIGN_UPDATE_ENVELOPE_EMAIL_SETTINGS",
@@ -30887,7 +30887,7 @@
30887 ],
30888 "toolCount": 225,
30889 "triggerCount": 7,
30890 - "version": "20260312_00",
30890 + "version": "20260316_00",
30891 "tools": [
30892 {
30893 "slug": "SALESFORCE_ACCOUNT_CREATION_WITH_CONTENT_TYPE_OPTION",
@@ -30897,12 +30897,12 @@
30897 {
30898 "slug": "SALESFORCE_ADD_CONTACT_TO_CAMPAIGN",
30899 "name": "Add contact to campaign",
30900 - "description": "Adds a contact to a campaign by creating a CampaignMember record, allowing you to track campaign engagement."
30900 + "description": "Adds a contact to a campaign by creating a CampaignMember record to track campaign engagement. Fails if the contact is already a member of the campaign; pre-check membership via SOQL before calling."
30901 },
30902 {
30903 "slug": "SALESFORCE_ADD_LEAD_TO_CAMPAIGN",
30904 "name": "Add lead to campaign",
30905 - "description": "Adds a lead to a campaign by creating a CampaignMember record, allowing you to track campaign engagement."
30905 + "description": "Adds a lead to a campaign by creating a CampaignMember record, allowing you to track campaign engagement. Both `campaign_id` and `lead_id` must be valid Salesforce IDs of active, existing records — names or emails cannot be substituted, and deleted or inactive records will cause the call to fail. This is a persistent CRM write; confirm the correct lead and campaign before calling."
30906 },
30907 {
30908 "slug": "SALESFORCE_ADD_OPPORTUNITY_LINE_ITEM",
@@ -30912,12 +30912,12 @@
30912 {
30913 "slug": "SALESFORCE_APPLY_LEAD_ASSIGNMENT_RULES",
30914 "name": "Apply lead assignment rules",
30915 - "description": "Applies configured lead assignment rules to a specific lead, automatically routing it to the appropriate owner based on your organization's rules."
30915 + "description": "Applies configured lead assignment rules to a specific lead, automatically routing it to the appropriate owner based on your organization's rules. Allow a brief propagation delay before querying updated ownership or field values after rule application."
30916 },
30917 {
30918 "slug": "SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT",
30919 "name": "Associate contact to account",
30920 - "description": "Associates a contact with an account by updating the contact's AccountId field."
30920 + "description": "Associates a contact with an account by updating the contact's AccountId field. Overwrites any existing AccountId on the contact. For broader contact field updates alongside the account association, use SALESFORCE_UPDATE_CONTACT instead."
30921 },
30922 {
30923 "slug": "SALESFORCE_CLONE_OPPORTUNITY_WITH_PRODUCTS",
@@ -30947,7 +30947,7 @@
30947 {
30948 "slug": "SALESFORCE_CREATE_ACCOUNT",
30949 "name": "Create account",
30950 - "description": "Creates a new account in Salesforce with the specified information."
30950 + "description": "Creates a new account in Salesforce with the specified information. Returns the created Account's ID at `data.response_data.id`."
30951 },
30952 {
30953 "slug": "SALESFORCE_CREATE_A_RECORD",
@@ -30957,7 +30957,7 @@
30957 {
30958 "slug": "SALESFORCE_CREATE_CAMPAIGN",
30959 "name": "Create campaign",
30960 - "description": "Creates a new campaign in Salesforce with the specified information."
30960 + "description": "Creates a new campaign in Salesforce. Only `name` is universally required, but org-level validation rules commonly enforce `type`, `status`, `start_date`, and `end_date` as well — omitting them may cause creation to fail."
30961 },
30962 {
30963 "slug": "SALESFORCE_CREATE_CAMPAIGN_RECORD_VIA_POST",
@@ -30967,7 +30967,7 @@
30967 {
30968 "slug": "SALESFORCE_CREATE_CONTACT",
30969 "name": "Create contact",
30970 - "description": "Creates a new contact in Salesforce with the specified information."
30970 + "description": "Creates a new contact in Salesforce with the specified information. Writes to live CRM data — obtain explicit user confirmation before executing. Failures may reflect org-specific validation rules, permission restrictions, or duplicate rules rather than invalid inputs."
30971 },
30972 {
30973 "slug": "SALESFORCE_CREATE_CUSTOM_FIELD",
@@ -30982,7 +30982,7 @@
30982 {
30983 "slug": "SALESFORCE_CREATE_LEAD",
30984 "name": "Create lead",
30985 - "description": "Creates a new lead in Salesforce with the specified information."
30985 + "description": "Creates a new lead in Salesforce. `LastName` and `Company` are required. Org-level validation rules (e.g., email format, custom required fields) may reject requests beyond these; inspect the error response body for the failing field. The created lead `id` is returned in a response wrapper, not at the top level."
30986 },
30987 {
30988 "slug": "SALESFORCE_CREATE_LEAD_WITH_SPECIFIED_CONTENT_TYPE",
@@ -30997,7 +30997,7 @@
30997 {
30998 "slug": "SALESFORCE_CREATE_NOTE",
30999 "name": "Create note",
31000 - "description": "Creates a new note attached to a Salesforce record with the specified title and content."
31000 + "description": "Creates a new note attached to a Salesforce record with the specified title and content. Does not deduplicate — identical calls create duplicate notes. High-volume creation can trigger REQUEST_LIMIT_EXCEEDED; apply exponential backoff on retries."
31001 },
31002 {
31003 "slug": "SALESFORCE_CREATE_NOTE_RECORD_WITH_CONTENT_TYPE_HEADER",
@@ -31032,7 +31032,7 @@
31032 {
31033 "slug": "SALESFORCE_CREATE_TASK",
31034 "name": "Create task",
31035 - "description": "Creates a new task in Salesforce to track activities, to-dos, and follow-ups related to contacts, leads, or other records."
31035 + "description": "Creates a new task in Salesforce to track activities, to-dos, and follow-ups related to contacts, leads, or other records. Ensure who_id, what_id, and owner_id reference existing records before calling; invalid IDs cause silent linkage failures or validation errors."
31036 },
31037 {
31038 "slug": "SALESFORCE_DELETE_ACCOUNT",
@@ -31052,7 +31052,7 @@
31052 {
31053 "slug": "SALESFORCE_DELETE_CONTACT",
31054 "name": "Delete contact",
31055 - "description": "Permanently deletes a contact from Salesforce. This action cannot be undone."
31055 + "description": "Permanently deletes a contact from Salesforce. This action cannot be undone. Associated records (activities, opportunities) lose the contact reference upon deletion — ensure related data is migrated or acceptable to lose before proceeding. Returns HTTP 204 with empty body on success."
31056 },
31057 {
31058 "slug": "SALESFORCE_DELETE_FILE",
@@ -31307,7 +31307,7 @@
31307 {
31308 "slug": "SALESFORCE_GET_NOTE",
31309 "name": "Get note",
31310 - "description": "Retrieves a specific note by ID from Salesforce, returning all available fields."
31310 + "description": "Retrieves a specific note by ID from Salesforce, returning all available fields. Notes with IsPrivate=true require the integration user to have sufficient permissions; inaccessible private notes will not be returned."
31311 },
31312 {
31313 "slug": "SALESFORCE_GET_NOTE_BY_ID_WITH_FIELDS",
@@ -31387,12 +31387,12 @@
31387 {
31388 "slug": "SALESFORCE_GET_REPORT",
31389 "name": "Get report metadata",
31390 - "description": "Gets detailed metadata for a specific report including its structure, columns, filters, and groupings."
31390 + "description": "Gets detailed metadata for a specific report including its structure, columns, filters, and groupings. Only fields included in the report layout are returned; use SALESFORCE_RUN_SOQL_QUERY when specific fields outside the report layout are required."
31391 },
31392 {
31393 "slug": "SALESFORCE_GET_REPORT_INSTANCE",
31394 "name": "Get report instance results",
31395 - "description": "Gets the results of a report instance created by running a report. Check status to see if report has completed."
31395 + "description": "Gets the results of a report instance created by running a report. Poll `attributes.status` until it equals 'Success' before parsing results. Response data is nested under `factMap` and `reportExtendedMetadata`; an empty `factMap` or zero rows is a valid successful result, not an error."
31396 },
31397 {
31398 "slug": "SALESFORCE_GET_SEARCH_LAYOUT",
@@ -31612,7 +31612,7 @@
31612 {
31613 "slug": "SALESFORCE_LIST_ACCOUNTS",
31614 "name": "List accounts",
31615 - "description": "Lists accounts from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection."
31615 + "description": "Lists accounts from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection. Results paginate via nextRecordsUrl with up to ~2000 rows per page. REQUEST_LIMIT_EXCEEDED requires exponential backoff; INVALID_FIELD or INSUFFICIENT_ACCESS_OR_READONLY errors indicate profile or field-level restrictions — simplify SELECT/WHERE clauses."
31616 },
31617 {
31618 "slug": "SALESFORCE_LIST_ANALYTICS_TEMPLATES",
@@ -31622,12 +31622,12 @@
31622 {
31623 "slug": "SALESFORCE_LIST_CAMPAIGNS",
31624 "name": "List campaigns",
31625 - "description": "Lists campaigns from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection."
31625 + "description": "Lists campaigns from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection. Results returned under `response_data.records`; use `Id` (not `Name`) to identify campaigns in downstream operations."
31626 },
31627 {
31628 "slug": "SALESFORCE_LIST_CONTACTS",
31629 "name": "List contacts",
31630 - "description": "Lists contacts from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection."
31630 + "description": "Lists contacts from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection. Results are returned under `response_data.records`; check `response_data.done` and `response_data.totalSize` for pagination — use OFFSET or `nextRecordsUrl` until `done=true` to retrieve all records."
31631 },
31632 {
31633 "slug": "SALESFORCE_LIST_CUSTOM_INVOCABLE_ACTIONS",
@@ -31647,7 +31647,7 @@
31647 {
31648 "slug": "SALESFORCE_LIST_LEADS",
31649 "name": "List leads",
31650 - "description": "Lists leads from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection."
31650 + "description": "Lists leads from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection. Results are paginated; follow nextRecordsUrl in the response to retrieve subsequent pages — the first page may silently omit matching records beyond the page limit."
31651 },
31652 {
31653 "slug": "SALESFORCE_LIST_NOTES",
@@ -31657,12 +31657,12 @@
31657 {
31658 "slug": "SALESFORCE_LIST_OPPORTUNITIES",
31659 "name": "List opportunities",
31660 - "description": "Lists opportunities from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection."
31660 + "description": "Lists opportunities from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection. Results are paginated up to ~2000 rows per batch; check `done`, `totalSize`, and `nextRecordsUrl` fields to detect and retrieve additional pages, or use a SOQL `LIMIT` clause to cap results. For complex queries rejected by this tool, use `SALESFORCE_RUN_SOQL_QUERY` instead."
31661 },
31662 {
31663 "slug": "SALESFORCE_LIST_PRICEBOOK_ENTRIES",
31664 "name": "List pricebook entries",
31665 - "description": "Lists pricebook entries from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection. Use this to map product names to pricebook entry IDs needed for opportunity line items."
31665 + "description": "Lists pricebook entries from Salesforce using SOQL query, allowing flexible filtering, sorting, and field selection. Use this to map product names to pricebook entry IDs needed for opportunity line items. When using returned IDs with SALESFORCE_ADD_OPPORTUNITY_LINE_ITEM, always filter with WHERE IsActive = true — inactive entries cause REQUIRED_FIELD_MISSING or INVALID_CROSS_REFERENCE_KEY errors."
31666 },
31667 {
31668 "slug": "SALESFORCE_LIST_PRICEBOOKS",
@@ -31692,12 +31692,12 @@
31692 {
31693 "slug": "SALESFORCE_LOG_EMAIL_ACTIVITY",
31694 "name": "Log email activity",
31695 - "description": "Creates an EmailMessage record to log email activity in Salesforce, associating it with related records."
31695 + "description": "Creates an EmailMessage record to log email activity in Salesforce, associating it with related records. Requires EmailMessage insert permissions enabled at the org level; some orgs block this entirely."
31696 },
31697 {
31698 "slug": "SALESFORCE_MASS_TRANSFER_OWNERSHIP",
31699 "name": "Mass transfer ownership",
31700 - "description": "Transfers ownership of multiple records to a new owner in a single operation using Salesforce's composite API for better performance."
31700 + "description": "Transfers ownership of multiple records to a new owner in a single operation using Salesforce's composite API for better performance. Operation has no rollback; all provided records are reassigned immediately."
31701 },
31702 {
31703 "slug": "SALESFORCE_PARAMETERIZED_SEARCH",
@@ -31822,7 +31822,7 @@
31822 {
31823 "slug": "SALESFORCE_RUN_REPORT",
31824 "name": "Run report",
31825 - "description": "Runs a report and returns the results. Creates a report instance that can be checked for completion."
31825 + "description": "Runs a report and returns the results. Creates a report instance that can be checked for completion. Results are returned in a nested structure (factMap, reportExtendedMetadata), not a flat record list; an empty factMap/rows is a valid result. Avoid repeated calls when freshness allows — reuse an existing instance_id instead."
31826 },
31827 {
31828 "slug": "SALESFORCE_RUN_SOQL_QUERY",
@@ -31837,17 +31837,17 @@
31837 {
31838 "slug": "SALESFORCE_SEARCH_ACCOUNTS",
31839 "name": "Search accounts",
31840 - "description": "Search for Salesforce accounts using multiple criteria like name, industry, type, location, or contact information."
31840 + "description": "Search for Salesforce accounts using criteria like name, industry, type, location, or contact information. Always provide at least one filter parameter; omitting all filters returns a broad, slow listing. Owner/territory filtering is unsupported — use SALESFORCE_RUN_SOQL_QUERY for ownership-based filters. Use SALESFORCE_GET_ACCOUNT to fetch complete field data for a specific record. Unsupported filter fields may be silently ignored — verify results reflect intended criteria."
31841 },
31842 {
31843 "slug": "SALESFORCE_SEARCH_CAMPAIGNS",
31844 "name": "Search campaigns",
31845 - "description": "Search for Salesforce campaigns using multiple criteria like name, type, status, date range, or active status. Requires access to the Campaign object (Marketing User feature must be enabled in the org)."
31845 + "description": "Search for Salesforce campaigns using multiple criteria like name, type, status, date range, or active status. Requires access to the Campaign object (Marketing User feature must be enabled in the org). For complex sorting (multi-field ORDER BY), use SALESFORCE_RUN_SOQL_QUERY instead."
31846 },
31847 {
31848 "slug": "SALESFORCE_SEARCH_CONTACTS",
31849 "name": "Search contacts",
31850 - "description": "Search for Salesforce contacts using multiple criteria like name, email, phone, account, or title."
31850 + "description": "Search Salesforce Contact records (not Leads — use SALESFORCE_SEARCH_LEADS for those) using name, email, phone, account, or title. All parameters support partial/fuzzy matching, so results may include unrelated records; post-filter client-side for exact matches. Partial matches and common names can return multiple contacts — always confirm the correct contact by its 18-character Id before passing to write operations like SALESFORCE_LOG_CALL or SALESFORCE_CREATE_TASK. A response with totalSize=0 is a valid 'not found' outcome. Provide at least one search criterion; omitting all returns a broad, slow result set. Returned Ids are 18-character strings and must be used as-is in downstream tools."
31851 },
31852 {
31853 "slug": "SALESFORCE_SEARCH_KNOWLEDGE_ARTICLES",
@@ -31857,27 +31857,27 @@
31857 {
31858 "slug": "SALESFORCE_SEARCH_LEADS",
31859 "name": "Search leads",
31860 - "description": "Search for Salesforce leads using multiple criteria like name, email, phone, company, title, status, or lead source."
31860 + "description": "Search for Salesforce leads using criteria like name, email, phone, company, title, status, or lead source. At least one search criterion should be provided — omitting all parameters results in a broad, slow listing of arbitrary records. Partial matches on name, email, and company may return multiple candidates; confirm Email or Company field values before using a lead ID in downstream operations."
31861 },
31862 {
31863 "slug": "SALESFORCE_SEARCH_NOTES",
31864 "name": "Search notes",
31865 - "description": "Search for Salesforce notes using multiple criteria like title, body content, parent record, owner, or creation date."
31865 + "description": "Search for Salesforce notes using multiple criteria like title, body content, parent record, owner, or creation date. Provide at least one filter criterion — omitting all filters returns a broad, slow, noisy listing."
31866 },
31867 {
31868 "slug": "SALESFORCE_SEARCH_OPPORTUNITIES",
31869 "name": "Search opportunities",
31870 - "description": "Search for Salesforce opportunities using multiple criteria like name, account, stage, amount, close date, or status."
31870 + "description": "Search for Salesforce opportunities using multiple criteria like name, account, stage, amount, close date, or status. Apply at least one filter to avoid broad result sets. Partial-match searches may return multiple similar records; verify the correct record by Id before downstream use."
31871 },
31872 {
31873 "slug": "SALESFORCE_SEARCH_TASKS",
31874 "name": "Search tasks",
31875 - "description": "Search for Salesforce tasks using multiple criteria like subject, status, priority, assigned user, related records, or dates."
31875 + "description": "Search for Salesforce tasks using multiple criteria like subject, status, priority, assigned user, related records, or dates. Always provide at least one filter criterion — no filters produces broad, slow results. For complex filtering not supported here, use SALESFORCE_RUN_SOQL_QUERY."
31876 },
31877 {
31878 "slug": "SALESFORCE_SEND_EMAIL",
31879 "name": "Send email",
31880 - "description": "Sends an email through Salesforce with options for recipients, attachments, and activity logging."
31880 + "description": "Sends an email through Salesforce with options for recipients, attachments, and activity logging. Can partially succeed — check per-recipient success/failure status rather than treating the call as all-or-nothing. For large recipient lists, use SALESFORCE_SEND_MASS_EMAIL instead."
31881 },
31882 {
31883 "slug": "SALESFORCE_SEND_EMAIL_FROM_TEMPLATE",
@@ -31887,7 +31887,7 @@
31887 {
31888 "slug": "SALESFORCE_SEND_MASS_EMAIL",
31889 "name": "Send mass email",
31890 - "description": "Sends bulk emails to multiple recipients, either using a template or custom content. Processes in batches for better performance."
31890 + "description": "Sends bulk emails to multiple recipients immediately and irreversibly using a template or custom content. Requires either a valid template_id or both subject and body; omitting all three causes errors. Processes in batches for performance. Check failedRecipients and summary.failureCount in the response even when success=true, as individual recipient failures can occur without an overall failure."
31891 },
31892 {
31893 "slug": "SALESFORCE_SET_USER_PASSWORD",
@@ -31932,7 +31932,7 @@
31932 {
31933 "slug": "SALESFORCE_UPDATE_CONTACT",
31934 "name": "Update contact",
31935 - "description": "Updates an existing contact in Salesforce with the specified changes. Only provided fields will be updated."
31935 + "description": "Updates an existing contact in Salesforce with the specified changes. Only provided fields will be updated. Returns HTTP 204 with no body on success; use SALESFORCE_GET_CONTACT to verify applied changes. Org-level validation rules, duplicate rules, or field-level permissions may reject correctly formatted requests with HTTP 400; inspect the error response to identify the constraint."
31936 },
31937 {
31938 "slug": "SALESFORCE_UPDATE_CONTACT_BY_ID",
@@ -31967,7 +31967,7 @@
31967 {
31968 "slug": "SALESFORCE_UPDATE_OPPORTUNITY",
31969 "name": "Update opportunity",
31970 - "description": "Updates an existing opportunity in Salesforce with the specified changes. Only provided fields will be updated."
31970 + "description": "Updates an existing opportunity in Salesforce with the specified changes. Only provided fields will be updated. Returns HTTP 204 with empty body on success; call SALESFORCE_GET_OPPORTUNITY afterward to read updated values. Updates may fail with FIELD_CUSTOM_VALIDATION_EXCEPTION or REQUIRED_FIELD_MISSING — inspect the error message to identify the offending field."
31971 },
31972 {
31973 "slug": "SALESFORCE_UPDATE_OPPORTUNITY_BY_ID",
@@ -32134,7 +32134,7 @@
32134 ],
32135 "toolCount": 55,
32136 "triggerCount": 0,
32137 - "version": "20260312_00",
32137 + "version": "20260316_00",
32138 "tools": [
32139 {
32140 "slug": "CALENDLY_CANCEL_SCHEDULED_EVENT",
@@ -32319,7 +32319,7 @@
32319 {
32320 "slug": "CALENDLY_LIST_EVENT_TYPES",
32321 "name": "List Event Types",
32322 - "description": "Tool to list all Event Types associated with a specified User or Organization. Use when you need to retrieve event types for a user or organization."
32322 + "description": "Tool to list all Event Types associated with a specified User or Organization. Use when you need to retrieve event types for a user or organization. Use scheduling_url from results directly; do not manually construct event type URLs."
32323 },
32324 {
32325 "slug": "CALENDLY_LIST_GROUP_RELATIONSHIPS",
@@ -32478,7 +32478,7 @@
32478 ],
32479 "toolCount": 329,
32480 "triggerCount": 5,
32481 - "version": "20260312_00",
32481 + "version": "20260316_00",
32482 "tools": [
32483 {
32484 "slug": "TRELLO_ADD_BOARDS",
@@ -33043,7 +33043,7 @@
33043 {
33044 "slug": "TRELLO_GET_CARDS_CUSTOM_FIELD_ITEMS_BY_ID_CARD",
33045 "name": "Get card custom field items",
33046 - "description": "Tool to retrieve a card's customFieldItems array. Use when you need structured metadata from custom fields for automation."
33046 + "description": "Tool to retrieve a card's customFieldItems array. Use when you need structured metadata from custom fields for automation. Must be called per card — no bulk endpoint exists. Returns an empty array if no custom fields are populated on the card. Power-Up data (e.g., time tracking) is not included in customFieldItems."
33047 },
33048 {
33049 "slug": "TRELLO_GET_CARDS_LIST_BY_ID_CARD",
@@ -34215,22 +34215,22 @@
34215 ],
34216 "toolCount": 48,
34217 "triggerCount": 0,
34218 - "version": "20260312_00",
34218 + "version": "20260316_00",
34219 "tools": [
34220 {
34221 "slug": "APOLLO_ADD_CONTACTS_TO_SEQUENCE",
34222 "name": "Add Contacts to Sequence",
34223 - "description": "Adds contacts to a specified Apollo email sequence and returns the contact details."
34223 + "description": "Adds contacts to a specified Apollo email sequence and returns the contact details. `sequence_id`, `emailer_campaign_id`, and `send_email_from_email_account_id` must be retrieved from Apollo listing/search endpoints before calling this tool — these IDs cannot be inferred from names."
34224 },
34225 {
34226 "slug": "APOLLO_BULK_ORGANIZATION_ENRICHMENT",
34227 "name": "Bulk organization enrichment",
34228 - "description": "Enriches data for up to 10 organizations simultaneously by providing a list of their base company domains (e.g., 'apollo.io', not 'www.apollo.io')."
34228 + "description": "Enriches data for up to 10 organizations simultaneously by providing a list of their base company domains (e.g., 'apollo.io', not 'www.apollo.io'). Each call consumes Apollo credits per domain enriched; monitor quota to avoid exhaustion errors."
34229 },
34230 {
34231 "slug": "APOLLO_BULK_PEOPLE_ENRICHMENT",
34232 "name": "Bulk people enrichment",
34233 - "description": "Use to enrich multiple person profiles simultaneously with comprehensive data from Apollo's database."
34233 + "description": "Use to enrich multiple person profiles simultaneously with comprehensive data from Apollo's database. Each call consumes Apollo credits; avoid re-enriching the same contacts. Responses may include null or missing fields (e.g., email, phone, organization); treat unmatched records as valid 'no match' outcomes, not errors. Heavy use may trigger HTTP 429; respect Retry-After headers."
34234 },
34235 {
34236 "slug": "APOLLO_BULK_UPDATE_ACCOUNT_STAGE",
@@ -34240,7 +34240,7 @@
34240 {
34241 "slug": "APOLLO_CREATE_ACCOUNT",
34242 "name": "Create an Apollo account",
34243 - "description": "Creates a new account in Apollo.io; a new record is created even if a similar account exists, and provided `owner_id` or `account_stage_id` must be valid existing IDs."
34243 + "description": "Creates a new account in Apollo.io; a new record is created even if a similar account exists, and provided `owner_id` or `account_stage_id` must be valid existing IDs. The response includes the new account's ID, which can be used directly in subsequent calls."
34244 },
34245 {
34246 "slug": "APOLLO_CREATE_BULK_ACCOUNTS",
@@ -34260,7 +34260,7 @@
34260 {
34261 "slug": "APOLLO_CREATE_CONTACT",
34262 "name": "Create Apollo contact",
34263 - "description": "Creates a new contact in Apollo.io; use `account_id` to link to an organization and `contact_stage_id` for sales stage, noting that Apollo does not perform automatic deduplication."
34263 + "description": "Creates a new contact in Apollo.io; use `account_id` to link to an organization and `contact_stage_id` for sales stage. Apollo does not auto-deduplicate — duplicate records sharing the same email are silently created; always search via APOLLO_SEARCH_CONTACTS before calling this tool. Requires explicit user confirmation before execution."
34264 },
34265 {
34266 "slug": "APOLLO_CREATE_CUSTOM_FIELD",
@@ -34270,7 +34270,7 @@
34270 {
34271 "slug": "APOLLO_CREATE_DEAL",
34272 "name": "Create Apollo deal",
34273 - "description": "Creates a new sales opportunity (deal) in Apollo.io; all provided IDs (`owner_id`, `account_id`, `opportunity_stage_id`) must be valid existing Apollo identifiers."
34273 + "description": "Creates a new sales opportunity (deal) in Apollo.io; all provided IDs (`owner_id`, `account_id`, `opportunity_stage_id`) must be valid existing Apollo identifiers. This action has persistent side effects — obtain explicit user confirmation before invoking."
34274 },
34275 {
34276 "slug": "APOLLO_CREATE_TASK",
@@ -34300,7 +34300,7 @@
34300 {
34301 "slug": "APOLLO_GET_LABELS",
34302 "name": "Get Labels",
34303 - "description": "Retrieves all labels from Apollo.io, used for organizing contacts and accounts."
34303 + "description": "Retrieves all labels from Apollo.io, used for organizing contacts and accounts. Call this before APOLLO_CREATE_CONTACT or APOLLO_UPDATE_ACCOUNT to validate label values against the returned list; mismatched labels cause 400/422 errors."
34304 },
34305 {
34306 "slug": "APOLLO_GET_OPPORTUNITY_STAGES",
@@ -34320,7 +34320,7 @@
34320 {
34321 "slug": "APOLLO_GET_TYPED_CUSTOM_FIELDS",
34322 "name": "Get typed custom fields",
34323 - "description": "Retrieves all typed custom field definitions available in the Apollo.io instance, detailing their types and configurations."
34323 + "description": "Retrieves all typed custom field definitions available in the Apollo.io instance, detailing their types and configurations. Call before constructing payloads for APOLLO_UPDATE_CONTACT or APOLLO_UPDATE_ACCOUNT — mismatched types or invalid enum options cause 400 errors."
34324 },
34325 {
34326 "slug": "APOLLO_LIST_ACCOUNT_STAGES",
@@ -34350,27 +34350,27 @@
34350 {
34351 "slug": "APOLLO_LIST_USERS",
34352 "name": "List Apollo Users",
34353 - "description": "Retrieves a list of all users (teammates) associated with the Apollo account, supporting pagination via `page` and `per_page` parameters."
34353 + "description": "Retrieves a list of all users (teammates) associated with the Apollo account, supporting pagination via `page` and `per_page` parameters. Use this to obtain numeric user IDs required by operations like APOLLO_UPDATE_CONTACT_OWNERSHIP — names or email addresses are not accepted in place of these IDs."
34354 },
34355 {
34356 "slug": "APOLLO_ORGANIZATION_ENRICHMENT",
34357 "name": "Enrich organization data",
34358 - "description": "Fetches comprehensive organization enrichment data from Apollo.io for a given company domain; results are most meaningful if the company exists in Apollo's database."
34358 + "description": "Fetches comprehensive organization enrichment data from Apollo.io for a given company domain; results are most meaningful if the company exists in Apollo's database. Each call consumes Apollo credits and may be unavailable on free plans. Returns HTTP 429 under burst usage; use exponential backoff on retries."
34359 },
34360 {
34361 "slug": "APOLLO_ORGANIZATION_SEARCH",
34362 "name": "Search organizations in Apollo",
34363 - "description": "Searches Apollo's database for organizations using various filters; consumes credits (unavailable on free plans), retrieves a maximum of 50,000 records, and uses `page` (1-500) and `per_page` (1-100) for pagination."
34363 + "description": "Searches Apollo's database for organizations using various filters; consumes credits on every call (unavailable on free plans) — avoid re-running identical queries and surface quota errors rather than retrying. Retrieves a maximum of 50,000 records; uses `page` (1-500) and `per_page` (1-100) for pagination — check `total_pages` in the response to iterate. Overly strict filter combinations can return zero results; start broad and narrow iteratively. Empty results and `org_not_found` are valid outcomes, not errors."
34364 },
34365 {
34366 "slug": "APOLLO_PEOPLE_ENRICHMENT",
34367 "name": "Enrich person with Apollo",
34368 - "description": "Enriches and retrieves information for a person from Apollo.io. Requires one of: `id`, `email`, `hashed_email`, `linkedin_url`, or (`first_name` and `last_name` with `organization_name` or `domain`) for matching. `webhook_url` must be provided if `reveal_phone_number` is true."
34368 + "description": "Enriches and retrieves information for a person from Apollo.io. Requires one of: `id`, `email`, `hashed_email`, `linkedin_url`, or (`first_name` and `last_name` with `organization_name` or `domain`) for matching. `webhook_url` must be provided if `reveal_phone_number` is true. Name-only inputs without `organization_name` or `domain` frequently return no matches."
34369 },
34370 {
34371 "slug": "APOLLO_PEOPLE_SEARCH",
34372 "name": "Apollo people search",
34373 - "description": "Searches Apollo's contact database for people using various filters; results are limited to 50,000 records and this action does not enrich contact data."
34373 + "description": "Searches Apollo's contact database for people using various filters; results capped at 50,000 records and does not enrich contact data. Combining multiple strict filters (organization_ids, person_titles, person_seniorities) can return zero results — start broad and narrow iteratively. Result records may have null email, phone, or organization fields."
34374 },
34375 {
34376 "slug": "APOLLO_SEARCH_ACCOUNTS",
@@ -34385,7 +34385,7 @@
34385 {
34386 "slug": "APOLLO_SEARCH_CONTACTS",
34387 "name": "Search Apollo contacts",
34388 - "description": "Searches Apollo contacts using keywords, stage IDs (from 'List Contact Stages' action), or sorting (max 50,000 records; `sort_ascending` requires `sort_by_field`)."
34388 + "description": "Searches Apollo contacts using keywords, stage IDs (from 'List Contact Stages' action), or sorting (max 50,000 records; `sort_ascending` requires `sort_by_field`). Search before creating contacts to avoid duplicates."
34389 },
34390 {
34391 "slug": "APOLLO_SEARCH_NEWS_ARTICLES",
@@ -34496,7 +34496,7 @@
34496 ],
34497 "toolCount": 37,
34498 "triggerCount": 0,
34499 - "version": "20260211_00",
34499 + "version": "20260316_00",
34500 "tools": [
34501 {
34502 "slug": "SEMRUSH_ACCOUNT_UNITS_BALANCE",
@@ -34506,7 +34506,7 @@
34506 {
34507 "slug": "SEMRUSH_ADS_COPIES",
34508 "name": "Get ad copies",
34509 - "description": "Retrieves unique ad copies Semrush has observed for a specified domain from a regional database, detailing ads seen in Google's paid search results."
34509 + "description": "Retrieves unique ad copies Semrush has observed for a specified domain from a regional database, detailing ads seen in Google's paid search results. Results are a sampled subset, not a complete picture of the domain's advertising. Response is returned as a CSV-like string; parse columns (e.g., Tt, Ds) using the pipe or semicolon delimiter."
34510 },
34511 {
34512 "slug": "SEMRUSH_ANCHORS",
@@ -34521,12 +34521,12 @@
34521 {
34522 "slug": "SEMRUSH_BACKLINKS",
34523 "name": "Get backlinks",
34524 - "description": "Fetches backlinks for a specified domain or URL as a CSV-formatted string, allowing customization of columns, sorting, and filtering; ensure `display_limit` surpasses `display_offset` when an offset is used, and note the `urlanchor` filter may have limitations for targets with extensive backlinks."
34524 + "description": "Fetches backlinks for a specified domain or URL as a semicolon-delimited CSV string (parse with `sep=';'`); allows customization of columns, sorting, and filtering. Consumes Semrush API credits per request. Ensure `display_limit` surpasses `display_offset` when an offset is used, and note the `urlanchor` filter may have limitations for targets with extensive backlinks."
34525 },
34526 {
34527 "slug": "SEMRUSH_BACKLINKS_OVERVIEW",
34528 "name": "Backlinks overview",
34529 - "description": "Provides a CSV-formatted summary of backlinks, including Authority Score and link type breakdowns, for a specified and publicly accessible domain, root domain, or URL."
34529 + "description": "Provides a semicolon-delimited (sep=';') CSV summary of backlinks, including Authority Score and link type breakdowns, for a specified and publicly accessible domain, root domain, or URL. A result of 'ERROR 50 :: NOTHING FOUND' means the target has no data in the database and is a valid zero-result response."
34530 },
34531 {
34532 "slug": "SEMRUSH_BATCH_COMPARISON",
@@ -34536,17 +34536,17 @@
34536 {
34537 "slug": "SEMRUSH_BATCH_KEYWORD_OVERVIEW",
34538 "name": "Batch keyword overview",
34539 - "description": "Fetches a keyword overview report from a Semrush regional database for up to 100 keywords, providing metrics like search volume, CPC, and keyword difficulty."
34539 + "description": "Fetches a keyword overview report from a Semrush regional database for up to 100 keywords, providing metrics like search volume, CPC, and keyword difficulty. Response is CSV-like text (not JSON); parse accordingly. Returns literal string 'ERROR 50 :: NOTHING FOUND' for keywords with no data in the selected database — treat as zero results and fall back to SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE or SEMRUSH_KEYWORD_OVERVIEW_ALL_DATABASES for those terms."
34540 },
34541 {
34542 "slug": "SEMRUSH_BROAD_MATCH_KEYWORD",
34543 "name": "Broad match keyword",
34544 - "description": "Fetches broad match keywords for a given phrase; `display_sort` and `display_filter` parameters are defined but currently not utilized by the API call."
34544 + "description": "Fetches broad match keywords for a given phrase. Response is CSV-like text (not JSON); parse by splitting on line breaks and delimiters. `display_sort` and `display_filter` parameters are defined but currently not utilized by the API call."
34545 },
34546 {
34547 "slug": "SEMRUSH_CATEGORIES",
34548 "name": "Get categories",
34549 - "description": "Retrieves categories and their 0-1 confidence ratings for a specified domain, subdomain, or URL, with results sorted by rating."
34549 + "description": "Retrieves categories and their 0-1 confidence ratings for a specified domain, subdomain, or URL, with results sorted by rating. Response is returned as semicolon-separated text in a single 'data' field requiring parsing before use. Some niche or atypical targets may return no category data."
34550 },
34551 {
34552 "slug": "SEMRUSH_CATEGORIES_PROFILE",
@@ -34556,7 +34556,7 @@
34556 {
34557 "slug": "SEMRUSH_COMPETITORS",
34558 "name": "Get competitor data",
34559 - "description": "Retrieves a customizable CSV report of competitors for a specified target (root domain, domain, or URL) based on shared backlinks or referring domains, ensuring the target is valid and its type is correctly specified."
34559 + "description": "Retrieves a CSV-formatted report of competitors for a specified target (root domain, domain, or URL) based on shared backlinks or referring domains. Output is a CSV string; use display_limit and display_offset to paginate without silent truncation."
34560 },
34561 {
34562 "slug": "SEMRUSH_COMPETITORS_IN_ORGANIC_SEARCH",
@@ -34576,12 +34576,12 @@
34576 {
34577 "slug": "SEMRUSH_DOMAIN_ORGANIC_PAGES",
34578 "name": "Get domain organic pages",
34579 - "description": "Fetches a report on a domain's unique organic pages ranking in Google's top 100 search results, with options for specifying database, date, columns, sorting, and filtering."
34579 + "description": "Fetches a report on a domain's unique organic pages ranking in Google's top 100 search results, with options for specifying database, date, columns, sorting, and filtering. Response is semicolon-separated CSV text in a single `data` field requiring explicit parsing. The literal response `ERROR 50 :: NOTHING FOUND` means zero results for that domain/database combination, not a system error. Traffic metrics (e.g., `Tr`) are modeled estimates incompatible with first-party analytics data."
34580 },
34581 {
34582 "slug": "SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS",
34583 "name": "Get domain organic search keywords",
34584 - "description": "Retrieves organic search keywords for a domain from a specified Semrush regional database; `display_positions` must be set if `display_daily=1` for daily updates."
34584 + "description": "Retrieves organic search keywords for a domain from a specified Semrush regional database; `display_positions` must be set if `display_daily=1` for daily updates. Response is semicolon-delimited CSV text (parse with sep=';', cast numeric columns before aggregations). A response of 'ERROR 50 :: NOTHING FOUND' indicates no data for the domain in the selected database — treat as a valid zero-result."
34585 },
34586 {
34587 "slug": "SEMRUSH_DOMAIN_ORGANIC_SUBDOMAINS",
@@ -34611,22 +34611,22 @@
34611 {
34612 "slug": "SEMRUSH_INDEXED_PAGES",
34613 "name": "Get indexed pages",
34614 - "description": "Retrieves a list of indexed pages from Semrush for a specified `target` (root domain, domain, or URL) and `target_type`, ensuring `target` is publicly accessible, Semrush-analyzable, and correctly matches `target_type`."
34614 + "description": "Retrieves a list of indexed pages from Semrush for a specified `target` (root domain, domain, or URL) and `target_type`, ensuring `target` is publicly accessible, Semrush-analyzable, and correctly matches `target_type`. Returns CSV-like text output requiring parsing before structured analysis."
34615 },
34616 {
34617 "slug": "SEMRUSH_KEYWORD_DIFFICULTY",
34618 "name": "Get keyword difficulty",
34619 - "description": "Determines the Keyword Difficulty (KD) score (0-100, higher means greater difficulty) for a given phrase in a specific Semrush regional database to assess its SEO competitiveness."
34619 + "description": "Determines the Keyword Difficulty (KD) score (0-100, higher means greater difficulty) for a given phrase in a specific Semrush regional database to assess its SEO competitiveness. Returns CSV-formatted text; parse before programmatic use."
34620 },
34621 {
34622 "slug": "SEMRUSH_KEYWORD_OVERVIEW_ALL_DATABASES",
34623 "name": "Keyword overview all databases",
34624 - "description": "Fetches a keyword overview from Semrush for a specified phrase, including metrics like search volume, CPC, and competition."
34624 + "description": "Fetches a keyword overview from Semrush for a specified phrase, including metrics like search volume, CPC, and competition. Response is returned as a CSV-like string; parse headers and rows into a structured table before extracting values like Nq, Cp, or Kd."
34625 },
34626 {
34627 "slug": "SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE",
34628 "name": "Get keyword overview for one database",
34629 - "description": "Fetches a keyword summary for a specified phrase from a chosen regional database."
34629 + "description": "Fetches a keyword summary for a specified phrase from a chosen regional database. Returns CSV-like text (not JSON) with column headers matching `export_columns` codes (e.g., 'Ph', 'Nq', 'Kd'); parse headers and rows into structured data before use. A plain-text 'ERROR 50 :: NOTHING FOUND' response indicates zero results, not a transport error."
34630 },
34631 {
34632 "slug": "SEMRUSH_KEYWORDS_ADS_HISTORY",
@@ -34661,7 +34661,7 @@
34661 {
34662 "slug": "SEMRUSH_REFERRING_DOMAINS",
34663 "name": "Get referring domains",
34664 - "description": "Retrieves a report as a text string (e.g., CSV) listing domains that link to a target, with options to filter by type (not value)."
34664 + "description": "Retrieves a semicolon-delimited text report listing domains that link to a target, with options to filter by type (not value). Parse with sep=';' and cast numeric columns (e.g., backlinks_num, domain_ascore) before aggregating."
34665 },
34666 {
34667 "slug": "SEMRUSH_REFERRING_DOMAINS_BY_COUNTRY",
@@ -34676,7 +34676,7 @@
34676 {
34677 "slug": "SEMRUSH_RELATED_KEYWORDS",
34678 "name": "Find related keywords",
34679 - "description": "Call this to find related keywords (including synonyms and variations) for a target phrase in a specific regional database; `display_date` (if used for historical data) must be 'YYYYMM15' for a past month."
34679 + "description": "Call this to find related keywords (including synonyms and variations) for a target phrase in a specific regional database; `display_date` (if used for historical data) must be 'YYYYMM15' for a past month. Response is CSV-like delimited text (not JSON); parse by splitting on newlines and delimiters to extract structured rows."
34680 },
34681 {
34682 "slug": "SEMRUSH_TLD_DISTRIBUTION",
@@ -35589,7 +35589,7 @@
35589 ],
35590 "toolCount": 2,
35591 "triggerCount": 0,
35592 - "version": "20260225_00",
35592 + "version": "20260316_00",
35593 "tools": [
35594 {
35595 "slug": "WEATHERMAP_GEOCODE_LOCATION",
@@ -35599,7 +35599,7 @@
35599 {
35600 "slug": "WEATHERMAP_WEATHER",
35601 "name": "Weather Info",
35602 - "description": "Tool for querying the OpenWeatherMap API."
35602 + "description": "Tool for querying the OpenWeatherMap API. Returns current weather conditions only — no UV index, AQI, or official alerts. Timestamps are in UTC; apply the timezone offset field before grouping by local day."
35603 }
35604 ],
35605 "triggers": [],
@@ -35631,7 +35631,7 @@
35631 ],
35632 "toolCount": 506,
35633 "triggerCount": 0,
35634 - "version": "20260313_00",
35634 + "version": "20260316_00",
35635 "tools": [
35636 {
35637 "slug": "POSTHOG_ADD_DASHBOARD_COLLABORATORS_WITH_ACCESS_LEVEL",
@@ -38161,7 +38161,7 @@
38161 {
38162 "slug": "POSTHOG_WHOAMI",
38163 "name": "Get current user (whoami)",
38164 - "description": "Diagnostic tool to validate PostHog credentials and retrieve current user information. Returns the authenticated user's profile along with accessible organizations, teams, and projects. Use this to confirm API key validity and discover team/project IDs for subsequent API calls."
38164 + "description": "Diagnostic tool to validate PostHog credentials and retrieve current user information. Returns the authenticated user's profile along with accessible organizations, teams, and projects. Use this to confirm API key validity and discover team/project IDs for subsequent API calls. When multiple organizations or projects are returned, explicitly select the intended one by ID rather than defaulting to the first result."
38165 }
38166 ],
38167 "triggers": [],
@@ -38215,7 +38215,7 @@
38215 ],
38216 "toolCount": 163,
38217 "triggerCount": 0,
38218 - "version": "20260312_00",
38218 + "version": "20260316_00",
38219 "tools": [
38220 {
38221 "slug": "CLICKUP_ADD_DEPENDENCY",
@@ -38635,7 +38635,7 @@
38635 {
38636 "slug": "CLICKUP_GET_FILTERED_TEAM_TASKS",
38637 "name": "Get filtered team tasks",
38638 - "description": "Retrieves a paginated list of tasks (up to 100 per page) from a specified workspace based on various filter criteria, respecting user access permissions."
38638 + "description": "Retrieves a paginated list of tasks (up to 100 per page) from a specified workspace based on various filter criteria, respecting user access permissions. Unexpectedly missing tasks may indicate permission restrictions rather than filter issues. Task comments are not included; use CLICKUP_GET_TASK_COMMENTS for complete context. No keyword/text search is supported; filter client-side on returned results."
38639 },
38640 {
38641 "slug": "CLICKUP_GET_FOLDER",
@@ -38760,7 +38760,7 @@
38760 {
38761 "slug": "CLICKUP_GET_TASKS",
38762 "name": "Get tasks",
38763 - "description": "Retrieves tasks from a specified ClickUp list; only tasks whose home is the given list_id are returned."
38763 + "description": "Retrieves tasks from a specified ClickUp list; only tasks whose home is the given list_id are returned. Closed and archived tasks are excluded by default. Key task attributes may appear only in the response `custom_fields` array, not top-level fields. Fields like `space`, `folder`, `list`, and `custom_type` may be absent; apply null checks. High-volume paginated calls may return HTTP 429; honor the `Retry-After` header."
38764 },
38765 {
38766 "slug": "CLICKUP_GET_TASK_TEMPLATES",
@@ -39120,7 +39120,7 @@
39120 ],
39121 "toolCount": 21,
39122 "triggerCount": 0,
39123 - "version": "20260312_00",
39123 + "version": "20260316_00",
39124 "tools": [
39125 {
39126 "slug": "BREVO_CREATE_A_COMPANY",
@@ -39165,12 +39165,12 @@
39165 {
39166 "slug": "BREVO_GET_ACCOUNT_INFO",
39167 "name": "Get Account Information",
39168 - "description": "Retrieves comprehensive information about the authenticated Brevo account. This action returns account details including: - Account holder information (email, first name, last name, company name) - Complete address (street, city, zip code, country) - Plan details with credit information (type, credits remaining, start/end dates) - Relay configuration for transactional emails (enabled status and data) - Marketing Automation status and tracker key (if enabled) No input parameters are required - the action uses the authenticated account's credentials. Use this action to: - Verify account configuration and settings - Check available credits and plan type - Monitor transactional email relay status - Retrieve Marketing Automation tracker information"
39168 + "description": "Retrieves comprehensive information about the authenticated Brevo account. Returns account details including: - Account holder information (email, first name, last name, company name) - Complete address (street, city, zip code, country) - Plan details with credit information (type, credits remaining, start/end dates) - Relay configuration for transactional emails (enabled status and data) - Marketing Automation status and tracker key (if enabled) No input parameters are required - the action uses the authenticated account's credentials. Use this action to: - Verify account configuration and settings - Check available credits and plan type - Monitor transactional email relay status - Retrieve Marketing Automation tracker information. If credentials are missing or invalid, verify the Brevo connection is active before calling — retries will not resolve credential issues. If blocked by an 'unrecognised IP address' error, add the integration host's IP to the Brevo account allowlist."
39169 },
39170 {
39171 "slug": "BREVO_GET_ALL_CONTACTS",
39172 "name": "Get all contacts",
39173 - "description": "This tool retrieves all contacts from your Brevo account. It allows for pagination and filtering based on modification/creation dates, list IDs, segment IDs, and contact attributes."
39173 + "description": "This tool retrieves all contacts from your Brevo account with pagination and filtering based on modification/creation dates, list IDs, segment IDs, and contact attributes. For complete retrieval, iterate pages by incrementing `offset` by `limit` on each call until no more records are returned; a single call returns at most `limit` contacts."
39174 },
39175 {
39176 "slug": "BREVO_GET_ALL_EMAIL_TEMPLATES",
@@ -39220,7 +39220,7 @@
39220 {
39221 "slug": "BREVO_LIST_EMAIL_CAMPAIGNS",
39222 "name": "List Email Campaigns",
39223 - "description": "This tool retrieves a list of all email campaigns associated with the user's Brevo account. It allows filtering by campaign type, status, start date, and end date. The response includes the total count of campaigns and an array of campaign objects, each containing details like ID, name, subject, type, status, scheduled date/time, sender information, and optionally, campaign statistics."
39223 + "description": "This tool retrieves a list of all email campaigns associated with the user's Brevo account. It allows filtering by campaign type, status, start date, and end date. The response includes the total count of campaigns and an array of campaign objects, each containing details like ID, name, subject, type, status, scheduled date/time, sender information, and optionally, campaign statistics. A response with `count` of 0 and an empty campaigns array is a valid result, not an error."
39224 },
39225 {
39226 "slug": "BREVO_UPDATE_EMAIL_CAMPAIGN",
@@ -39318,7 +39318,7 @@
39318 ],
39319 "toolCount": 560,
39320 "triggerCount": 7,
39321 - "version": "20260312_00",
39321 + "version": "20260316_00",
39322 "tools": [
39323 {
39324 "slug": "STRIPE_ACCEPT_QUOTE",
@@ -42244,7 +42244,7 @@
42244 ],
42245 "toolCount": 225,
42246 "triggerCount": 0,
42247 - "version": "20260313_00",
42247 + "version": "20260316_00",
42248 "tools": [
42249 {
42250 "slug": "KLAVIYO_ADD_PROFILE_TO_LIST",
@@ -45071,7 +45071,7 @@
45071 ],
45072 "toolCount": 111,
45073 "triggerCount": 0,
45074 - "version": "20260312_00",
45074 + "version": "20260316_00",
45075 "tools": [
45076 {
45077 "slug": "ATTIO_ASSERT_COMPANY",
@@ -45276,7 +45276,7 @@
45276 {
45277 "slug": "ATTIO_GET_OBJECT",
45278 "name": "Get Object",
45279 - "description": "Tool to get a single object by its object_id or slug. Use when you need to retrieve detailed information about a specific object type in the Attio workspace."
45279 + "description": "Tool to get a single object by its object_id or slug. Use to retrieve detailed schema information about a specific object type in the Attio workspace. Also use as a prerequisite validation step before calling ATTIO_FIND_RECORD, ATTIO_LIST_RECORDS, or ATTIO_CREATE_RECORD — attribute slugs must exactly match what this tool returns. The returned schema defines required attributes for record creation; omitting them causes invalid_request_error with code missing_value (HTTP 400). Custom attributes (e.g., industry, category) vary by object type — verify their presence and data type here before building filters or record values."
45280 },
45281 {
45282 "slug": "ATTIO_GET_RECORD",
@@ -45401,7 +45401,7 @@
45401 {
45402 "slug": "ATTIO_LIST_LISTS",
45403 "name": "List Lists",
45404 - "description": "This tool retrieves all lists available in the Attio workspace. The lists are returned sorted as they appear in the sidebar. This tool is essential for managing and navigating lists, and is a prerequisite for many list-related operations. It requires the list_configuration:read permission scope."
45404 + "description": "This tool retrieves all lists available in the Attio workspace, sorted as they appear in the sidebar. Returns list metadata only (names, IDs, configuration) — not the records/entries within those lists. To fetch actual list entries, use ATTIO_FIND_RECORD with appropriate filters. This tool is a prerequisite for many list-related operations. Requires the list_configuration:read permission scope."
45405 },
45406 {
45407 "slug": "ATTIO_LIST_MEETINGS",
@@ -45416,7 +45416,7 @@
45416 {
45417 "slug": "ATTIO_LIST_OBJECTS",
45418 "name": "List Objects",
45419 - "description": "This tool retrieves a list of all available objects (both system-defined and user-defined) in the Attio workspace. It makes a GET request to the /v2/objects endpoint and returns a JSON response containing key metadata about each object, which is fundamental for understanding and accessing the workspace's structure."
45419 + "description": "This tool retrieves a list of all available objects (both system-defined and user-defined) in the Attio workspace via GET /v2/objects, returning key metadata including slugs and IDs for each object. Call this tool first before ATTIO_LIST_RECORDS, ATTIO_FIND_RECORD, or ATTIO_CREATE_RECORD to discover valid object slugs — hardcoded slugs may not exist across workspaces. Concepts like tasks may be modeled as deals or custom objects rather than dedicated types, so confirm the correct object type before proceeding. Attribute values in responses can be arrays of time-bounded entries rather than simple scalars; downstream code must handle nested structures."
45420 },
45421 {
45422 "slug": "ATTIO_LIST_PEOPLE_ATTRIBUTE_VALUES",
@@ -45441,7 +45441,7 @@
45441 {
45442 "slug": "ATTIO_LIST_RECORDS",
45443 "name": "List Records",
45444 - "description": "This tool lists records from a specific object type in Attio. It provides simple pagination support and returns records in the order they were created. For complex filtering, use the FindRecord action instead. Standard object types include: people, companies, deals, users, workspaces. If you get a 404 error, verify the object type exists using the List Objects action first."
45444 + "description": "This tool lists records from a specific object type in Attio. It provides simple pagination support and returns records in creation order (oldest first). For complex filtering, use the FindRecord action instead. Standard object types include: people, companies, deals, users, workspaces. If you get a 404 error, verify the object type exists using the List Objects action first. Response attribute values are returned as arrays of time-bounded objects under a `values` map (e.g., `values['name']`), not simple scalars — handle arrays, nested objects, and empty arrays accordingly. Select attributes are accessed via `option.title`; currency, stage, and select fields may be null or empty arrays. Access records via `data.data` in the response."
45445 },
45446 {
45447 "slug": "ATTIO_LIST_THREADS",
@@ -45695,12 +45695,12 @@
45695 ],
45696 "toolCount": 17,
45697 "triggerCount": 0,
45698 - "version": "20260312_00",
45698 + "version": "20260316_00",
45699 "tools": [
45700 {
45701 "slug": "GOOGLEMEET_CREATE_MEET",
45702 "name": "Create Google Meet Space",
45703 - "description": "Creates a new Google Meet space with optional configuration. Use when you need to create a meeting space with specific settings like access controls, moderation, recording, or transcription options."
45703 + "description": "Creates a new Google Meet space with optional configuration. Does not attach to any calendar event — calendar linking requires a separate Calendar tool call. Capture `meetingUri`, `meetingCode`, and `space.name` from the response immediately for downstream lookups. Requires `meetings.space.created` OAuth scope. Returns HTTP 429 under rapid calls; apply exponential backoff. Use when you need a meeting space with specific access controls, moderation, recording, or transcription settings."
45704 },
45705 {
45706 "slug": "GOOGLEMEET_CREATE_SPACE",
@@ -45710,7 +45710,7 @@
45710 {
45711 "slug": "GOOGLEMEET_END_ACTIVE_CONFERENCE",
45712 "name": "End active conference",
45713 - "description": "Ends an active conference in a Google Meet space. REQUIRES 'space_name' parameter (e.g., 'spaces/jQCFfuBOdN5z' or just 'jQCFfuBOdN5z'). Use when you need to terminate an ongoing conference in a specified space. This operation only succeeds if a conference is actively running in the space. You must always provide the space_name to identify which space's conference to end."
45713 + "description": "Ends an active conference in a Google Meet space. REQUIRES 'space_name' parameter (e.g., 'spaces/jQCFfuBOdN5z' or just 'jQCFfuBOdN5z'). Use when you need to terminate an ongoing conference in a specified space. This operation only succeeds if a conference is actively running in the space. You must always provide the space_name to identify which space's conference to end. Immediately drops all active participants — obtain explicit user confirmation before calling."
45714 },
45715 {
45716 "slug": "GOOGLEMEET_GET_CONFERENCE_RECORD_BY_NAME",
@@ -45720,7 +45720,7 @@
45720 {
45721 "slug": "GOOGLEMEET_GET_MEET",
45722 "name": "Get Meet details",
45723 - "description": "Retrieve details of a Google Meet space using its unique identifier."
45723 + "description": "Retrieve details of a Google Meet space using its unique identifier. Newly created spaces may return incomplete data; retry after 1–3 seconds if needed."
45724 },
45725 {
45726 "slug": "GOOGLEMEET_GET_PARTICIPANT_SESSION",
@@ -45730,7 +45730,7 @@
45730 {
45731 "slug": "GOOGLEMEET_GET_RECORDINGS_BY_CONFERENCE_RECORD_ID",
45732 "name": "Get recordings by conference record ID",
45733 - "description": "Retrieves recordings from Google Meet for a given conference record ID."
45733 + "description": "Retrieves recordings from Google Meet for a given conference record ID. Only returns recordings if recording was enabled and permitted by the organizer's domain policies; a valid conferenceRecord_id does not guarantee recordings exist. After a meeting ends, recordings may take several minutes to process — an empty result may be temporary, not permanent."
45734 },
45735 {
45736 "slug": "GOOGLEMEET_GET_SPACE",
@@ -45750,7 +45750,7 @@
45750 {
45751 "slug": "GOOGLEMEET_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID",
45752 "name": "Get transcripts by conference record ID",
45753 - "description": "Retrieves all transcripts for a specific Google Meet conference using its conferenceRecord_id."
45753 + "description": "Retrieves all transcripts for a specific Google Meet conference using its conferenceRecord_id. Transcripts require processing time after a meeting ends — empty results may be transient; retry after a delay before concluding no transcripts exist. Returns results only if transcription was enabled during the meeting and permitted by the organizer's domain policies; an empty list may also indicate transcription was never generated."
45754 },
45755 {
45756 "slug": "GOOGLEMEET_LIST_CONFERENCE_RECORDS",
@@ -45780,7 +45780,7 @@
45780 {
45781 "slug": "GOOGLEMEET_UPDATE_SPACE",
45782 "name": "Update Google Meet Space",
45783 - "description": "Updates the settings of an existing Google Meet space. REQUIRED PARAMETER: - name: The space identifier (e.g., 'spaces/jQCFfuBOdN5z'). This is always required to identify which space to update. OPTIONAL PARAMETERS: - config: The new configuration settings to apply (accessType, entryPointAccess, moderation, etc.) - updateMask: Specify which fields to update. If omitted, all provided config fields are updated. Example: To change access type, provide name='spaces/abc123' and config={'accessType': 'OPEN'}"
45783 + "description": "Updates the settings of an existing Google Meet space. Requires organizer/host privileges and the meetings.space.created OAuth scope. REQUIRED PARAMETER: - name: The space identifier (e.g., 'spaces/jQCFfuBOdN5z'). This is always required to identify which space to update. OPTIONAL PARAMETERS: - config: The new configuration settings to apply (accessType, entryPointAccess, moderation, etc.) - updateMask: Specify which fields to update. If omitted, all provided config fields are updated. Example: To change access type, provide name='spaces/abc123' and config={'accessType': 'OPEN'}"
45784 }
45785 ],
45786 "triggers": [],
@@ -45846,12 +45846,12 @@
45846 ],
45847 "toolCount": 6,
45848 "triggerCount": 0,
45849 - "version": "20260307_00",
45849 + "version": "20260316_00",
45850 "tools": [
45851 {
45852 "slug": "TEXT_TO_PDF_CONVERT_TEXT_TO_PDF",
45853 "name": "Convert Text to PDF",
45854 - "description": "Convert plain text or Markdown content into a downloadable PDF document. Supports Unicode characters, special symbols, and Markdown formatting including headers, lists, code blocks, links, and emphasis."
45854 + "description": "Convert plain text or Markdown content into a downloadable PDF document. Supports Unicode characters, special symbols, and Markdown formatting including headers, lists, code blocks, links, and emphasis. Images require publicly accessible URLs to render. Response PDF URL is at `data.file.s3url`; also returns `data.file.name` and `data.file.mimetype`."
45855 },
45856 {
45857 "slug": "TEXT_TO_PDF_DELETE_ASYNC_JOB",
@@ -45911,7 +45911,7 @@
45911 ],
45912 "toolCount": 12,
45913 "triggerCount": 0,
45914 - "version": "20260309_00",
45914 + "version": "20260316_00",
45915 "tools": [
45916 {
45917 "slug": "ZOHO_CONVERT_ZOHO_LEAD",
@@ -45921,12 +45921,12 @@
45921 {
45922 "slug": "ZOHO_CREATE_ZOHO_RECORD",
45923 "name": "Create Zoho CRM Record",
45924 - "description": "Creates new records in a specified module in Zoho CRM."
45924 + "description": "Creates new records in a specified module in Zoho CRM. Bulk operations may partially succeed — inspect each item's status field in the response, as some records may be created while others fail."
45925 },
45926 {
45927 "slug": "ZOHO_CREATE_ZOHO_TAG",
45928 "name": "Create Zoho CRM Tag",
45929 - "description": "Creates a new tag in Zoho CRM for a specific module. Tags help organize and categorize CRM records. Each module can have up to 100 tags, and each record can have up to 10 tags assigned. Tags must have unique names within a module and can be assigned custom colors from a predefined palette. Use this action to create standardized tags for lead scoring, deal stages, customer segments, or any custom categorization needs in your CRM workflow."
45929 + "description": "Creates a new tag in Zoho CRM for a specific module. Tags help organize and categorize CRM records. Each module can have up to 100 tags, and each record can have up to 10 tags assigned. Tags must have unique names within a module and can be assigned custom colors from a predefined palette. Creating a tag does not apply it to any records; use separate update actions to assign the tag to records. Use this action to create standardized tags for lead scoring, deal stages, customer segments, or any custom categorization needs in your CRM workflow."
45930 },
45931 {
45932 "slug": "ZOHO_GET_MODULE_FIELDS",
@@ -45961,7 +45961,7 @@
45961 {
45962 "slug": "ZOHO_UPDATE_RELATED_RECORDS",
45963 "name": "Update Related Records in Zoho CRM",
45964 - "description": "Associates or updates relationships between records across different modules in Zoho CRM. This action creates or modifies relationships between a parent record and related records. Common use cases: - Associate Leads/Contacts with Campaigns (with member status) - Link Products to Deals/Quotes/Accounts - Connect Contacts to Accounts - Associate Services with Appointments Use ZOHO_GET_RELATED_LISTS to discover valid related_list_api_name values for your module. Maximum 100 related records can be updated per API call."
45964 + "description": "Associates or updates relationships between records across different modules in Zoho CRM. This action creates or modifies relationships between a parent record and related records. Common use cases: - Associate Leads/Contacts with Campaigns (with member status) - Link Products to Deals/Quotes/Accounts - Connect Contacts to Accounts - Associate Services with Appointments Use ZOHO_GET_RELATED_LISTS to discover valid related_list_api_name values for your module. Maximum 100 related records can be updated per API call. If module_api_name, record_id, related_list_api_name, or child record IDs in data do not match Zoho CRM's related-list configuration exactly, associations may silently succeed (no error returned) but the relationship will not be created."
45965 },
45966 {
45967 "slug": "ZOHO_UPDATE_ZOHO_RECORD",
@@ -46046,7 +46046,7 @@
46046 ],
46047 "toolCount": 21,
46048 "triggerCount": 1,
46049 - "version": "20260312_00",
46049 + "version": "20260316_00",
46050 "tools": [
46051 {
46052 "slug": "FIREFLIES_ADD_TO_LIVE",
@@ -46071,7 +46071,7 @@
46071 {
46072 "slug": "FIREFLIES_DELETE_TRANSCRIPT_BY_ID",
46073 "name": "Delete Transcript by ID",
46074 - "description": "Permanently delete a transcript from the Fireflies account by its unique ID. This is a destructive action that cannot be undone. The transcript, along with its associated audio/video files and summaries, will be permanently removed. Rate limited to 10 requests per minute across all user tiers."
46074 + "description": "Permanently delete a transcript from the Fireflies account by its unique ID. This is a destructive action that cannot be undone. The transcript, along with its associated audio/video files and summaries, will be permanently removed. Rate limited to 10 requests per minute across all user tiers. Verify the target transcript via FIREFLIES_GET_TRANSCRIPTS and obtain explicit user confirmation before calling this tool."
46075 },
46076 {
46077 "slug": "FIREFLIES_FETCH_AI_APP_OUTPUTS2",
@@ -46091,22 +46091,22 @@
46091 {
46092 "slug": "FIREFLIES_GET_BITE_BY_ID",
46093 "name": "Get Bite by ID",
46094 - "description": "The GetBite Action is designed to fetch details associated with a specific bite ID."
46094 + "description": "Fetches details for a specific bite by ID. Requires a Fireflies plan that supports Bites and appropriate API scope. If the bite is not found, use FIREFLIES_GET_TRANSCRIPT_BY_ID to retrieve full transcript context instead."
46095 },
46096 {
46097 "slug": "FIREFLIES_GET_BITES",
46098 "name": "Get Transcripts",
46099 - "description": "The GetBites Action is designed to fetch a list of bites against input arguments."
46099 + "description": "Fetches a list of bites (highlights) against input arguments. Bites are generated asynchronously after transcript completion — only call this after FIREFLIES_GET_TRANSCRIPT_BY_ID reports `status=completed`. Empty results are possible for valid meetings; use FIREFLIES_GET_TRANSCRIPT_BY_ID for full transcript context when bites are unavailable."
46100 },
46101 {
46102 "slug": "FIREFLIES_GET_TRANSCRIPT_BY_ID",
46103 "name": "Get Transcript by ID",
46104 - "description": "The GetTranscriptById Action is designed to fetch details associated with a specific transcript ID. Note: This action requires a paid Fireflies plan to access transcript details."
46104 + "description": "Fetches details for a specific Fireflies transcript ID. Requires a paid Fireflies plan. Response is nested at data.outputs.data.transcript; fields like sentences and attendees can be null — handle gracefully. transcript.summary.action_items may be a single newline-delimited string rather than an array — split by line breaks instead of iterating as an array. Limit concurrent calls to ~3 and apply exponential backoff on 429 responses, respecting Retry-After headers."
46105 },
46106 {
46107 "slug": "FIREFLIES_GET_TRANSCRIPTS",
46108 "name": "Get Transcripts",
46109 - "description": "The GetTranscripts Action is designed to fetch a list of transcripts against input arguments."
46109 + "description": "Fetches a list of transcripts against input filters. Metadata filters (title, host_email, organizers, participants) match transcript metadata only, not spoken content. Pagination via skip/limit may trigger HTTP 429 on rapid requests; use backoff between pages."
46110 },
46111 {
46112 "slug": "FIREFLIES_GET_USER_BY_ID",
@@ -46121,7 +46121,7 @@
46121 {
46122 "slug": "FIREFLIES_GET_USERS",
46123 "name": "Get Users",
46124 - "description": "The GetUsers Action is designed to fetch a list of all users within the team."
46124 + "description": "Fetches a list of all users within the team, including their full email addresses. Use to resolve complete email addresses from user names before passing to tools that require exact email addresses (no partial addresses or domain-only values)."
46125 },
46126 {
46127 "slug": "FIREFLIES_GRAPHQL_QUERY",
@@ -46151,7 +46151,7 @@
46151 {
46152 "slug": "FIREFLIES_UPLOAD_AUDIO",
46153 "name": "Upload Audio",
46154 - "description": "The UploadAudio Action allows you to upload audio files to Fireflies.ai for transcription. Note: This action requires a paid Fireflies plan to upload and transcribe audio files."
46154 + "description": "The UploadAudio Action allows you to upload audio files to Fireflies.ai for transcription. Transcription is asynchronous — after submission, results may take several minutes to become available; use transcript retrieval tools to poll for completion. Note: This action requires a paid Fireflies plan to upload and transcribe audio files."
46155 }
46156 ],
46157 "triggers": [
@@ -46201,7 +46201,7 @@
46201 ],
46202 "toolCount": 177,
46203 "triggerCount": 0,
46204 - "version": "20260312_00",
46204 + "version": "20260316_00",
46205 "tools": [
46206 {
46207 "slug": "DROPBOX_ACTIVATE_TEAM_FOLDER",
@@ -46416,7 +46416,7 @@
46416 {
46417 "slug": "DROPBOX_DELETE_FILE_OR_FOLDER",
46418 "name": "Delete file or folder (Deprecated)",
46419 - "description": "DEPRECATED: Use DeleteFile instead. Permanently deletes the file or folder at the specified path in Dropbox. Use when you need to remove a specific file or folder. Requires the `files.content.write` scope."
46419 + "description": "DEPRECATED: Use DeleteFile instead. Permanently and irreversibly deletes the file or folder at the specified path in Dropbox. Folder deletion is recursive — all nested contents are removed. Always obtain explicit user confirmation before calling, especially for folders. Requires the `files.content.write` scope."
46420 },
46421 {
46422 "slug": "DROPBOX_DELETE_FILE_REQUESTS",
@@ -46476,7 +46476,7 @@
46476 {
46477 "slug": "DROPBOX_GET_ABOUT_ME",
46478 "name": "Get about me",
46479 - "description": "Tool to get information about the current user's Dropbox account. Use when you need to retrieve account details like email, name, or account type."
46479 + "description": "Tool to get information about the current user's Dropbox account. Use when you need to retrieve account details like email, name, or account type. Useful for verifying authenticated account identity before destructive operations in multi-account setups. Note: successful response does not imply access to all shared or team folders; path-specific permission errors from other tools indicate missing folder-level permissions, not empty results."
46480 },
46481 {
46482 "slug": "DROPBOX_GET_ACCOUNT",
@@ -46631,7 +46631,7 @@
46631 {
46632 "slug": "DROPBOX_GET_TEMPORARY_LINK",
46633 "name": "Get temporary link",
46634 - "description": "Tool to get a one-click temporary (expiring) download link. Use when you need to share a Dropbox file directly without proxying content through this service. Requires `files.content.read` scope."
46634 + "description": "Tool to get a one-click temporary (expiring) download link. Use when you need to share a Dropbox file directly without proxying content through this service. Only works for files, not folders. Returned URLs expire within hours and must be regenerated for future use; never treat them as permanent links. Requires `files.content.read` scope."
46635 },
46636 {
46637 "slug": "DROPBOX_GET_TEMPORARY_UPLOAD_LINK",
@@ -46691,7 +46691,7 @@
46691 {
46692 "slug": "DROPBOX_LIST_FILES_IN_FOLDER",
46693 "name": "List files in folder",
46694 - "description": "Tool to list files and folders in a specified Dropbox directory. Use when you need to see the contents of a folder, including subfolders if recursive is true."
46694 + "description": "Tool to list files and folders in a specified Dropbox directory. Use when you need to see the contents of a folder, including subfolders if recursive is true. When the response contains `has_more=true`, continue fetching with the returned cursor until `has_more=false` — stopping early misses entries in large folders. Response entries include both files and folders; use the `.tag` field on each entry to distinguish item types."
46695 },
46696 {
46697 "slug": "DROPBOX_LIST_FOLDER_CONTINUE",
@@ -46876,7 +46876,7 @@
46876 {
46877 "slug": "DROPBOX_READ_FILE",
46878 "name": "Read a file",
46879 - "description": "Downloads a file from the specified Dropbox path, requiring `files.content.read` scope."
46879 + "description": "Downloads a file from the specified Dropbox path, requiring `files.content.read` scope. Response field `file_content_bytes` is base64-encoded binary; decode before saving or passing to libraries. Bursty reads may trigger HTTP 429; honor the `Retry-After` header."
46880 },
46881 {
46882 "slug": "DROPBOX_REMOVE_FILE_MEMBER",
@@ -46961,7 +46961,7 @@
46961 {
46962 "slug": "DROPBOX_SEARCH_FILE_OR_FOLDER",
46963 "name": "Search File or Folder",
46964 - "description": "Tool to search for files and folders in Dropbox. Use when you need to find an item by name or content, optionally within a specific path or with other filters, and paginate through results. Example: Search for 'report.docx' in the '/finance' folder."
46964 + "description": "Tool to search for files and folders in Dropbox by name or content, optionally scoped to a path, with pagination support. Results paginate via cursor (up to 100 per page); check `has_more` in the response and re-fetch with the cursor until `has_more` is false. Newly indexed items may have a brief delay before appearing. Verify `path_display` and `.tag` (file vs folder) on each result before acting, as multiple similar-named items may match. Results are limited to items visible to the authenticated user."
46965 },
46966 {
46967 "slug": "DROPBOX_SEARCH_FILE_PROPERTIES",
@@ -47086,7 +47086,7 @@
47086 {
47087 "slug": "DROPBOX_UPLOAD_FILE",
47088 "name": "Upload File",
47089 - "description": "Uploads a file to a specified path in the user's Dropbox, with options for handling existing files."
47089 + "description": "Uploads a file (up to ~150 MB) to a specified path in the user's Dropbox, with options for handling existing files. Files larger than 150 MB require a chunked upload approach."
47090 }
47091 ],
47092 "triggers": [],
@@ -47907,7 +47907,7 @@
47907 ],
47908 "toolCount": 62,
47909 "triggerCount": 20,
47910 - "version": "20260312_00",
47910 + "version": "20260316_00",
47911 "tools": [
47912 {
47913 "slug": "CONFLUENCE_ADD_CONTENT_LABEL",
@@ -47922,7 +47922,7 @@
47922 {
47923 "slug": "CONFLUENCE_CREATE_BLOGPOST",
47924 "name": "Create Blogpost",
47925 - "description": "Tool to create a new Confluence blog post. Use when you need to publish content in a specific space."
47925 + "description": "Tool to create a new Confluence blog post. Use when you need to publish content in a specific space. Response includes `data.id` for the post ID and `data._links.base` + `data._links.webui` for the URL."
47926 },
47927 {
47928 "slug": "CONFLUENCE_CREATE_BLOGPOST_PROPERTY",
@@ -47957,7 +47957,7 @@
47957 {
47958 "slug": "CONFLUENCE_CREATE_SPACE",
47959 "name": "Create Space",
47960 - "description": "Tool to create a new Confluence space. Use when setting up a new knowledge area for organization."
47960 + "description": "Tool to create a new Confluence space. Use when setting up a new knowledge area for organization. Must include a `plain.representation` field, e.g., `{\"plain\": {\"representation\": \"plain\", \"value\": \"text here\"}}`. Omitting this field causes a 400 error."
47961 },
47962 {
47963 "slug": "CONFLUENCE_CREATE_SPACE_PROPERTY",
@@ -47987,7 +47987,7 @@
47987 {
47988 "slug": "CONFLUENCE_DELETE_PAGE",
47989 "name": "Delete Page",
47990 - "description": "Tool to delete a Confluence page. Use with caution as this will permanently remove the page from the space."
47990 + "description": "Tool to delete a Confluence page. Use with caution as this permanently removes the page and its content with no recovery option. In move or migration workflows, confirm all target pages were successfully created before deleting source pages — partial creation failures combined with deletion result in unrecoverable data loss."
47991 },
47992 {
47993 "slug": "CONFLUENCE_DELETE_SPACE",
@@ -48062,7 +48062,7 @@
48062 {
48063 "slug": "CONFLUENCE_GET_CHILD_PAGES",
48064 "name": "Get Child Pages",
48065 - "description": "Tool to list all direct child pages of a given Confluence page. Use when you have a parent page ID and need to discover its direct descendants."
48065 + "description": "Tool to list all direct child pages of a given Confluence page. Use when you have a parent page ID and need to discover its direct descendants. Response nests child page data under `data.data.results`; unwrap this before iterating. Paginate using `_links.next` cursor until no further results to avoid missing children."
48066 },
48067 {
48068 "slug": "CONFLUENCE_GET_CONTENT_PROPERTIES_FOR_BLOG_POST",
@@ -48082,7 +48082,7 @@
48082 {
48083 "slug": "CONFLUENCE_GET_CURRENT_USER",
48084 "name": "Get Current User",
48085 - "description": "Tool to get information about the currently authenticated user. Use when you need to check user details or permissions."
48085 + "description": "Tool to get information about the currently authenticated user — always scoped to the account tied to the configured connection, not arbitrary users. Use CONFLUENCE_SEARCH_USERS to look up other users. Response contains nested metadata; key fields include accountId, displayName, and email for use in downstream logic."
48086 },
48087 {
48088 "slug": "CONFLUENCE_GET_INLINE_COMMENTS_FOR_BLOG_POST",
@@ -48092,12 +48092,12 @@
48092 {
48093 "slug": "CONFLUENCE_GET_LABELS",
48094 "name": "Get Labels",
48095 - "description": "Tool to retrieve all labels in a Confluence site. Use when you need to list or page through labels."
48095 + "description": "Tool to retrieve all labels in a Confluence site; use for label discovery when you need to list or page through labels. For label-based filtering, use CONFLUENCE_GET_LABELS_FOR_PAGE or CONFLUENCE_GET_LABELS_FOR_SPACE_CONTENT instead."
48096 },
48097 {
48098 "slug": "CONFLUENCE_GET_LABELS_FOR_PAGE",
48099 "name": "Get Page Labels",
48100 - "description": "Tool to retrieve labels of a specific Confluence page by ID. Use after obtaining the page ID to list its labels."
48100 + "description": "Tool to retrieve labels of a specific Confluence page by ID. Labels are returned in `data.results[*].name` and are not available in CONFLUENCE_GET_PAGES responses. Use after obtaining the page ID to list its labels. Paginate using `start` and `limit` to avoid missing labels when count exceeds 25."
48101 },
48102 {
48103 "slug": "CONFLUENCE_GET_LABELS_FOR_SPACE",
@@ -48107,7 +48107,7 @@
48107 {
48108 "slug": "CONFLUENCE_GET_LABELS_FOR_SPACE_CONTENT",
48109 "name": "Get Labels for Space Content",
48110 - "description": "Tool to list labels on all content in a space. Use when you need to retrieve or filter content labels by space, with pagination and optional prefix filtering."
48110 + "description": "Tool to list labels on all content in a space. Use when you need to retrieve or filter content labels by space, with pagination and optional prefix filtering. For label discovery across a space before per-page filtering, use this tool first, then CONFLUENCE_GET_LABELS_FOR_PAGE; CONFLUENCE_SEARCH_CONTENT does not filter by labels."
48111 },
48112 {
48113 "slug": "CONFLUENCE_GET_PAGE_ANCESTORS",
@@ -48117,7 +48117,7 @@
48117 {
48118 "slug": "CONFLUENCE_GET_PAGE_BY_ID",
48119 "name": "Get Page by ID",
48120 - "description": "Tool to retrieve a Confluence page by its ID. Use when you have a page ID and need its detailed metadata and content."
48120 + "description": "Tool to retrieve a Confluence page by its ID. Use when you have a page ID and need its detailed metadata and content. Response body is in `body.storage.value` as Confluence storage format (HTML); strip tags before plain-text use. Before calling CONFLUENCE_UPDATE_PAGE, fetch the latest version here — that tool requires `version.number` = current + 1, else a 409 conflict occurs."
48121 },
48122 {
48123 "slug": "CONFLUENCE_GET_PAGE_FOOTER_COMMENTS",
@@ -48137,22 +48137,22 @@
48137 {
48138 "slug": "CONFLUENCE_GET_PAGES",
48139 "name": "Get Pages",
48140 - "description": "Tool to retrieve a list of pages. Use when you need a paginated list of Confluence pages."
48140 + "description": "Tool to retrieve a paginated list of Confluence pages. Results are permission-scoped to the authenticated user; empty results may reflect access restrictions. Omitting filters like spaceId or status can return unexpectedly broad result sets. Labels are not included in results; use CONFLUENCE_GET_LABELS_FOR_PAGE for label data. Timestamps are ISO 8601 UTC strings."
48141 },
48142 {
48143 "slug": "CONFLUENCE_GET_PAGE_VERSIONS",
48144 "name": "Get Page Versions",
48145 - "description": "Tool to retrieve all versions of a specific Confluence page. Use after confirming the page ID to audit its edit history."
48145 + "description": "Tool to retrieve all versions of a specific Confluence page. Use to audit edit history or to get the latest version.number before calling CONFLUENCE_UPDATE_PAGE — using a stale version.number causes a 409 Conflict error."
48146 },
48147 {
48148 "slug": "CONFLUENCE_GET_SPACE_BY_ID",
48149 "name": "Get Space by ID",
48150 - "description": "Tool to retrieve a Confluence space by its ID. Use when you need detailed metadata of a specific space."
48150 + "description": "Tool to retrieve a Confluence space by its ID. Use when you need detailed metadata of a specific space. Space names are non-unique; use the numeric spaceId or spaceKey from the response for stable identification in downstream operations such as CONFLUENCE_GET_SPACE_PROPERTIES, CONFLUENCE_GET_LABELS_FOR_SPACE, CONFLUENCE_GET_SPACE_CONTENTS, and CONFLUENCE_CREATE_BLOGPOST."
48151 },
48152 {
48153 "slug": "CONFLUENCE_GET_SPACE_CONTENTS",
48154 "name": "Get Space Contents",
48155 - "description": "Tool to retrieve content in a Confluence space. Use when you need to list pages, blogposts, or attachments of a specific space key."
48155 + "description": "Tool to retrieve content in a Confluence space. Use when you need to list pages, blogposts, or attachments of a specific space key. Results are in data.results (not data.page.results). Paginate via start/limit (max 200/request); follow response._links.next until absent to avoid missing content. Only returns content accessible to the authenticated user — missing items may indicate permission restrictions. Atlassian Cloud enforces HTTP 429 rate limits; throttle to ~1–2 requests/second, honor Retry-After headers, and cap start ≤ 1000 for large spaces. Construct item URLs by combining data._links.base with each item's _links.webui."
48156 },
48157 {
48158 "slug": "CONFLUENCE_GET_SPACE_PROPERTIES",
@@ -48162,7 +48162,7 @@
48162 {
48163 "slug": "CONFLUENCE_GET_SPACES",
48164 "name": "Get Spaces",
48165 - "description": "Tool to retrieve a list of Confluence spaces. Use when you need a paginated list of spaces with optional filtering."
48165 + "description": "Tool to retrieve a paginated list of Confluence spaces with optional filtering. Paginate by incrementing `start` in steps of `limit` until fewer results than `limit` are returned. Results are scoped to spaces visible to the authenticated user; absent spaces may be restricted rather than nonexistent. Use `spaceKey` or numeric space ID (not display name) for stable identification in downstream calls. Combined filters apply as AND logic — relax filters before concluding a space is missing."
48166 },
48167 {
48168 "slug": "CONFLUENCE_GET_TASKS",
@@ -48177,7 +48177,7 @@
48177 {
48178 "slug": "CONFLUENCE_SEARCH_CONTENT",
48179 "name": "Search Content",
48180 - "description": "Searches for content by filtering pages from the Confluence v2 API with intelligent ranking. Since the native search endpoint is deprecated, this action: 1. Fetches pages from the v2 pages endpoint with pagination (up to 300 pages) 2. Applies intelligent client-side filtering with relevance scoring 3. Returns results ranked by match quality (exact phrase > all words > partial matches) The search algorithm prioritizes exact phrase matches, then checks for all query words present in the title, and finally considers partial word matches. Results are automatically sorted by relevance score for optimal user experience."
48180 + "description": "Searches for content by filtering pages from the Confluence v2 API with intelligent ranking. Since the native search endpoint is deprecated, this action: 1. Fetches pages from the v2 pages endpoint with pagination (up to 300 pages) 2. Applies intelligent client-side filtering with relevance scoring 3. Returns results ranked by match quality (exact phrase > all words > partial matches). NOTE: Only page titles are searched — queries matching only body content return no results. Results omit full body content and canonical URLs; use CONFLUENCE_GET_PAGE_BY_ID for complete page data. Cannot filter by author, date, or labels. Results reflect only pages accessible to the authenticated user. When multiple pages share similar titles, verify the correct page via spaceId or pageId before performing writes."
48181 },
48182 {
48183 "slug": "CONFLUENCE_SEARCH_USERS",
@@ -48207,7 +48207,7 @@
48207 {
48208 "slug": "CONFLUENCE_UPDATE_PAGE",
48209 "name": "Update Page",
48210 - "description": "Tool to update an existing Confluence page. Use when you need to modify existing documentation or content."
48210 + "description": "Tool to update an existing Confluence page, replacing the entire page content. Use when you need to modify existing documentation or content."
48211 },
48212 {
48213 "slug": "CONFLUENCE_UPDATE_SPACE_PROPERTY",
@@ -48433,7 +48433,7 @@
48433 ],
48434 "toolCount": 179,
48435 "triggerCount": 0,
48436 - "version": "20260312_00",
48436 + "version": "20260316_00",
48437 "tools": [
48438 {
48439 "slug": "FRESHDESK_ADD_NOTE_TO_TICKET",
@@ -48798,7 +48798,7 @@
48798 {
48799 "slug": "FRESHDESK_GET_CONTACTS",
48800 "name": "Get Contacts",
48801 - "description": "Tool to retrieve all contacts from a Freshdesk account. Use when you need to list contacts, optionally filtered by email, phone, mobile, company, state, or modification date."
48801 + "description": "Tool to retrieve all contacts from a Freshdesk account. Use when you need to list contacts, optionally filtered by email, phone, mobile, company, state, or modification date. Results are paginated; iterate through pages using `page` and `per_page` (max 100) to retrieve the full dataset."
48802 },
48803 {
48804 "slug": "FRESHDESK_GET_DISCUSSION_CATEGORY",
@@ -48843,7 +48843,7 @@
48843 {
48844 "slug": "FRESHDESK_GET_TICKETS",
48845 "name": "Get Tickets",
48846 - "description": "Retrieves a list of tickets from Freshdesk."
48846 + "description": "Retrieves a list of tickets from Freshdesk. Tickets are returned under `response_data` in the response object."
48847 },
48848 {
48849 "slug": "FRESHDESK_GET_TICKET_TIME_ENTRIES",
@@ -49318,7 +49318,7 @@
49318 {
49319 "slug": "FRESHDESK_VIEW_TICKET",
49320 "name": "View Ticket",
49321 - "description": "Views an existing ticket in Freshdesk."
49321 + "description": "Views an existing ticket in Freshdesk. Ticket details are returned nested under `response_data` in the tool response."
49322 },
49323 {
49324 "slug": "FRESHDESK_VIEW_TICKET_FIELD",
@@ -50257,7 +50257,7 @@
50257 ],
50258 "toolCount": 50,
50259 "triggerCount": 0,
50260 - "version": "20260313_00",
50260 + "version": "20260316_00",
50261 "tools": [
50262 {
50263 "slug": "MIXPANEL_ADD_UNIQUE_TO_PROFILE_LIST_PROPERTY",
@@ -50322,7 +50322,7 @@
50322 {
50323 "slug": "MIXPANEL_GET_ALL_PROJECTS",
50324 "name": "Get All Projects",
50325 - "description": "Get all projects associated with the authenticated Mixpanel account. Returns project details including name, permissions, role, domain, and other configuration details."
50325 + "description": "Get all projects associated with the authenticated Mixpanel account. Returns project details including name, permissions, role, domain, and other configuration details. If a project appears inaccessible, verify the connection region matches the project's cluster before assuming a permissions issue."
50326 },
50327 {
50328 "slug": "MIXPANEL_GET_ANNOTATION_TAGS_ALT1",
@@ -50452,7 +50452,7 @@
50452 {
50453 "slug": "MIXPANEL_QUERY_SEGMENTATION",
50454 "name": "Query Segmentation Report",
50455 - "description": "Get data for an event, segmented and filtered by properties. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries."
50455 + "description": "Get data for an event, segmented and filtered by properties. The Query API has a rate limit of 60 queries per hour and 5 concurrent queries, shared across related tools (e.g., MIXPANEL_JQL_QUERY, MIXPANEL_TOP_EVENT_PROPERTY_VALUES); bursts of concurrent calls return 429."
50456 },
50457 {
50458 "slug": "MIXPANEL_QUERY_TOP_EVENTS",
@@ -50497,7 +50497,7 @@
50497 {
50498 "slug": "MIXPANEL_TOP_EVENT_PROPERTY_VALUES",
50499 "name": "Get Top Event Property Values",
50500 - "description": "Tool to get the top values for a property ordered by frequency. Use when you need to understand the most common values for a specific property on an event. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries."
50500 + "description": "Tool to get the top values for a property ordered by frequency. Use when you need to understand the most common values for a specific property on an event. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries. This limit is shared across all Query API tools (e.g., MIXPANEL_QUERY_SEGMENTATION); on a 429 response, apply exponential backoff."
50501 },
50502 {
50503 "slug": "MIXPANEL_TOP_EVENTS",
@@ -51640,7 +51640,7 @@
51640 ],
51641 "toolCount": 54,
51642 "triggerCount": 0,
51643 - "version": "20260312_00",
51643 + "version": "20260316_00",
51644 "tools": [
51645 {
51646 "slug": "AMPLITUDE_ASSIGN_ANNOTATIONS_TO_CATEGORY",
@@ -51840,7 +51840,7 @@
51840 {
51841 "slug": "AMPLITUDE_LIST_COHORTS",
51842 "name": "List Amplitude Cohorts",
51843 - "description": "List all discoverable cohorts for an Amplitude project. This action allows you to: - Get a list of all cohorts in your Amplitude project - Optionally include sync information for each cohort Key features: - Returns cohort details including ID, name, size, and definition - Optionally includes sync metadata for integration with other tools - Supports EU data residency"
51843 + "description": "List all discoverable cohorts for an Amplitude project. This action allows you to: - Get a list of all cohorts in your Amplitude project - Optionally include sync information for each cohort Key features: - Returns cohort details including ID, name, size, and definition - Optionally includes sync metadata for integration with other tools - Supports EU data residency. An empty result may indicate insufficient permissions to view cohorts rather than an absence of cohorts in the project."
51844 },
51845 {
51846 "slug": "AMPLITUDE_LIST_EVENT_PROPERTIES",
@@ -51967,7 +51967,7 @@
51967 ],
51968 "toolCount": 72,
51969 "triggerCount": 0,
51970 - "version": "20260312_00",
51970 + "version": "20260316_00",
51971 "tools": [
51972 {
51973 "slug": "HEYGEN_ADD_LOOKS_TO_PHOTO_AVATAR_GROUP",
@@ -52157,7 +52157,7 @@
52157 {
52158 "slug": "HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL",
52159 "name": "Retrieve sharable video URL",
52160 - "description": "Tool to generate a public, shareable URL for a specific video by ID. Use when you need to create a public link that allows anyone to view the video without authentication. The generated URL can be shared with anyone and does not require HeyGen account access."
52160 + "description": "Tool to generate a public, shareable URL for a specific video by ID. Use when you need to create a public link that allows anyone to view the video without authentication. The generated URL can be shared with anyone and does not require HeyGen account access. Generated URLs may be time-limited; call this tool again to refresh the link if it expires."
52161 },
52162 {
52163 "slug": "HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3",
@@ -52167,7 +52167,7 @@
52167 {
52168 "slug": "HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS",
52169 "name": "Retrieve video status details",
52170 - "description": "Tool to retrieve the current processing status and metadata for a specific video by ID. Use when you need to check video processing progress, get time-limited URLs for video downloads, or monitor video generation completion. Note that returned URLs expire after 7 days but can be regenerated by calling this endpoint again."
52170 + "description": "Tool to retrieve the current processing status and metadata for a specific video by ID. Use when you need to check video processing progress, get time-limited URLs for video downloads, or monitor video generation completion. Video rendering is asynchronous and typically takes 30–180+ seconds; poll at moderate intervals rather than tight loops. Verify returned URLs are accessible before surfacing to users. Note that returned URLs expire after 7 days but can be regenerated by calling this endpoint again."
52171 },
52172 {
52173 "slug": "HEYGEN_SEARCH_PUBLIC_AVATAR_GROUPS",
@@ -52940,7 +52940,7 @@
52940 ],
52941 "toolCount": 63,
52942 "triggerCount": 0,
52943 - "version": "20260312_00",
52943 + "version": "20260316_00",
52944 "tools": [
52945 {
52946 "slug": "GOOGLEBIGQUERY_CANCEL_JOB",
@@ -53215,7 +53215,7 @@
53215 {
53216 "slug": "GOOGLEBIGQUERY_QUERY",
53217 "name": "Query",
53218 - "description": "Query Tool will run a SQL query in BigQuery using the REST API. Note: Make sure the query uses proper BigQuery SQL syntax. For example, SELECT * FROM `project.dataset.table` WHERE column_name = 'value'"
53218 + "description": "Query Tool runs a SQL query in BigQuery using the REST API. Use proper BigQuery SQL syntax, e.g., SELECT * FROM `project.dataset.table` WHERE column_name = 'value'. Results are returned under data.rows; an empty rows array means no matching data. Large result sets may be returned via remote_file_info instead of inline rows. Verify exact project_id, dataset, table, and column names before running; wrong identifiers trigger invalidQuery or notFound errors."
53219 },
53220 {
53221 "slug": "GOOGLEBIGQUERY_SEARCH_ALL_ASSIGNMENTS",
@@ -53582,7 +53582,7 @@
53582 ],
53583 "toolCount": 125,
53584 "triggerCount": 0,
53585 - "version": "20260312_00",
53585 + "version": "20260316_00",
53586 "tools": [
53587 {
53588 "slug": "MONDAY_ACCOUNT_TRIGGER_STATISTICS",
@@ -53667,7 +53667,7 @@
53667 {
53668 "slug": "MONDAY_BOARDS",
53669 "name": "Get boards",
53670 - "description": "Tool to retrieve board data via the Monday.com API. Returns metadata about one or multiple boards with filtering options by state, board kind, hierarchy type, and workspace."
53670 + "description": "Tool to retrieve board data via the Monday.com API. Returns core metadata (id, name, state, kind, hierarchy type, workspace) about one or multiple boards with filtering options by state, board kind, hierarchy type, and workspace. For structural details, column configurations, or ownership info, use dedicated board enrichment tools."
53671 },
53672 {
53673 "slug": "MONDAY_CHANGE_SIMPLE_COLUMN_VALUE",
@@ -53792,7 +53792,7 @@
53792 {
53793 "slug": "MONDAY_DELETE_ASSET",
53794 "name": "Delete asset",
53795 - "description": "Tool to remove uploaded files. Since monday.com doesn't provide a direct asset deletion API, this tool deletes the enclosing update or clears files from a File column."
53795 + "description": "Tool to remove uploaded files. Since monday.com doesn't provide a direct asset deletion API, this tool deletes the enclosing update or clears files from a File column. Both operations are permanent and irreversible; confirm with the user before invoking."
53796 },
53797 {
53798 "slug": "MONDAY_DELETE_BOARD",
@@ -53912,7 +53912,7 @@
53912 {
53913 "slug": "MONDAY_GET_ASSETS",
53914 "name": "Get assets",
53915 - "description": "Tool to retrieve file/asset metadata from monday.com by asset IDs. Returns file information including URL, name, size, extension, and thumbnails for images."
53915 + "description": "Tool to retrieve file/asset metadata from monday.com by asset IDs. Returns file information including URL, name, size, extension, and thumbnails for images. Asset IDs originate from updates, update replies, or file-type columns."
53916 },
53917 {
53918 "slug": "MONDAY_GET_BOARD_VIEWS",
@@ -53972,7 +53972,7 @@
53972 {
53973 "slug": "MONDAY_GET_UPDATES",
53974 "name": "Get item updates",
53975 - "description": "Tool to retrieve updates for a specific item. Use when you need to fetch the conversation history tied to an item."
53975 + "description": "Tool to retrieve updates for a specific item. Use when you need to fetch the conversation history tied to an item. Default returns 25 updates per page; items with more updates require explicit pagination or results are silently truncated. Attachments and files may be nested in update replies rather than top-level updates. File references in responses are nested JSON strings requiring parsing."
53976 },
53977 {
53978 "slug": "MONDAY_GET_VERSIONS",
@@ -54012,7 +54012,7 @@
54012 {
54013 "slug": "MONDAY_LIST_BOARD_ITEMS",
54014 "name": "List board items",
54015 - "description": "DEPRECATED: Use MONDAY_ITEMS_PAGE instead. Retrieves ID, name, and state for all items on a specified Monday.com board."
54015 + "description": "DEPRECATED: Use MONDAY_ITEMS_PAGE instead, which supports cursor-based pagination. This tool may silently omit items on larger boards. Results include archived and deleted items by default — filter by state to retrieve only active items."
54016 },
54017 {
54018 "slug": "MONDAY_LIST_BOARDS",
@@ -54027,12 +54027,12 @@
54027 {
54028 "slug": "MONDAY_LIST_GROUPS",
54029 "name": "List groups",
54030 - "description": "Tool to retrieve all groups of a specified board. Use when you need to list groups on a board after confirming its board ID."
54030 + "description": "Tool to retrieve all groups of a specified board. Use when you need to list groups on a board after confirming its board ID. Response is nested under data → boards[0] → groups; confirm boards[0] exists before accessing groups."
54031 },
54032 {
54033 "slug": "MONDAY_LIST_ITEMS",
54034 "name": "List items",
54035 - "description": "Retrieves specified subitems from Monday.com using their IDs, returning the raw JSON response."
54035 + "description": "Retrieves specified subitems from Monday.com using their IDs, returning raw JSON. Returned `column_values` fields (`text`, `value`) are frequently null or JSON-encoded strings (including numbers as quoted strings); null-check and JSON-decode before use."
54036 },
54037 {
54038 "slug": "MONDAY_LIST_ITEMS_BY_COLUMN_VALUES",
@@ -54052,7 +54052,7 @@
54052 {
54053 "slug": "MONDAY_LIST_USERS",
54054 "name": "List users",
54055 - "description": "Retrieves a list of users from Monday.com; an empty user list in the response 'data' field does not signify action failure."
54055 + "description": "Retrieves a list of users from Monday.com. Paginate by starting at page=1, incrementing page on each request, and stopping when the returned user list is empty. An empty user list does not signify action failure."
54056 },
54057 {
54058 "slug": "MONDAY_MOVE_ITEM_TO_BOARD",
@@ -54202,7 +54202,7 @@
54202 {
54203 "slug": "MONDAY_UPLOAD_ASSET",
54204 "name": "Upload Asset",
54205 - "description": "Tool to upload a file to an update or file column. Use when you need to attach a file to an existing update or file column."
54205 + "description": "Tool to upload a file to an update or file column. Use when you need to attach a file to an existing update or file column. File attachments are permanent and irreversible; confirm with the user before uploading."
54206 },
54207 {
54208 "slug": "MONDAY_USER_CONNECTIONS",
@@ -56360,7 +56360,7 @@
56360 ],
56361 "toolCount": 402,
56362 "triggerCount": 3,
56363 - "version": "20260312_00",
56363 + "version": "20260316_00",
56364 "tools": [
56365 {
56366 "slug": "PIPEDRIVE_ADD_ACTIVITY_TYPE",
@@ -59008,7 +59008,7 @@
59008 ],
59009 "toolCount": 16,
59010 "triggerCount": 0,
59011 - "version": "20260211_00",
59011 + "version": "20260316_00",
59012 "tools": [
59013 {
59014 "slug": "DYNAMICS365_DYNAMICSCRM_CREATE_ACCOUNT",
@@ -59038,7 +59038,7 @@
59038 {
59039 "slug": "DYNAMICS365_DYNAMICSCRM_CREATE_OPPORTUNITY",
59040 "name": "Create Opportunity",
59041 - "description": "Creates a new opportunity entity record in Dynamics CRM using the Web API."
59041 + "description": "Creates a new opportunity entity record in Dynamics CRM using the Web API. Some CRM configurations enforce `estimatedclosedate` and a transaction currency at the server level even though they are schema-optional; omitting them may cause the request to be rejected."
59042 },
59043 {
59044 "slug": "DYNAMICS365_DYNAMICSCRM_CREATE_SALES_ORDER",
@@ -59078,7 +59078,7 @@
59078 {
59079 "slug": "DYNAMICS365_DYNAMICSCRM_UPDATE_OPPORTUNITY",
59080 "name": "Update Opportunity",
59081 - "description": "Updates an existing opportunity entity record in Dynamics CRM using the Web API."
59081 + "description": "Updates an existing opportunity entity record in Dynamics CRM using the Web API. Some updates may be rejected if required relational fields (e.g., transactioncurrency) are absent from the record, even though they are not exposed as explicit parameters."
59082 },
59083 {
59084 "slug": "DYNAMICS365_DYNAMICSCRM_UPDATE_SALES_ORDER",
@@ -59166,37 +59166,37 @@
59166 ],
59167 "toolCount": 19,
59168 "triggerCount": 2,
59169 - "version": "20260312_00",
59169 + "version": "20260316_00",
59170 "tools": [
59171 {
59172 "slug": "ZENDESK_COUNT_ZENDESK_ORGANIZATIONS",
59173 "name": "Count Zendesk Organizations",
59174 - "description": "Count the number of organizations in Zendesk."
59174 + "description": "Count the number of organizations in Zendesk. Returns a single numeric total only — no names, IDs, or custom fields. Use ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS for per-organization detail."
59175 },
59176 {
59177 "slug": "ZENDESK_CREATE_ZENDESK_ORGANIZATION",
59178 "name": "Create Zendesk Organization",
59179 - "description": "Create an organization in Zendesk."
59179 + "description": "Create an organization in Zendesk. Both `name` and `external_id` must be unique across the account; verify no duplicates exist before calling. Returns `data.id` — persist it for subsequent update or delete operations."
59180 },
59181 {
59182 "slug": "ZENDESK_CREATE_ZENDESK_TICKET",
59183 "name": "Create Zendesk Ticket",
59184 - "description": "Create a ticket in Zendesk with full support for all ticket fields."
59184 + "description": "Create a ticket in Zendesk with full support for all ticket fields. Returns `ticket_id` and `ticket_url`; use ZENDESK_GET_ZENDESK_TICKET_BY_ID for the full ticket object."
59185 },
59186 {
59187 "slug": "ZENDESK_CREATE_ZENDESK_USER",
59188 "name": "Create Zendesk User",
59189 - "description": "Tool to create a new user in Zendesk. Use when you need to onboard a user with specific details."
59189 + "description": "Tool to create a new user in Zendesk. Search for existing users first to avoid duplicate accounts with the same email. Use when you need to onboard a user with specific details."
59190 },
59191 {
59192 "slug": "ZENDESK_DELETE_ZENDESK_ORGANIZATION",
59193 "name": "Delete Zendesk Organization",
59194 - "description": "Delete an organization in Zendesk."
59194 + "description": "Delete an organization in Zendesk. This operation is irreversible; confirm organization_id and get explicit user confirmation before calling."
59195 },
59196 {
59197 "slug": "ZENDESK_DELETE_ZENDESK_TICKET",
59198 "name": "Delete Zendesk Ticket",
59199 - "description": "Delete a ticket in Zendesk."
59199 + "description": "Permanently deletes a ticket in Zendesk, including its entire conversation history. This action is irreversible; always confirm the correct ticket_id before executing."
59200 },
59201 {
59202 "slug": "ZENDESK_DELETE_ZENDESK_USER",
@@ -59206,32 +59206,32 @@
59206 {
59207 "slug": "ZENDESK_DESTROY_MANY_ORGANIZATIONS",
59208 "name": "Bulk Delete Zendesk Organizations",
59209 - "description": "Tool to bulk delete Zendesk organizations. Use when cleaning up test data or removing obsolete organizations in one call. Returns a job_status payload to track progress."
59209 + "description": "Tool to bulk delete Zendesk organizations. Irreversible — confirm ids/external_ids before calling. Use when cleaning up test data or removing obsolete organizations in one call. Returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling to confirm completion."
59210 },
59211 {
59212 "slug": "ZENDESK_GET_ABOUT_ME",
59213 "name": "Get Zendesk About Me",
59214 - "description": "Get information about the owner account in Zendesk."
59214 + "description": "Get information about the currently authenticated user in Zendesk. Returns only the caller's own account; to look up other users, use ZENDESK_SEARCH_ZENDESK_USERS. Response nests the user object under data.owner_info.user. Useful for verifying the acting user's identity and permissions before performing bulk operations."
59215 },
59216 {
59217 "slug": "ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS",
59218 "name": "Get Zendesk Organizations",
59219 - "description": "Get all organizations in Zendesk."
59219 + "description": "Get all organizations in Zendesk. Returns results nested under an 'organizations' array; an empty list is valid. Accepts no server-side filters — all filtering by name, domain_names (an array field), or organization_fields must be done client-side. Large accounts require pagination; missing pages will undercount results. Multiple organizations may share similar names or domains — always disambiguate using external_id or domain_names and confirm organization_id before acting. Avoid repeated full-list fetches on large accounts; cache or batch client-side instead."
59220 },
59221 {
59222 "slug": "ZENDESK_GET_ZENDESK_ORGANIZATION",
59223 "name": "Get Zendesk Organization",
59224 - "description": "Get information about a specific organization in Zendesk."
59224 + "description": "Get metadata for a specific Zendesk organization by ID. Response fields are available under data.organization_info. Does not return member/user lists."
59225 },
59226 {
59227 "slug": "ZENDESK_GET_ZENDESK_TICKET_BY_ID",
59228 "name": "Get Zendesk Ticket",
59229 - "description": "Get ticket details from Zendesk."
59229 + "description": "Get ticket details from Zendesk. Response wraps all data under a top-level `data` key; access `data['comments']` for comments and `data['comments'][i]['attachments']` for attachments (attachments unavailable from list endpoints). Each comment has both `html_body` and plain `body` fields — choose appropriately. Fields like `subject`, `organization_id`, `author_id`, and `body` may be null; handle defensively. First comment in `data.comments` is not necessarily from the requester — compare `author_id` against ticket `requester_id` to identify requester messages. For bulk calls, honor `Retry-After` headers on HTTP 429."
59230 },
59231 {
59232 "slug": "ZENDESK_LIST_ZENDESK_TICKETS",
59233 "name": "List Tickets",
59234 - "description": "List Zendesk tickets with pagination and filtering."
59234 + "description": "List Zendesk tickets with pagination and filtering. Only server-side filter available is external_id; status, priority, tags, assignee_id, and date-range filters must be applied client-side. Timestamps (created_at, updated_at) are ISO 8601 UTC. ticket.subject may be null — coerce to string before filtering. Attachments are not included; retrieve via ZENDESK_GET_ZENDESK_TICKET_BY_ID. HTTP 429 rate limit responses include Retry-After header; apply exponential backoff. Paginate by following next_page until null to avoid missing tickets."
59235 },
59236 {
59237 "slug": "ZENDESK_LIST_ZENDESK_USERS",
@@ -59251,12 +59251,12 @@
59251 {
59252 "slug": "ZENDESK_SEARCH_ZENDESK_USERS",
59253 "name": "Search Users",
59254 - "description": "Tool to search Zendesk users by email or name. Use after confirming user identity before ticket creation."
59254 + "description": "Tool to search Zendesk users by email or name. At least one of 'email' or 'name' must be provided; pagination-only calls fail. Results span all roles (end-users, agents, admins); filter by 'role' client-side if needed. No org-scoped filtering — filter by 'organization_id' client-side. A response with count=0 and empty users array means no match, not an error. Use before ticket creation to confirm user identity."
59255 },
59256 {
59257 "slug": "ZENDESK_UPDATE_ZENDESK_ORGANIZATION",
59258 "name": "Update Zendesk Organization",
59259 - "description": "Update an organization in Zendesk."
59259 + "description": "Update an organization in Zendesk. After updating, re-fetch via ZENDESK_GET_ZENDESK_ORGANIZATION if downstream logic depends on current data."
59260 },
59261 {
59262 "slug": "ZENDESK_UPDATE_ZENDESK_TICKET",
@@ -59350,7 +59350,7 @@
59350 ],
59351 "toolCount": 14,
59352 "triggerCount": 0,
59353 - "version": "20260307_00",
59353 + "version": "20260316_00",
59354 "tools": [
59355 {
59356 "slug": "GOOGLEPHOTOS_ADD_ENRICHMENT",
@@ -59486,7 +59486,7 @@
59486 ],
59487 "toolCount": 8,
59488 "triggerCount": 0,
59489 - "version": "20260307_00",
59489 + "version": "20260316_00",
59490 "tools": [
59491 {
59492 "slug": "LMNT_CREATE_VOICE",
@@ -59511,7 +59511,7 @@
59511 {
59512 "slug": "LMNT_GET_VOICE_INFO",
59513 "name": "Get Voice Info",
59514 - "description": "Gets information about a specific voice in LMNT."
59514 + "description": "Gets metadata for a specific LMNT voice, including active status, supported languages, and plan availability. Useful for validating a voice ID before using it in synthesis requests."
59515 },
59516 {
59517 "slug": "LMNT_GET_VOICES_LIST",
@@ -59521,7 +59521,7 @@
59521 {
59522 "slug": "LMNT_SYNTHESIZE_SPEECH",
59523 "name": "Synthesize Speech",
59524 - "description": "Synthesizes speech from text using LMNT's AI voices. Converts text (up to 5000 characters) into natural-sounding speech audio using a specified voice. Returns base64-encoded audio that can be decoded and played or saved. Supports multiple audio formats and quality settings for different use cases."
59524 + "description": "Synthesizes speech from text using LMNT's AI voices. Converts text (up to 5000 characters) into natural-sounding speech audio using a specified voice. Returns base64-encoded audio at `data.response_data.audio` — decode before saving or passing to other tools. Supports multiple audio formats and quality settings for different use cases."
59525 },
59526 {
59527 "slug": "LMNT_UPDATE_VOICE",
@@ -59568,7 +59568,7 @@
59568 ],
59569 "toolCount": 53,
59570 "triggerCount": 0,
59571 - "version": "20260312_00",
59571 + "version": "20260316_00",
59572 "tools": [
59573 {
59574 "slug": "METAADS_CREATE_AD",
@@ -59618,7 +59618,7 @@
59618 {
59619 "slug": "METAADS_GET_INSIGHTS",
59620 "name": "Get Insights",
59621 - "description": "Get insights data for a Meta Ads object (ad account, campaign, ad set, or ad) using the Meta Marketing API. Supports various metrics, breakdowns, and filtering options with flexible date ranges."
59621 + "description": "Get insights data for a Meta Ads object (ad account, campaign, ad set, or ad) using the Meta Marketing API. Supports various metrics, breakdowns, and filtering options with flexible date ranges. Results are paginated; follow `paging.cursors.after` or `paging.next` to retrieve all rows. Missing metric values in results should not be assumed to be zero."
59622 },
59623 {
59624 "slug": "METAADS_GET_OBJECT",
@@ -60037,7 +60037,7 @@
60037 ],
60038 "toolCount": 429,
60039 "triggerCount": 20,
60040 - "version": "20260313_01",
60040 + "version": "20260316_00",
60041 "tools": [
60042 {
60043 "slug": "GOOGLESUPER_ACL_DELETE",
@@ -60082,7 +60082,7 @@
60082 {
60083 "slug": "GOOGLESUPER_ADD_FILE_SHARING_PREFERENCE",
60084 "name": "Add file sharing preference (Deprecated)",
60085 - "description": "DEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead. Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or 'anyone'."
60085 + "description": "DEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead; use GOOGLEDRIVE_UPDATE_PERMISSION to modify existing permissions (avoids duplicate entries). Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or 'anyone'. Bulk calls may trigger 403 rateLimitExceeded (~100 req/100s/user); use jittered exponential backoff."
60086 },
60087 {
60088 "slug": "GOOGLESUPER_ADD_LABEL_TO_EMAIL",
@@ -60092,7 +60092,7 @@
60092 {
60093 "slug": "GOOGLESUPER_ADD_OR_REMOVE_TO_CUSTOMER_LIST",
60094 "name": "Add or remove to customer list",
60095 - "description": "AddOrRemoveToCustomerList Tool will add a contact to a customer list in Google Ads. Note: It takes 6 to 12 hours for changes to be reflected in the customer list."
60095 + "description": "AddOrRemoveToCustomerList Tool will add a contact to a customer list in Google Ads. Note: It takes 6 to 12 hours for changes to be reflected in the customer list. Email addresses must comply with Google Ads policies and applicable privacy/consent laws."
60096 },
60097 {
60098 "slug": "GOOGLESUPER_ADD_PARENT",
@@ -60147,7 +60147,7 @@
60147 {
60148 "slug": "GOOGLESUPER_BATCH_DELETE_MESSAGES",
60149 "name": "Batch delete Gmail messages",
60150 - "description": "Tool to permanently delete multiple Gmail messages in bulk. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene)."
60150 + "description": "Tool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene). Use GMAIL_MOVE_TO_TRASH instead when reversibility may be needed. Always obtain explicit user confirmation and verify a sample of message IDs before executing. High-volume calls may trigger 429 rateLimitExceeded or 403 userRateLimitExceeded errors; apply exponential backoff."
60151 },
60152 {
60153 "slug": "GOOGLESUPER_BATCH_EVENTS",
@@ -60172,7 +60172,7 @@
60172 {
60173 "slug": "GOOGLESUPER_BATCH_MODIFY_MESSAGES",
60174 "name": "Batch modify Gmail messages",
60175 - "description": "Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels."
60175 + "description": "Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels. High-volume calls may return 429 rateLimitExceeded or 403 userRateLimitExceeded; apply exponential backoff."
60176 },
60177 {
60178 "slug": "GOOGLESUPER_BATCH_RUN_PIVOT_REPORTS",
@@ -60212,7 +60212,7 @@
60212 {
60213 "slug": "GOOGLESUPER_CALENDAR_LIST_INSERT",
60214 "name": "Insert Calendar into List",
60215 - "description": "Inserts an existing calendar into the user's calendar list."
60215 + "description": "Inserts an existing calendar into the user's calendar list, making it visible in the UI. Calendars (e.g., newly created ones) won't appear in the list or UI until explicitly inserted."
60216 },
60217 {
60218 "slug": "GOOGLESUPER_CALENDAR_LIST_PATCH",
@@ -60222,7 +60222,7 @@
60222 {
60223 "slug": "GOOGLESUPER_CALENDAR_LIST_UPDATE",
60224 "name": "Update Calendar List Entry",
60225 - "description": "Updates an existing entry on the user\\'s calendar list."
60225 + "description": "Updates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user — does not modify the underlying calendar resource (title, timezone, etc.). To modify the calendar itself, use GOOGLECALENDAR_CALENDARS_UPDATE."
60226 },
60227 {
60228 "slug": "GOOGLESUPER_CALENDAR_LIST_WATCH",
@@ -60232,12 +60232,12 @@
60232 {
60233 "slug": "GOOGLESUPER_CALENDARS_DELETE",
60234 "name": "Delete Calendar",
60235 - "description": "Deletes a secondary calendar that you own or have delete permissions on. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead."
60235 + "description": "Deletes a secondary calendar that you own or have delete permissions on. Deletion is permanent and irreversible — verify the correct calendar_id before calling. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead. Parallel calls may trigger userRateLimitExceeded; sequence bulk deletions."
60236 },
60237 {
60238 "slug": "GOOGLESUPER_CALENDARS_UPDATE",
60239 "name": "Update Calendar",
60240 - "description": "Updates metadata for a calendar."
60240 + "description": "Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. Use GOOGLECALENDAR_PATCH_CALENDAR to update only a subset of fields. Mutates the underlying calendar resource (title, description, timeZone, etc.); use GOOGLECALENDAR_CALENDAR_LIST_UPDATE to change per-user display properties like color."
60241 },
60242 {
60243 "slug": "GOOGLESUPER_CHANNELS_STOP",
@@ -60257,12 +60257,12 @@
60257 {
60258 "slug": "GOOGLESUPER_CLEAR_CALENDAR",
60259 "name": "Clear Calendar",
60260 - "description": "Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account."
60260 + "description": "Clears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely."
60261 },
60262 {
60263 "slug": "GOOGLESUPER_CLEAR_TASKS",
60264 "name": "Clear tasks",
60265 - "description": "Permanently clears all completed tasks from a specified Google Tasks list; this action is destructive and idempotent."
60265 + "description": "Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone. Always require explicit user confirmation before invoking."
60266 },
60267 {
60268 "slug": "GOOGLESUPER_CLEAR_VALUES",
@@ -60277,7 +60277,7 @@
60277 {
60278 "slug": "GOOGLESUPER_COMPUTE_ROUTE_MATRIX",
60279 "name": "Compute Route Matrix",
60280 - "description": "Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes."
60280 + "description": "Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes. Matrix is capped at 625 elements (e.g., 25×25); chunk larger sets to avoid RESOURCE_EXHAUSTED errors. Response elements may be returned out of input order — always use originIndex and destinationIndex to map results. Only use elements where condition='ROUTE_EXISTS'; the matrix may be incomplete."
60281 },
60282 {
60283 "slug": "GOOGLESUPER_COPY_DOCUMENT",
@@ -60287,7 +60287,7 @@
60287 {
60288 "slug": "GOOGLESUPER_COPY_FILE",
60289 "name": "Copy file (Deprecated)",
60290 - "description": "DEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. Duplicates an existing file in Google Drive, identified by its `file_id`."
60290 + "description": "DEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. Duplicates an existing file (not folders) in Google Drive by `file_id`; copy lands in same folder as original — use GOOGLEDRIVE_MOVE_FILE afterward for precise placement. Copy receives a new `file_id`; update stored references accordingly. For shared drives, requires organizer/manager rights."
60291 },
60292 {
60293 "slug": "GOOGLESUPER_COPY_FILE_ADVANCED",
@@ -60302,7 +60302,7 @@
60302 {
60303 "slug": "GOOGLESUPER_CREATE_AUDIENCE_EXPORT",
60304 "name": "Create Audience Export",
60305 - "description": "Tool to create an audience export for Google Analytics. Use when you need to export a snapshot of users in an audience at a specific point in time. This initiates a long-running asynchronous request that returns an operation resource name immediately."
60305 + "description": "Tool to create an audience export for Google Analytics. Use when you need to export a snapshot of users in an audience at a specific point in time. This initiates a long-running asynchronous request that returns an operation resource name immediately. The export begins in CREATING state with rowCount=0; the operation must complete before export data is accessible for querying."
60306 },
60307 {
60308 "slug": "GOOGLESUPER_CREATE_AUDIENCE_LIST",
@@ -60317,7 +60317,7 @@
60317 {
60318 "slug": "GOOGLESUPER_CREATE_COMMENT",
60319 "name": "Create Comment",
60320 - "description": "Tool to create a comment on a file. Use when you need to add a new comment to a specific file in Google Drive."
60320 + "description": "Tool to create a comment on a file in Google Drive. Returns a nested `data` object; extract `data.id` for the resulting comment identifier. Omit `anchor` and `quoted_file_content_*` for general file-level comments."
60321 },
60322 {
60323 "slug": "GOOGLESUPER_CREATE_CUSTOM_DIMENSION",
@@ -60327,7 +60327,7 @@
60327 {
60328 "slug": "GOOGLESUPER_CREATE_CUSTOMER_LIST",
60329 "name": "Create customer list",
60330 - "description": "Creates a customer list in Google Ads. Note: Requires an authenticated Google Ads connection with customer_id configured."
60330 + "description": "Creates a customer list in Google Ads. Note: Requires an authenticated Google Ads connection with customer_id configured. Email-based lists must comply with Google Ads policies and applicable privacy/consent laws. Membership updates can take many hours to propagate; targeting eligibility is not immediate after creation."
60331 },
60332 {
60333 "slug": "GOOGLESUPER_CREATE_CUSTOM_METRIC",
@@ -60357,12 +60357,12 @@
60357 {
60358 "slug": "GOOGLESUPER_CREATE_EMAIL_DRAFT",
60359 "name": "Create email draft",
60360 - "description": "Creates a Gmail email draft. All fields are optional per the Gmail API - drafts can be created with minimal content and edited later before sending. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. When creating a draft reply to an existing thread (thread_id provided), leave subject empty to stay in the same thread; setting a subject will create a NEW thread instead."
60360 + "description": "Creates a Gmail email draft. While all fields are optional per the Gmail API, practical validation requires at least one of recipient_email, cc, or bcc and at least one of subject or body. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. Returns a draft_id that must be used as-is with GMAIL_SEND_DRAFT — synthetic or stale IDs will fail. When creating a draft reply to an existing thread (thread_id provided), leave subject empty to stay in the same thread; setting a subject will create a NEW thread instead. HTTP 429 may occur on rapid creation/send sequences; apply exponential backoff."
60361 },
60362 {
60363 "slug": "GOOGLESUPER_CREATE_EVENT",
60364 "name": "Create Event",
60365 - "description": "Create a Google Calendar event using start_datetime plus duration fields. The organizer is added as an attendee unless exclude_organizer is True. By default adds Google Meet link (works for Workspace, gracefully falls back for personal Gmail). Attendees can be email strings (required) or objects with email and optional fields. Example: { \"start_datetime\": \"2025-01-16T13:00:00\", \"timezone\": \"America/New_York\", \"event_duration_hour\": 1, \"event_duration_minutes\": 30, \"summary\": \"Client sync\", \"attendees\": [\"required@example.com\", {\"email\": \"optional@example.com\", \"optional\": true}] }"
60365 + "description": "Create a Google Calendar event using start_datetime plus duration fields. The organizer is added as an attendee unless exclude_organizer is True. By default adds Google Meet link (works for Workspace, gracefully falls back for personal Gmail). Attendees can be email strings (required) or objects with email and optional fields. No conflict checking is performed; use GOOGLECALENDAR_FREE_BUSY_QUERY to detect overlaps before creating. Returns event id and htmlLink nested under data.response_data. Example: { \"start_datetime\": \"2025-01-16T13:00:00\", \"timezone\": \"America/New_York\", \"event_duration_hour\": 1, \"event_duration_minutes\": 30, \"summary\": \"Client sync\", \"attendees\": [\"required@example.com\", {\"email\": \"optional@example.com\", \"optional\": true}] }"
60366 },
60367 {
60368 "slug": "GOOGLESUPER_CREATE_EXPANDED_DATA_SET",
@@ -60372,12 +60372,12 @@
60372 {
60373 "slug": "GOOGLESUPER_CREATE_FILE",
60374 "name": "Create File or Folder",
60375 - "description": "Creates a new file or folder with metadata. Use to create empty files or folders, or files with content by providing it in the request body (though this action primarily focuses on metadata creation)."
60375 + "description": "Creates a new file or folder with metadata. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells; content must be added manually in the Google UI afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER."
60376 },
60377 {
60378 "slug": "GOOGLESUPER_CREATE_FILE_FROM_TEXT",
60379 "name": "Create a File from Text",
60380 - "description": "Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types."
60380 + "description": "Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types. Returns flat metadata fields (`id`, `mimeType`, `name`) at the top level — not nested under a `file` object. Created files are private by default; use a sharing tool afterward for collaborative access. Rapid successive calls may trigger `403 rateLimitExceeded` or `429 userRateLimitExceeded`; apply exponential backoff between retries. Does not support shared-drive targets in all cases."
60381 },
60382 {
60383 "slug": "GOOGLESUPER_CREATE_FILTER",
@@ -60387,7 +60387,7 @@
60387 {
60388 "slug": "GOOGLESUPER_CREATE_FOLDER",
60389 "name": "Create a folder",
60390 - "description": "Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the parent exists or find its ID."
60390 + "description": "Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the parent exists or find its ID. Google Drive permits duplicate folder names, so always store and reuse the folder ID returned by this action rather than relying on names for future lookups."
60391 },
60392 {
60393 "slug": "GOOGLESUPER_CREATE_FOOTER",
@@ -60412,12 +60412,12 @@
60412 {
60413 "slug": "GOOGLESUPER_CREATE_LABEL",
60414 "name": "Create label",
60415 - "description": "Creates a new label with a unique name in the specified user's Gmail account."
60415 + "description": "Creates a new label with a unique name in the specified user's Gmail account. Returns a labelId (e.g., 'Label_123') required for downstream tools like GMAIL_ADD_LABEL_TO_EMAIL, GMAIL_BATCH_MODIFY_MESSAGES, and GMAIL_MODIFY_THREAD_LABELS — those tools do not accept display names."
60416 },
60417 {
60418 "slug": "GOOGLESUPER_CREATE_MEET",
60419 "name": "Create Google Meet Space",
60420 - "description": "Creates a new Google Meet space with optional configuration. Use when you need to create a meeting space with specific settings like access controls, moderation, recording, or transcription options."
60420 + "description": "Creates a new Google Meet space with optional configuration. Does not attach to any calendar event — calendar linking requires a separate Calendar tool call. Capture `meetingUri`, `meetingCode`, and `space.name` from the response immediately for downstream lookups. Requires `meetings.space.created` OAuth scope. Returns HTTP 429 under rapid calls; apply exponential backoff. Use when you need a meeting space with specific access controls, moderation, recording, or transcription settings."
60421 },
60422 {
60423 "slug": "GOOGLESUPER_CREATE_NAMED_RANGE",
@@ -60462,7 +60462,7 @@
60462 {
60463 "slug": "GOOGLESUPER_CREATE_SHORTCUT_TO_FILE",
60464 "name": "Create Shortcut to File/Folder",
60465 - "description": "Tool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it."
60465 + "description": "Tool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it. The shortcut receives its own distinct file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE_MOVE_FILE after creation to place the shortcut in the desired location."
60466 },
60467 {
60468 "slug": "GOOGLESUPER_CREATE_SLIDES_MARKDOWN",
@@ -60487,7 +60487,7 @@
60487 {
60488 "slug": "GOOGLESUPER_CREATE_TASK_LIST",
60489 "name": "Create a task list",
60490 - "description": "Creates a new task list with the specified title."
60490 + "description": "Creates a new task list with the specified title and returns a tasklist_id. Use the returned tasklist_id (not the title) when calling GOOGLETASKS_INSERT_TASK or other task operations. Duplicate titles are permitted by the API, so verify existing lists before creating to avoid unintended duplicates."
60491 },
60492 {
60493 "slug": "GOOGLESUPER_CREATE_TEAM_DRIVE",
@@ -60502,7 +60502,7 @@
60502 {
60503 "slug": "GOOGLESUPER_DELETE_COMMENT",
60504 "name": "Delete Comment",
60505 - "description": "Deletes a comment from a file. Use when you need to remove a specific comment from a Google Drive file."
60505 + "description": "Permanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE_DELETE_REPLY instead. Verify the exact comment content and comment_id before calling."
60506 },
60507 {
60508 "slug": "GOOGLESUPER_DELETE_CONTENT_RANGE",
@@ -60517,7 +60517,7 @@
60517 {
60518 "slug": "GOOGLESUPER_DELETE_DRAFT",
60519 "name": "Delete Draft",
60520 - "description": "Permanently deletes a specific Gmail draft using its ID; ensure the draft exists and the user has necessary permissions for the given `user_id`."
60520 + "description": "Permanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling. Ensure the draft exists and the user has necessary permissions for the given `user_id`."
60521 },
60522 {
60523 "slug": "GOOGLESUPER_DELETE_DRIVE",
@@ -60527,7 +60527,7 @@
60527 {
60528 "slug": "GOOGLESUPER_DELETE_EVENT",
60529 "name": "Delete event",
60530 - "description": "Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); this action is idempotent and raises a 404 error if the event is not found."
60530 + "description": "Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); idempotent — a 404 for an already-deleted event is a no-op. Bulk deletions may trigger `rateLimitExceeded` or `userRateLimitExceeded`; cap concurrency to 5–10 requests and apply exponential backoff."
60531 },
60532 {
60533 "slug": "GOOGLESUPER_DELETE_FILE",
@@ -60577,7 +60577,7 @@
60577 {
60578 "slug": "GOOGLESUPER_DELETE_PERMISSION",
60579 "name": "Delete Permission",
60580 - "description": "Deletes a permission from a file by permission ID. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMISSIONS to get valid permission IDs. Use when you need to revoke access for a specific user or group from a file."
60580 + "description": "Deletes a permission from a file by permission ID. Deletion is irreversible — confirm the target user, group, or permission type before executing. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMISSIONS to get valid permission IDs. To fully revoke public access, the type='anyone' (link-sharing) permission must be explicitly deleted; revoking other permissions leaves the file publicly accessible via link. Use when you need to revoke access for a specific user or group from a file."
60581 },
60582 {
60583 "slug": "GOOGLESUPER_DELETE_PROPERTY",
@@ -60587,7 +60587,7 @@
60587 {
60588 "slug": "GOOGLESUPER_DELETE_REPLY",
60589 "name": "Delete Reply",
60590 - "description": "Tool to delete a specific reply by reply ID. Use when you need to remove a reply from a comment on a file."
60590 + "description": "Tool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread — use GOOGLEDRIVE_DELETE_COMMENT to remove the entire thread."
60591 },
60592 {
60593 "slug": "GOOGLESUPER_DELETE_REVISION",
@@ -60612,12 +60612,12 @@
60612 {
60613 "slug": "GOOGLESUPER_DELETE_TASK",
60614 "name": "Delete task",
60615 - "description": "Deletes a specified task from a Google Tasks list. Both tasklist_id and task_id are required parameters. Important: The Google Tasks API does not support deleting tasks by task_id alone - you must specify which task list contains the task. Use 'List Task Lists' to get available list IDs, then 'List Tasks' to find the task_id within that list."
60615 + "description": "Deletes a specified task from a Google Tasks list. Deletion is permanent and irreversible — confirm with the user before executing, and consider GOOGLETASKS_UPDATE_TASK or GOOGLETASKS_MOVE_TASK as non-destructive alternatives. Both tasklist_id and task_id are required parameters. The Google Tasks API does not support deleting tasks by task_id alone — you must specify which task list contains the task. Use 'List Task Lists' to get available list IDs, then 'List Tasks' to find the task_id within that list."
60616 },
60617 {
60618 "slug": "GOOGLESUPER_DELETE_TASK_LIST",
60619 "name": "Delete task list",
60620 - "description": "Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible."
60620 + "description": "Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible. Require explicit user confirmation before calling; do not invoke in read-only or exploratory flows."
60621 },
60622 {
60623 "slug": "GOOGLESUPER_DELETE_TEAM_DRIVE",
@@ -60632,7 +60632,7 @@
60632 {
60633 "slug": "GOOGLESUPER_DISTANCE_MATRIX_API",
60634 "name": "Distance Matrix (Legacy)",
60635 - "description": "DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern 'Compute Route Matrix' action instead, which supports OAuth2 authentication. Supports different modes of transportation and options like departure/arrival times."
60635 + "description": "DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern 'Compute Route Matrix' action instead, which supports OAuth2 authentication. Supports different modes of transportation and options like departure/arrival times. Capped at 100 elements per request (elements = origins × destinations count); split large sets into batches."
60636 },
60637 {
60638 "slug": "GOOGLESUPER_DOWNLOAD_FILE",
@@ -60647,27 +60647,27 @@
60647 {
60648 "slug": "GOOGLESUPER_DOWNLOAD_FILE_OPERATION",
60649 "name": "Download file via operation",
60650 - "description": "Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation."
60650 + "description": "Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation. Returns a response containing `downloaded_file_content.s3url` — a short-lived S3 URL; fetch the actual file bytes from that URL promptly after the call."
60651 },
60652 {
60653 "slug": "GOOGLESUPER_DUPLICATE_CALENDAR",
60654 "name": "Create a calendar",
60655 - "description": "Creates a new, empty Google Calendar with the specified title (summary)."
60655 + "description": "Creates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if needed."
60656 },
60657 {
60658 "slug": "GOOGLESUPER_EDIT_FILE",
60659 "name": "Edit File",
60660 - "description": "Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly."
60660 + "description": "Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly. Preserves the original file_id (unlike GOOGLEDRIVE_UPLOAD_FILE which creates a new ID)."
60661 },
60662 {
60663 "slug": "GOOGLESUPER_EMPTY_TRASH",
60664 "name": "Empty Trash",
60665 - "description": "Tool to permanently delete all of the user's trashed files. Use when you want to empty the trash in Google Drive. This action allows you to permanently remove all files that are currently in the trash of Google Drive. It can be applied to files in both the user's root trash and shared drives, ensuring a complete removal of unwanted files."
60665 + "description": "Tool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. Recovery is impossible after execution — no Drive tool can restore items once trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive's trash; omit to empty the user's root trash."
60666 },
60667 {
60668 "slug": "GOOGLESUPER_END_ACTIVE_CONFERENCE",
60669 "name": "End active conference",
60670 - "description": "Ends an active conference in a Google Meet space. REQUIRES 'space_name' parameter (e.g., 'spaces/jQCFfuBOdN5z' or just 'jQCFfuBOdN5z'). Use when you need to terminate an ongoing conference in a specified space. This operation only succeeds if a conference is actively running in the space. You must always provide the space_name to identify which space's conference to end."
60670 + "description": "Ends an active conference in a Google Meet space. REQUIRES 'space_name' parameter (e.g., 'spaces/jQCFfuBOdN5z' or just 'jQCFfuBOdN5z'). Use when you need to terminate an ongoing conference in a specified space. This operation only succeeds if a conference is actively running in the space. You must always provide the space_name to identify which space's conference to end. Immediately drops all active participants — obtain explicit user confirmation before calling."
60671 },
60672 {
60673 "slug": "GOOGLESUPER_EVENTS_GET",
@@ -60682,7 +60682,7 @@
60682 {
60683 "slug": "GOOGLESUPER_EVENTS_INSTANCES",
60684 "name": "Get Event Instances",
60685 - "description": "Returns instances of the specified recurring event."
60685 + "description": "Returns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying."
60686 },
60687 {
60688 "slug": "GOOGLESUPER_EVENTS_LIST",
@@ -60692,7 +60692,7 @@
60692 {
60693 "slug": "GOOGLESUPER_EVENTS_LIST_ALL_CALENDARS",
60694 "name": "List Events from All Calendars",
60695 - "description": "Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars."
60695 + "description": "Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars. An inverted or incorrect time range silently returns empty results rather than an error. An empty `items` list means no events matched the filters—adjust `time_min`, `time_max`, or `q` before concluding no events exist."
60696 },
60697 {
60698 "slug": "GOOGLESUPER_EVENTS_MOVE",
@@ -60702,7 +60702,7 @@
60702 {
60703 "slug": "GOOGLESUPER_EVENTS_WATCH",
60704 "name": "Watch Events",
60705 - "description": "Watch for changes to Events resources."
60705 + "description": "Watch for changes to Events resources. Watch channels expire; persist the channel `id` per `calendarId` to re-establish watches after expiration or restarts."
60706 },
60707 {
60708 "slug": "GOOGLESUPER_EXECUTE_SQL",
@@ -60722,22 +60722,22 @@
60722 {
60723 "slug": "GOOGLESUPER_FETCH_EMAILS",
60724 "name": "Fetch emails",
60725 - "description": "Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval."
60725 + "description": "Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval. Results are NOT sorted by recency; sort by internalDate client-side. The messages field may be absent or empty (valid no-results state); always null-check before accessing messageId or threadId. Null-check subject and header fields before string operations. For large result sets, prefer ids_only=true or metadata-only listing, then hydrate via GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID."
60726 },
60727 {
60728 "slug": "GOOGLESUPER_FETCH_MESSAGE_BY_MESSAGE_ID",
60729 "name": "Fetch message by message ID",
60730 - "description": "Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`."
60730 + "description": "Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`. Spam/trash messages are excluded unless upstream list/search calls used `include_spam_trash=true`. Use `internalDate` (milliseconds since epoch) rather than header `Date` for recency checks."
60731 },
60732 {
60733 "slug": "GOOGLESUPER_FETCH_MESSAGE_BY_THREAD_ID",
60734 "name": "Fetch Message by Thread ID",
60735 - "description": "Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`."
60735 + "description": "Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`. Returns a `messages` array; `thread_id` is not echoed in the response. Message order is not guaranteed — sort by `internalDate` to find oldest/newest. Check `labelIds` per message to filter drafts. Concurrent bulk calls may trigger 403 `userRateLimitExceeded` or 429; cap concurrency ~10 and use exponential backoff."
60736 },
60737 {
60738 "slug": "GOOGLESUPER_FIND_EVENT",
60739 "name": "Find event",
60740 - "description": "Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types; ensure `timeMin` is not chronologically after `timeMax` if both are provided."
60740 + "description": "Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types. Ensure `timeMin` is not chronologically after `timeMax` if both are provided. Results may span multiple pages; always follow `nextPageToken` until absent to avoid silently missing events. Validate the correct match from results by checking summary, start.dateTime, and organizer.email before using event_id for mutations. An empty `items` array means no events matched — widen filters rather than treating it as an error."
60741 },
60742 {
60743 "slug": "GOOGLESUPER_FIND_FILE",
@@ -60752,7 +60752,7 @@
60752 {
60753 "slug": "GOOGLESUPER_FIND_FREE_SLOTS",
60754 "name": "Find free slots",
60755 - "description": "Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range. If `time_min` is not provided, defaults to the current timestamp in the specified timezone. If `time_max` is not provided, defaults to 23:59:59 of the day specified in `time_min` (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Returns busy intervals and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods."
60755 + "description": "Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range. If `time_min` is not provided, defaults to the current timestamp in the specified timezone. If `time_max` is not provided, defaults to 23:59:59 of the day specified in `time_min` (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Returns busy intervals and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods. Returned free slots are unfiltered by duration; callers must filter intervals to those fully containing the required meeting length. No event metadata (titles, descriptions, links) is returned; use GOOGLECALENDAR_EVENTS_LIST for event details."
60756 },
60757 {
60758 "slug": "GOOGLESUPER_FIND_REPLACE",
@@ -60772,12 +60772,12 @@
60772 {
60773 "slug": "GOOGLESUPER_FORWARD_MESSAGE",
60774 "name": "Forward email message",
60775 - "description": "Forward an existing Gmail message to specified recipients, preserving original body and attachments."
60775 + "description": "Forward an existing Gmail message to specified recipients, preserving original body and attachments. Verify recipients and content before forwarding to avoid unintended exposure. Bulk forwarding may trigger 429/5xx rate limits; keep concurrency to 5–10 and apply backoff. Messages near Gmail's size limits may fail; reconstruct a smaller draft if needed."
60776 },
60777 {
60778 "slug": "GOOGLESUPER_FREE_BUSY_QUERY",
60779 "name": "Query Free/Busy Information (Deprecated)",
60780 - "description": "DEPRECATED: Use GOOGLECALENDAR_FIND_FREE_SLOTS instead. Returns free/busy information for a set of calendars."
60780 + "description": "DEPRECATED: Use GOOGLECALENDAR_FIND_FREE_SLOTS instead (though this tool provides wider secondary/shared calendar coverage). Returns opaque busy intervals only—no event titles or details; use GOOGLECALENDAR_EVENTS_LIST when event details are needed."
60781 },
60782 {
60783 "slug": "GOOGLESUPER_GENERATE_IDS",
@@ -60792,7 +60792,7 @@
60792 {
60793 "slug": "GOOGLESUPER_GEOCODE_ADDRESS_WITH_QUERY",
60794 "name": "Geocode Address With Query",
60795 - "description": "Tool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API."
60795 + "description": "Tool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API. Results may match multiple places — always verify `formattedAddress`, `region`, and `addressComponents` in the response before using returned coordinates."
60796 },
60797 {
60798 "slug": "GOOGLESUPER_GEOCODE_DESTINATIONS",
@@ -60802,7 +60802,7 @@
60802 {
60803 "slug": "GOOGLESUPER_GEOCODE_LOCATION",
60804 "name": "Reverse Geocode Location",
60805 - "description": "Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates."
60805 + "description": "Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates. A single coordinate pair may return multiple results; verify formattedAddress, region, and addressComponents before committing to a result."
60806 },
60807 {
60808 "slug": "GOOGLESUPER_GEOCODE_PLACE",
@@ -60812,7 +60812,7 @@
60812 {
60813 "slug": "GOOGLESUPER_GEOCODING_API",
60814 "name": "Geocoding API",
60815 - "description": "Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. Uses the Geocoding API v4 (v4beta) which supports OAuth2 authentication."
60815 + "description": "Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. Uses the Geocoding API v4 (v4beta) which supports OAuth2 authentication. Exactly one of `address`, `latlng`, or `place_id` must be provided per request; omitting all three or mixing incompatible combinations yields no useful results."
60816 },
60817 {
60818 "slug": "GOOGLESUPER_GEOLOCATE",
@@ -60827,12 +60827,12 @@
60827 {
60828 "slug": "GOOGLESUPER_GET3D_TILES_ROOT",
60829 "name": "Get 3D Tiles Root",
60830 - "description": "Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google's photorealistic tiles following the OGC 3D Tiles specification."
60830 + "description": "Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google's photorealistic tiles following the OGC 3D Tiles specification. The Map Tiles API is billable per request; cache the root response client-side and avoid repeated calls."
60831 },
60832 {
60833 "slug": "GOOGLESUPER_GET_ABOUT",
60834 "name": "Get about",
60835 - "description": "Tool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats."
60835 + "description": "Tool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats. Note: storageQuota reflects My Drive (personal) storage only — it does not cover shared drives; use GOOGLEDRIVE_LIST_SHARED_DRIVES and GOOGLEDRIVE_GET_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately."
60836 },
60837 {
60838 "slug": "GOOGLESUPER_GET_ACCOUNT",
@@ -60852,7 +60852,7 @@
60852 {
60853 "slug": "GOOGLESUPER_GET_ATTACHMENT",
60854 "name": "Get Gmail attachment",
60855 - "description": "Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs."
60855 + "description": "Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs. Returns base64url-encoded binary data (up to ~25 MB); the downloaded file location is at data.file.s3url (also exposes mimetype and name; no s3key). Attachments exceeding ~25 MB may be exposed as Google Drive links — use GOOGLEDRIVE_DOWNLOAD_FILE when a Drive file_id is present instead."
60856 },
60857 {
60858 "slug": "GOOGLESUPER_GET_ATTRIBUTION_SETTINGS",
@@ -60887,7 +60887,7 @@
60887 {
60888 "slug": "GOOGLESUPER_GET_CALENDAR",
60889 "name": "Get Google Calendar",
60890 - "description": "Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access."
60890 + "description": "Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access. Response includes `timeZone` (IANA format, e.g., 'America/Los_Angeles') — use it directly when constructing `timeMin`/`timeMax` in other tools to avoid DST errors. An empty `defaultReminders` list is valid (no defaults configured). Insufficient `accessRole` may omit fields like `defaultReminders` and `colorId`."
60891 },
60892 {
60893 "slug": "GOOGLESUPER_GET_CALENDAR_PROFILE",
@@ -60897,12 +60897,12 @@
60897 {
60898 "slug": "GOOGLESUPER_GET_CAMPAIGN_BY_ID",
60899 "name": "Get Campaign By Id",
60900 - "description": "GetCampaignById Tool will return details of a campaign in Google Ads."
60900 + "description": "GetCampaignById Tool returns details of a campaign in Google Ads. Requires an active Google Ads OAuth connection with the correct customer_id configured; missing or mismatched customer_id will cause empty results."
60901 },
60902 {
60903 "slug": "GOOGLESUPER_GET_CAMPAIGN_BY_NAME",
60904 "name": "Get campaign by name",
60905 - "description": "GetCampaignByName Tool will run a SQL GetCampaignByName in Google Ads."
60905 + "description": "Queries Google Ads via SQL to retrieve a campaign by its exact name. Requires an active Google Ads connection with valid customer_id and appropriate OAuth scopes."
60906 },
60907 {
60908 "slug": "GOOGLESUPER_GET_CHANGE",
@@ -60912,7 +60912,7 @@
60912 {
60913 "slug": "GOOGLESUPER_GET_CHANGES_START_PAGE_TOKEN",
60914 "name": "Get Changes Start Page Token",
60915 - "description": "Tool to get the starting pageToken for listing future changes in Google Drive. Use this when you need to track changes to files and folders."
60915 + "description": "Tool to get the starting pageToken for listing future changes in Google Drive. Returns only a token — pass it to GOOGLEDRIVE_LIST_CHANGES to retrieve actual changes. Persist this token; losing it requires a full rescan. The token is forward-looking: GOOGLEDRIVE_LIST_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE; use this tool only for incremental change-feed workflows."
60916 },
60917 {
60918 "slug": "GOOGLESUPER_GET_CHILD",
@@ -60937,12 +60937,12 @@
60937 {
60938 "slug": "GOOGLESUPER_GET_CONTACTS",
60939 "name": "Get contacts",
60940 - "description": "Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination."
60940 + "description": "Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination. Only covers saved contacts and 'Other Contacts'; email-header-only senders are out of scope. Contact records may have sparse data — handle missing fields gracefully. People API shares a per-user QPS quota; HTTP 429 requires exponential backoff (1s, 2s, 4s)."
60941 },
60942 {
60943 "slug": "GOOGLESUPER_GET_CURRENT_DATE_TIME",
60944 "name": "Get current date and time",
60945 - "description": "Gets the current date and time, allowing for a specific timezone offset."
60945 + "description": "Gets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., 'tomorrow', 'next Monday') to avoid off-by-one-day errors across timezones."
60946 },
60947 {
60948 "slug": "GOOGLESUPER_GET_CUSTOM_DIMENSION",
@@ -60952,7 +60952,7 @@
60952 {
60953 "slug": "GOOGLESUPER_GET_CUSTOMER_LISTS",
60954 "name": "Get customer lists",
60955 - "description": "GetCustomerLists Tool will list all customer lists in Google Ads."
60955 + "description": "GetCustomerLists Tool lists all customer lists (audience/remarketing lists) in Google Ads. These are user segments for targeting, not Google Ads accounts — list IDs are distinct from account IDs. When multiple lists share similar names, review all returned results before selecting one for downstream operations."
60956 },
60957 {
60958 "slug": "GOOGLESUPER_GET_DATA_RETENTION_SETTINGS",
@@ -60992,12 +60992,12 @@
60992 {
60993 "slug": "GOOGLESUPER_GET_DRIVE",
60994 "name": "Get Shared Drive",
60995 - "description": "Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive."
60995 + "description": "Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. To discover drive_ids, use GOOGLEDRIVE_LIST_SHARED_DRIVES first; GOOGLEDRIVE_GET_ABOUT reflects overall user storage, not individual shared drive details. Permission changes may have a brief propagation delay before appearing in results."
60996 },
60997 {
60998 "slug": "GOOGLESUPER_GET_FILE_METADATA",
60999 "name": "Get File Metadata",
61000 - "description": "Tool to get a file's metadata by ID. Use when you need to retrieve the metadata for a specific file in Google Drive."

This file is too large to show in full.