foundry-mcp-reference

To safely edit Foundry MCP docs, first read the page using get_page, then apply surgical leaf edits with update_section on the deepest heading possible while preserving annotations. This safe-edit workflow prevents structural corruption and annotation loss.

Surgical edits target specific sections using update_section on the deepest heading path to preserve existing annotations, whereas full rewrites replace larger content blocks and risk structural corruption. Choose surgical edits for targeted changes and rewrites only when necessary.

Nested-heading paths in Foundry MCP define the hierarchical structure used to locate specific sections for update_section operations. You navigate through these heading levels to apply surgical leaf edits precisely, ensuring you modify only the intended content without affecting surrounding structure.

Foundry MCP annotations disappear when using full rewrites instead of surgical edits or when failing to preserve annotation markers during update_section operations. To avoid annotation loss, always apply surgical leaf edits on the deepest heading possible and preserve existing annotation structures.

Yes, you can use delete_doc and create_doc safely by following the safe-edit workflow and understanding the mental model for Foundry MCP operations. Always verify heading paths and annotation dependencies before deleting or creating documents to maintain structural integrity.

Dispatch sub-agents via MCP annotations when your Foundry MCP workflow requires delegated tasks within document sections. The reference provides practical guidelines for annotation handling, ensuring sub-agents are triggered correctly without disrupting the safe-edit workflow or heading structure.