Abilities API: Form Triggers

[n7studios]

Summary

Registers four abilities (MCP tools) for the Form Trigger block/shortcode, so an MCP client can list, insert, update and delete Kit Form Triggers inside a post's content.

Ability	Description	Required input	Output
kit/formtrigger-list	Lists every Kit Form Trigger block in the given post, with each occurrence's index and form ID.	post_id	{ post_id, count, occurrences: [{ occurrence_index, attrs }] }
kit/formtrigger-insert	Inserts a new Kit Form Trigger block. Position: append (default), prepend, or index with numeric index.	post_id, attrs.form	{ post_id, occurrence_index }
kit/formtrigger-update	Updates the attrs of a specific Form Trigger block by occurrence index.	post_id, occurrence_index, attrs.form	{ post_id, occurrence_index }
kit/formtrigger-delete	Removes a specific Form Trigger block by occurrence index.	post_id, occurrence_index	{ post_id, occurrence_index }

Improves the descriptions of the tools.

Testing

• MCPContentFormTriggerTest: Tests that MCP tools are registered, permissions are honored, insert/update/delete tools work.

Checklist

• I have written a test and included it in this PR
• I have run all tests and they pass
• The code passes when running the PHP CodeSniffer
• Code meets WordPress Coding Standards for PHP, HTML, CSS and JS
• Security and Sanitization requirements have been followed
• I have assigned a reviewer or two to review this PR (if you're not sure who to assign, we can do this step for you)

[github-actions]

WordPress Playground

🚀 Your PR has been built and is ready for testing in WordPress Playground!

Click here to test your changes in WordPress Playground

[ciccio-kit]

before approving this, could you double-check that the shared get_input_schema_property_type() mapping in class-convertkit-mcp-ability-content.php doesn't need updating? In theory form triggers should have different fields that would fall through the map and return their own key rather than "string" as a type

[n7studios]

before approving this, could you double-check that the shared get_input_schema_property_type() mapping in class-convertkit-mcp-ability-content.php doesn't need updating? In theory form triggers should have different fields that would fall through the map and return their own key rather than "string" as a type

Fixed to return string as the type for this. Thanks!

[github-actions]

WordPress Playground

🚀 Your PR has been built and is ready for testing in WordPress Playground!

Click here to test your changes in WordPress Playground

[ciccio-kit]

LGTM ✅