Affinity MCP Automation

Use the Affinity MCP as a live application-control surface. Work from the open document, inspect before editing, prefer small reversible commands, and verify visual results.

Standard Workflow

1. Load Affinity tools if they are not already present.
2. Read SDK documentation in this order:
   • Always read preamble first.
   • Call list_sdk_documentation.
   • Read only the topics needed for the task, such as application.js, document.js, nodes.js, commands.js, geometry.js, colours.js, fills.js, linestyle.js, storybuilder.js, glyphatts.js, paragraphatts.js, or exportconfig.js.
3. Inspect the current document before making changes.
4. Choose the narrowest edit: selected object first, current spread next, whole document only when requested.
5. Execute scripts with the Affinity MCP execute_script capability; a harness may expose a qualified tool name. Use console.log(JSON.stringify(...)) for observable output.
6. Verify with render_selection(document_session_uuid) whenever the result is visual.
7. Do not save, export, flatten, delete broad selections, or resize the spread unless the user asked for that kind of change.

Document Inspection