Skip to content

Commit 0125524

Browse files
Phil Whittakerclaude
andcommitted
Update excluded-tools documentation
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 9d4a078 commit 0125524

File tree

1 file changed

+1
-81
lines changed

1 file changed

+1
-81
lines changed

16/umbraco-cms/reference/developer-mcp/excluded-tools.md

Lines changed: 1 addition & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -130,84 +130,4 @@ These endpoints are intentionally not implemented in the MCP server, typically b
130130

131131
### Dynamic (2 endpoints)
132132
- `getDynamicRootSteps` - Dynamic root configuration steps (advanced configuration functionality)
133-
- `postDynamicRootQuery` - Dynamic root query processing (advanced configuration functionality)
134-
135-
## Rationale
136-
137-
Import/Export endpoints are excluded because:
138-
1. They typically handle complex file operations that are better managed through the Umbraco UI
139-
2. Import operations can have wide-ranging effects on the system
140-
3. Export formats may be complex and not suitable for MCP tool responses
141-
4. These operations often require additional validation and user confirmation
142-
143-
Install endpoints are excluded because:
144-
1. Installation operations modify core system configuration and should only be performed during initial setup
145-
2. Database validation during installation involves sensitive system checks
146-
3. Installation settings contain system-level configuration that should not be exposed or modified after setup
147-
4. These operations are typically only relevant during the initial Umbraco installation process
148-
149-
Package endpoints are excluded because:
150-
1. Package creation and management involve complex file operations
151-
2. Package installation can have system-wide effects requiring careful validation
152-
3. Package migration operations should be handled with caution in the Umbraco UI
153-
4. Download functionality may not be suitable for MCP tool responses
154-
155-
Security endpoints are excluded because:
156-
1. Password reset operations involve sensitive security workflows
157-
2. These operations typically require email verification and user interaction
158-
3. Security configuration changes should be handled carefully through the Umbraco UI
159-
4. Automated security operations could pose security risks if misused
160-
161-
Telemetry endpoints are excluded because:
162-
1. System telemetry data may contain sensitive system information
163-
164-
User Group membership endpoints are excluded because:
165-
1. These operations present severe permission escalation risks
166-
2. AI could potentially assign users to administrator groups
167-
3. User group membership changes can compromise system security
168-
4. These sensitive operations should only be performed through the Umbraco UI with proper oversight
169-
170-
PublishedCache endpoints are excluded because:
171-
1. Cache rebuild operations can significantly impact system performance and should be carefully timed
172-
2. Cache operations can affect site availability and user experience during execution
173-
3. Cache rebuild status monitoring could expose sensitive system performance information
174-
175-
Upgrade endpoints are excluded because:
176-
1. System upgrade operations involve critical system modifications that could break the installation
177-
2. Upgrade settings contain sensitive system configuration that should not be exposed
178-
3. Upgrade authorization involves system-level changes that require careful oversight
179-
4. These operations are typically only relevant during major version upgrades and should be handled through the Umbraco UI
180-
181-
User endpoints are excluded because:
182-
1. User creation could enable account proliferation and privilege escalation attacks
183-
2. User deletion could cause denial of service by removing critical admin accounts and permanent data loss
184-
3. Password operations could enable account takeover and bypass security controls
185-
4. 2FA management could compromise multi-factor authentication security
186-
5. Client credentials expose sensitive API keys and authentication tokens
187-
6. User invitation system could be abused for spam or unauthorized account creation
188-
7. User state changes (disable/enable/unlock) could be used for denial of service attacks
189-
8. These operations require secure UI flows with proper validation and user confirmation
190-
9. Automated user security operations pose significant risks if misused by AI systems
191-
192-
Profiling endpoints are excluded because:
193-
1. These endpoints control the MiniProfiler, which is a frontend debugging tool for web browsers
194-
2. Profiler activation and status are not relevant for MCP operations that work with data rather than UI
195-
3. The MiniProfiler is designed for developer debugging during web development, not for automated API interactions
196-
4. These operations are frontend-specific functionality that has no use case in the MCP context
197-
198-
Preview endpoints are excluded because:
199-
1. Content preview functionality is designed for frontend website display and user interface interactions
200-
2. Preview operations are primarily used for content editors to see how content will appear on the website
201-
3. These operations are frontend-specific and not relevant for automated data management through MCP
202-
203-
Oembed endpoints are excluded because:
204-
1. oEmbed functionality is used for embedding external media content (videos, social media posts) into rich text editor
205-
2. This is primarily a frontend feature for content display and presentation
206-
207-
Object endpoints are excluded because:
208-
1. Object type enumeration provides internal system metadata about Umbraco's object structure
209-
2. This information is primarily used by the Umbraco backend for internal operations and UI generation
210-
211-
Dynamic endpoints are excluded because:
212-
1. Dynamic root functionality is an advanced configuration feature for creating custom content tree structures
213-
2. These operations are better compled using the UI
133+
- `postDynamicRootQuery` - Dynamic root query processing (advanced configuration functionality)

0 commit comments

Comments
 (0)