MCP Server for PowerPoint manipulation using python-pptx - Consolidated Edition
21 tools with complete schemas and descriptions, but quality is inconsistent. Most tools have adequate naming (verb_noun pattern) and parameter descriptions, but many descriptions are generic or lack actionable context. Output schemas are not documented. Error handling is minimal, most tools return bare error dicts without recovery guidance. No tool annotations beyond basic ToolAnnotations(title=...). Parameter validation is present but not comprehensive. Composition is reasonable (single responsibility per tool), but some tools like apply_professional_design are overloaded with multiple operations.
Add connector lines/arrows between points on a slide.
Add an auto shape to a slide with enhanced options.
Add a new slide to the presentation with optional background styling.
Add a table to a slide with enhanced formatting options.
Apply multiple picture effects in combination.
Unified professional design tool for themes, slides, and visual enhancements. This applies professional styling and themes rather than structural layout changes.
Create a new PowerPoint presentation.
Output schemas not documented. Tools return dicts with 'message', 'error', or operation results, but LLMs cannot predict field structure or plan downstream calls. No documented return types for any tool.
apply_professional_design violates single-responsibility principle. One tool handles 'professional_slide', 'theme', 'enhance', and 'get_schemes' operations. Should split into separate tools (apply_theme, enhance_slide, list_color_schemes).
Error handling is minimal. Most tools return {'error': 'message'} without recovery guidance. No indication of retryability, user-fixable vs fatal, or next steps. E.g., 'Presentation not found' should suggest 'Try create_presentation() or open_presentation(file_path)'.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
Create a new PowerPoint presentation from a template file.
Extract all text content from all slides in the presentation.
Extract all text content from a specific slide.
Format a specific table cell.
Get information about a presentation.
Get information about a specific slide.
Get information about a template file including layouts and properties.
Manage hyperlinks in text shapes and runs.
Access and manage slide master properties and layouts.
Open an existing PowerPoint presentation from a file.
Populate a placeholder with text.
Save a presentation to a file.
Set core document properties.
Replace existing chart data with new categories and series.
Descriptions lack actionable context. Many are under 100 chars and generic (e.g., 'Get information about a specific slide'). Should explain WHEN to use, WHAT it returns, and dependencies. E.g., 'Retrieve slide layout, shape count, and text content. Call this first to understand slide structure before modifying.'
manage_hyperlinks operation parameter is free-form string ('add', 'remove', 'list', 'update'). Should be an enum to prevent hallucinated values and enable LLM to pick valid options.