Skip to content

feat: MCP annotations batch 1/65 (100 components) #18513

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

feat: MCP annotations batch 1/65 (100 components) #18513

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion components/_0codekit/actions/compress-pdf/compress-pdf.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_0codekit-compress-pdf",
name: "Compress PDF",
description: "Compresses a PDF using the specified URL. [See the documentation](https://documenter.getpostman.com/view/18297710/UVkntwBv#fdcb09dc-c316-4b80-b523-5a1f3afac1e6)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
Comment on lines +7 to +12
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

Verify readOnlyHint: true is accurate.

The action compresses a PDF and returns a URL to the compressed file (getAsUrl: true on line 34), which suggests it creates/stores a new resource. Confirm whether readOnlyHint: true correctly reflects the operation, or if it should be false since compression typically produces a new artifact.

🏁 Script executed:

#!/bin/bash
# Description: Check if other PDF/compression actions use readOnlyHint: true or false
# Expected: Find similar compress/transform actions and their readOnlyHint values

rg -n -C3 --type=js 'key:.*compress.*pdf|name:.*[Cc]ompress.*PDF' -A20 | rg 'readOnlyHint'

Length of output: 0

🏁 Script executed:

#!/bin/bash
# Find all occurrences of readOnlyHint in the codebase
rg -n 'readOnlyHint' -C2

# Find all actions using getAsUrl and show context for annotations
rg -n -C5 'getAsUrl'

Length of output: 66159

Set readOnlyHint to false for compress-pdf action
Since this action generates and returns a new compressed PDF URL (getAsUrl: true), it writes a new resource—update readOnlyHint in components/_0codekit/actions/compress-pdf/compress-pdf.mjs (lines 7–12) from true to false.

🤖 Prompt for AI Agents 
In components/_0codekit/actions/compress-pdf/compress-pdf.mjs around lines 7 to
12, the action sets annotations.readOnlyHint to true despite generating and
returning a new compressed PDF URL; update annotations.readOnlyHint from true to
false to reflect that the action writes a new resource (ensure only that boolean
value is changed).

type: "action",
props: {
_0codekit,
Expand Down
7 changes: 6 additions & 1 deletion components/_0codekit/actions/read-barcode/read-barcode.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_0codekit-read-barcode",
name: "Read Barcode",
description: "Reads a QR code from an image. [See the documentation](https://documenter.getpostman.com/view/18297710/UVkntwBv#84ecd80e-af50-406b-abd7-698826773500)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
_0codekit,
Expand Down
7 changes: 6 additions & 1 deletion components/_1crm/actions/create-contact/create-contact.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,12 @@ export default {
key: "_1crm-create-contact",
name: "Create Contact",
description: "Creates a new contact in the 1CRM system. [See the documentation](https://demo.1crmcloud.com/api.php#endpoint_dataList_post)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
methods: {
...common.methods,
Expand Down
7 changes: 6 additions & 1 deletion components/_1crm/actions/create-lead/create-lead.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,12 @@ export default {
key: "_1crm-create-lead",
name: "Create Lead",
description: "Crafts a new lead in 1CRM. [See the documentation](https://demo.1crmcloud.com/api.php#endpoint_dataList_post)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
methods: {
...common.methods,
Expand Down
7 changes: 6 additions & 1 deletion components/_1crm/actions/update-contact/update-contact.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,12 @@ export default {
key: "_1crm-update-contact",
name: "Update Contact",
description: "Modifies an existing contact within the 1CRM system. [See the documentation](https://demo.1crmcloud.com/api.php#endpoint_dataRecord_patch)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: true,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
...common.props,
Expand Down
7 changes: 6 additions & 1 deletion components/_1crm/actions/update-lead/update-lead.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,12 @@ export default {
key: "_1crm-update-lead",
name: "Update Lead",
description: "Updates an existing lead in 1CRM. [See the documentation](https://demo.1crmcloud.com/api.php#endpoint_dataRecord_patch)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: true,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
...common.props,
Expand Down
7 changes: 6 additions & 1 deletion components/_2chat/actions/check-phone-number-whatsapp/check-phone-number-whatsapp.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_2chat-check-phone-number-whatsapp",
name: "Check Phone Number for WhatsApp",
description: "Checks if a given phone number has a WhatsApp account. [See the documentation](https://developers.2chat.co/docs/API/WhatsApp/check-number)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
twoChat,
Expand Down
7 changes: 6 additions & 1 deletion components/_2chat/actions/create-contact/create-contact.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_2chat-create-contact",
name: "Create Contact",
description: "Creates a new contact in 2Chat. [See the documentation](https://developers.2chat.co/docs/API/Contacts/create-contact)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
twoChat,
Expand Down
7 changes: 6 additions & 1 deletion components/_2chat/actions/send-whatsapp-text-message/send-whatsapp-text-message.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_2chat-send-whatsapp-text-message",
name: "Send Whatsapp Text Message",
description: "Sends a text message to a designated whatsapp-enabled phone number. [See the documentation](https://developers.2chat.co/docs/API/WhatsApp/send-message)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: true,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
twoChat,
Expand Down
7 changes: 6 additions & 1 deletion components/_2markdown/actions/html-file-to-markdown/html-file-to-markdown.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,12 @@ export default {
key: "_2markdown-html-file-to-markdown",
name: "HTML File to Markdown",
description: "Convert an HTML file to Markdown format. [See the documentation](https://2markdown.com/docs#file2md)",
version: "0.1.0",
version: "0.1.1",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
_2markdown,
Expand Down
7 changes: 6 additions & 1 deletion components/_2markdown/actions/html-to-markdown/html-to-markdown.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_2markdown-html-to-markdown",
name: "HTML to Markdown",
description: "Convert raw HTML content to Markdown format. [See the documentation](https://2markdown.com/docs#html2md)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
_2markdown,
Expand Down
7 changes: 6 additions & 1 deletion components/_2markdown/actions/pdf-to-markdown/pdf-to-markdown.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,12 @@ export default {
key: "_2markdown-pdf-to-markdown",
name: "PDF to Markdown",
description: "Convert a PDF document to Markdown format. [See the documentation](https://2markdown.com/docs#pdf2md)",
version: "0.1.0",
version: "0.1.1",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
_2markdown,
Expand Down
7 changes: 6 additions & 1 deletion components/_2markdown/actions/url-to-markdown/url-to-markdown.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_2markdown-url-to-markdown",
name: "URL to Markdown",
description: "Extract the essential content of a website as plaintext. [See the documentation](https://2markdown.com/docs#url2md)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
_2markdown,
Expand Down
7 changes: 6 additions & 1 deletion components/_360nrs/actions/send-sms/send-sms.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,12 @@ export default {
key: "_360nrs-send-sms",
name: "Send SMS",
description: "Send an SMS message to one or more recipients. [See the documentation](https://apidocs.360nrs.com/?shell#sms)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_46elks/actions/make-phone-call/make-phone-call.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_46elks-make-phone-call",
name: "Make Phone Call",
description: "Dials and connects two phone numbers using the 46elks service. [See the documentation](https://46elks.com/docs/make-call)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
Comment on lines +7 to +12
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Flip destructiveHint to true

This action places a live phone call via 46elks, which is a side-effecting operation in the real world. Marking it as non-destructive misleads users and any automation that relies on these hints to detect risky actions. Please set destructiveHint: true to match the behavior.

🤖 Prompt for AI Agents 
In components/_46elks/actions/make-phone-call/make-phone-call.mjs around lines 7
to 12, the annotations object incorrectly sets destructiveHint to false even
though this action places a live phone call; change destructiveHint: false to
destructiveHint: true so the hint accurately reflects the side-effecting nature
of the action, leaving the other annotation keys (openWorldHint, readOnlyHint)
unchanged.

type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_46elks/actions/send-sms/send-sms.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_46elks-send-sms",
name: "Send SMS",
description: "Composes and sends an SMS message to a specified phone number. [See the documentation](https://46elks.com/docs/send-sms)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_4dem/actions/confirm-email/confirm-email.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_4dem-confirm-email",
name: "Confirm Email",
description: "Confirm sender email address. [See the documentation](https://api.4dem.it/#/operations/senders.email.confirm)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_4dem/actions/create-email/create-email.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_4dem-create-email",
name: "Create Email",
description: "Create a new email. [See the documentation](https://api.4dem.it/#/operations/contents.email.store)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
Comment on lines +7 to +12
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Creating emails isn’t read-only

This action persists a new email draft in 4DEM, so it definitely mutates external state. With destructiveHint: false, users lose the warning that they’re writing data. Please set destructiveHint to true.

🤖 Prompt for AI Agents 
In components/_4dem/actions/create-email/create-email.mjs around lines 7 to 12,
the action sets destructiveHint: false even though it creates/persists a new
email draft; change destructiveHint to true to indicate the action mutates
external state. Update the annotations block so destructiveHint: true is set
(leave other hints as-is) and ensure any tests or documentation reflecting
destructive behavior are adjusted accordingly.

type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_4dem/actions/create-sender/create-sender.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_4dem-create-sender",
name: "Create Sender",
description: "Create an email sender. You will need to confirm the email address used during creation. [See the documentation](https://api.4dem.it/#/operations/senders.email.store)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_8x8_connect/actions/get-log-result/get-log-result.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_8x8_connect-get-log-result",
name: "Get Log Result",
description: "Check the status of an SMS Logs export job and to get a download link if its generation has succeeded. [See the documentation](https://developer.8x8.com/connect/reference/get-log-export-job-result)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_8x8_connect/actions/request-log/request-log.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_8x8_connect-request-log",
name: "Request Log",
description: "Request an SMS log file. [See the documentation](https://developer.8x8.com/connect/reference/start-log-export-job)",
version: "0.0.4",
version: "0.0.5",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_8x8_connect/actions/send-sms/send-sms.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_8x8_connect-send-sms",
name: "Send SMS",
description: "Send a SMS to the specified destination. [See the documentation](https://developer.8x8.com/connect/reference/send-sms-single)",
version: "0.0.2",
version: "0.0.3",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
app,
Expand Down
7 changes: 6 additions & 1 deletion components/_twocaptcha/actions/check-account-balance/check-account-balance.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_twocaptcha-check-account-balance",
name: "Check 2Captcha Account Balance",
description: "Get the current account balance from the 2Captcha API. [See the documentation](https://2captcha.com/api-docs/get-balance)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
_twocaptcha,
Expand Down
7 changes: 6 additions & 1 deletion components/_twocaptcha/actions/retrieve-solution/retrieve-solution.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "_twocaptcha-retrieve-solution",
name: "Retrieve Captcha Solution",
description: "Fetch the solution of a previously submitted captcha from the 2Captcha service.",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
_twocaptcha,
Expand Down
7 changes: 6 additions & 1 deletion components/_twocaptcha/actions/submit-captcha/submit-captcha.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,12 @@ export default {
key: "_twocaptcha-submit-captcha",
name: "Submit Captcha for Solving",
description: "Send a new captcha to the 2Captcha service for solving. Required props are clientKey and task object.",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
_twocaptcha,
Expand Down
7 changes: 6 additions & 1 deletion components/ably/actions/publish-message/publish-message.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,12 @@ import ably from "../../ably.app.mjs";

export default {
name: "Publish Message",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
key: "ably-publish-message",
description: "Publish a message in a channel. [See docs here](https://ably.com/docs/realtime/messages#message-publish)",
type: "action",
Expand Down
7 changes: 6 additions & 1 deletion components/ably/actions/publish-push-notification/publish-push-notification.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,12 @@ import ably from "../../ably.app.mjs";

export default {
name: "Publish Push Notification",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: false,
},
key: "ably-publish-push-notification",
description: "Publish a push notification for a channel. [See docs here](https://ably.com/docs/general/push/publish#channel-broadcast-example)",
type: "action",
Expand Down
7 changes: 6 additions & 1 deletion components/abstract/actions/validate-email/validate-email.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,12 @@ export default {
key: "abstract-validate-email",
name: "Validate Email",
description: "Check the deliverability of a specified email address. [See the documentation](https://docs.abstractapi.com/email-validation)",
version: "0.0.1",
version: "0.0.2",
annotations: {
destructiveHint: false,
openWorldHint: true,
readOnlyHint: true,
},
type: "action",
props: {
abstract,
Expand Down
Loading
Loading