Abilities API: Forms

[n7studios]

Summary

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

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

Improves the descriptions of the tools.

Testing

• MCPContentFormTest: 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]

LGTM ✅

[ciccio-kit]

nitpick (non-blocking): this and other descriptions for tools that work on a single item should probably not use the plural (label looks good)

[ciccio-kit]

niptick (non-blocking): should this comment be updated like in the other get_description in this PR?