Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@propresenter-mcp Go to the next slide"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A comprehensive Model Context Protocol (MCP) server that provides complete control over ProPresenter presentations via the ProPresenter API. This server implements the full ProPresenter API specification with 231 endpoints organized into 27 API groups and exposed through modular client classes.
Related MCP server: MADRIX MCP
Node.js 18 or higher
ProPresenter 7 with API enabled
ProPresenter running and accessible on your network
Clone this repository or download the source code
Install dependencies:
npm installBuild the project:
npm run buildThe server connects to ProPresenter using environment variables:
PROPRESENTER_URL - The URL of your ProPresenter instance (default: http://localhost:50000)
PROPRESENTER_PASSWORD - The API password (if configured in ProPresenter)
Open ProPresenter preferences
Go to the Network tab
Enable "Network" and note the port number (default: 50000)
Optionally set a password for API access
Add this to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"propresenter": {
"command": "node",
"args": ["/absolute/path/to/propresenter-mcp/build/index.js"],
"env": {
"PROPRESENTER_URL": "http://localhost:50000",
"PROPRESENTER_PASSWORD": "your-password-if-needed"
}
}
}
}Replace /absolute/path/to/propresenter-mcp with the actual path to this project.
This server can be debugged directly in VS Code using the included MCP configuration.
Open this project in VS Code
The server is automatically configured for debugging via .vscode/mcp.json
Use the MCP extension to test and debug the server
Once connected, you can ask Claude to control ProPresenter:
Status & Information:
"What version of ProPresenter is running?"
"Show me the status of all screens"
"What's the status of audience screens?"
"Get the current slide information"
Presentations:
"What presentation is currently active?"
"Trigger the presentation with UUID [uuid]"
"Go to the next slide"
"Go to slide number 5"
"Play the presentation timeline"
"Show me the chord chart"
"Get a thumbnail of slide 3"
Announcements:
"What announcement is currently active?"
"Trigger the next announcement cue"
"Show me the announcement timeline status"
"Go to announcement cue 2"
Audio & Media:
"List all audio playlists"
"Show me the contents of audio playlist [id]"
"Play the next song in the active playlist"
"Trigger the focused audio playlist"
"List all media playlists"
"Trigger media item [id] in playlist [playlist_id]"
Playlists:
"List all presentation playlists"
"Show me the active playlist"
"Focus the next playlist"
"Trigger the first item in the focused playlist"
"Create a new playlist called 'Sunday Service'"
Capture:
"What's the current capture status?"
"Start recording"
"Stop the capture"
"Show me available capture encodings for RTMP"
Clear:
"Clear the announcements layer"
"Show me all clear groups"
"Trigger the clear group [id]"
"Create a new clear group"
Library:
"List all my libraries"
"Show presentations in library [id]"
"Trigger presentation [id] from library [library_id]"
Looks:
"Show me all configured looks"
"What look is currently live?"
"Switch to look [id]"
"Create a new look"
Macros:
"List all macros"
"Trigger macro [id]"
"Show me all macro collections"
"Create a new macro"
Props:
"List all props"
"Trigger prop [id]"
"Clear prop [id]"
"Pause auto-clear for prop [id]"
"List all prop collections"
Stage:
"Show me the current stage message"
"Display stage message [message]"
"Hide the stage message"
"List all stage layouts"
"Set stage layout [layout_id] for screen [screen_id]"
Messages:
"Show me all messages"
"Display message [id]"
"Hide message [id]"
"Create a new message"
Timers:
"List all timers"
"Start timer [id]"
"Stop timer [id]"
"Reset the sermon timer"
"Create a countdown timer"
"Get the current system time"
Themes:
"List all themes"
"Show me details of theme [id]"
"Get theme slide [slide_id] from theme [theme_id]"
Transport:
"Play the presentation layer"
"Pause the audio layer"
"Skip forward 30 seconds on the announcement layer"
"Go to the end of the presentation"
"Get the current playback time"
Masks:
"List all masks"
"Show me details of mask [id]"
Triggers:
"Trigger the next cue"
"Trigger the previous media item"
npm run buildnpm run watchThis server implements the complete ProPresenter API documented at https://openapi.propresenter.com/
Total Endpoints: 231 REST API endpoints
API Groups: 27 functional groups
Client Modules: 18 TypeScript client classes
Tool Definitions: 18 MCP tool modules
Handler Modules: 18 request handler modules
HTTP Methods: Full support for GET, POST, PUT, DELETE operations
Architecture: Complete three-layer implementation (clients → tools → handlers)
See api/api.md for complete API documentation with all 231 endpoints organized by group.
Connection Issues:
Verify ProPresenter is running and the API is enabled
Check that the URL and port are correct
Ensure no firewall is blocking the connection
Verify the password if authentication is enabled
Server Not Starting:
Make sure you've built the project with npm run build
Check that Node.js 18+ is installed
Verify all dependencies are installed with npm install
Focus the currently active announcement presentation
Inputs: no named parameters.
Get the currently active announcement presentation
Inputs: no named parameters.
Get the index of the current slide within the active announcement
Inputs: no named parameters.
Get the current timeline status of the active announcement
Inputs: no named parameters.
Perform timeline operation (play, pause, rewind) on active announcement
Inputs: operation (required).
Retrigger the currently active announcement (starts from beginning)
Inputs: no named parameters.
Trigger a specific cue by index in the active announcement
Inputs: index (required).
Trigger the next cue in the active announcement
Inputs: no named parameters.
Trigger the previous cue in the active announcement
Inputs: no named parameters.
Focus the active audio playlist
Inputs: no named parameters.
Focus the next audio playlist
Inputs: no named parameters.
Focus a specific audio playlist
Inputs: playlistId (required).
Focus the previous audio playlist
Inputs: no named parameters.
Get the currently active audio playlist
Inputs: no named parameters.
Get the currently focused audio playlist
Inputs: no named parameters.
Get all items in a specific audio playlist
Inputs: playlistId (required), start.
Get a list of all configured audio playlists
Inputs: no named parameters.
Subscribe to updates for a specific audio playlist (chunked response)
Inputs: playlistId (required).
Trigger the next item in the active playlist
Inputs: no named parameters.
Trigger the active audio playlist (restart from beginning)
Inputs: no named parameters.
Trigger the previous item in the active playlist
Inputs: no named parameters.
Trigger the next item in the focused playlist
Inputs: no named parameters.
Trigger the focused audio playlist
Inputs: no named parameters.
Trigger the previous item in the focused playlist
Inputs: no named parameters.
Trigger a specific audio playlist
Inputs: playlistId (required).
Trigger a specific item in a specific playlist
Inputs: playlistId (required), itemId (required).
Get available capture encodings for a specific type
Inputs: type (required).
Get the current capture settings
Inputs: no named parameters.
Get the current capture status and capture time
Inputs: no named parameters.
Perform a capture operation (start or stop)
Inputs: operation (required).
Get details of a specific clear group
Inputs: id (required).
Get a list of all configured clear groups
Inputs: no named parameters.
Clear a specific layer (audio, props, messages, announcements, slide, media, video_input)
Inputs: layer (required).
Trigger a specific clear group
Inputs: id (required).
Trigger the find my mouse feature to highlight the cursor on all screens
Inputs: no named parameters.
Focus the currently active presentation
Inputs: no named parameters.
Perform timeline operation (play, pause, rewind) on focused presentation
Inputs: operation (required).
Focus the next presentation
Inputs: no named parameters.
Focus a presentation without triggering it
Inputs: presentationUuid (required).
Focus the previous presentation
Inputs: no named parameters.
Get the currently active presentation
Inputs: no named parameters.
Get the index of the current slide within the active presentation
Inputs: no named parameters.
Get the current chord chart information
Inputs: no named parameters.
Get chord chart updates
Inputs: no named parameters.
Get the currently focused presentation
Inputs: no named parameters.
Get the current timeline status of the focused presentation
Inputs: no named parameters.
Get details of a specific presentation by UUID
Inputs: presentationUuid (required).
Get a thumbnail for a specific slide in a presentation
Inputs: presentationUuid (required), index (required), quality.
Get the ProPresenter version and build information
Inputs: no named parameters.
Get the current timeline status of the active presentation
Inputs: no named parameters.
Get all global groups configured in ProPresenter
Inputs: no named parameters.
Get all items in a specific library
Inputs: libraryId (required).
Get a list of all configured libraries
Inputs: no named parameters.
Trigger the first cue of a presentation in a library
Inputs: libraryId (required), presentationId (required).
Trigger a specific cue of a presentation in a library
Inputs: libraryId (required), presentationId (required), index (required).
Get details of a specific audience look
Inputs: id (required).
Get a list of all configured audience looks (except the live look)
Inputs: no named parameters.
Get the details of the currently live audience look
Inputs: no named parameters.
Trigger a specific audience look to make it live/current
Inputs: id (required).
Get details of a specific macro
Inputs: id (required).
Get a list of all configured macros
Inputs: no named parameters.
Trigger a specific macro
Inputs: id (required).
Get details of a specific mask
Inputs: id (required).
Get all masks in the library
Inputs: no named parameters.
Get thumbnail for a specific mask
Inputs: id (required).
Clear (hide) a specific message
Inputs: messageId (required).
Create a new message
Inputs: message (required).
Delete a specific message
Inputs: messageId (required).
Get details of a specific message
Inputs: messageId (required).
Get a list of all messages
Inputs: no named parameters.
Trigger (show) a specific message with optional token values
Inputs: messageId (required), tokens.
Update an existing message
Inputs: messageId (required), message (required).
Create a new playlist
Inputs: name (required), type (required).
Create a new playlist under an existing playlist
Inputs: playlistId (required), name (required), type (required).
Focus a specific playlist without triggering it
Inputs: playlistId (required).
Focus the active announcement playlist
Inputs: no named parameters.
Focus the active presentation playlist
Inputs: no named parameters.
Focus the next playlist
Inputs: no named parameters.
Focus the previous playlist
Inputs: no named parameters.
Get details of a specific playlist
Inputs: playlistId (required).
Get the currently active playlist
Inputs: no named parameters.
Get thumbnail for active playlist announcement item
Inputs: index (required), cueIndex (required).
Get thumbnail for active playlist presentation item
Inputs: index (required), cueIndex (required).
Get all playlists in the library
Inputs: no named parameters.
Get the currently focused playlist
Inputs: no named parameters.
Get the next item in the focused playlist
Inputs: no named parameters.
Get the previous item in the focused playlist
Inputs: no named parameters.
Get thumbnail for a specific playlist item
Inputs: playlistId (required), index (required), cueIndex (required).
Get updates for a specific playlist
Inputs: playlistId (required).
Update the contents of a specific playlist
Inputs: playlistId (required), contents (required).
Trigger a specific playlist
Inputs: playlistId (required).
Trigger the active announcement in the playlist
Inputs: no named parameters.
Trigger a specific announcement item in the active playlist
Inputs: index (required).
Trigger the active presentation in the playlist
Inputs: no named parameters.
Trigger a specific presentation item in the active playlist
Inputs: index (required).
Trigger the focused playlist item
Inputs: no named parameters.
Trigger a specific item in the focused playlist
Inputs: index (required).
Trigger the next item in the focused playlist
Inputs: no named parameters.
Trigger the previous item in the focused playlist
Inputs: no named parameters.
Trigger a specific item in a playlist
Inputs: playlistId (required), index (required).
Trigger the next item in a specific playlist
Inputs: playlistId (required).
Trigger the previous item in a specific playlist
Inputs: playlistId (required).
Perform timeline operation on a specific presentation by UUID
Inputs: presentationUuid (required), operation (required).
Clear a specific prop from display
Inputs: id (required).
Create a new prop collection
Inputs: name (required).
Delete a specific prop
Inputs: id (required).
Delete a specific prop collection
Inputs: id (required).
Get details of a specific prop
Inputs: id (required).
Get all props in the library
Inputs: no named parameters.
Get details of a specific prop collection
Inputs: id (required).
Get all prop collections
Inputs: no named parameters.
Get thumbnail for a specific prop
Inputs: id (required).
Pause auto-clear for a specific prop
Inputs: id (required).
Resume auto-clear for a specific prop
Inputs: id (required).
Update a specific prop
Inputs: id (required), prop (required).
Update a specific prop collection
Inputs: id (required), collection (required).
Trigger a specific prop to display
Inputs: id (required).
Delete a specific stage layout
Inputs: id (required).
Get the current stage layout map configuration
Inputs: no named parameters.
Get all available stage layouts
Inputs: no named parameters.
Get thumbnail for a specific stage layout
Inputs: id (required).
Get the current stage message
Inputs: no named parameters.
Get the layout for a specific stage screen
Inputs: id (required).
Get all stage screens and their configurations
Inputs: no named parameters.
Hide the current stage message
Inputs: no named parameters.
Set the stage layout map configuration
Inputs: layoutMap (required).
Set the layout for a specific stage screen
Inputs: id (required), layoutId (required).
Show a message on stage screens
Inputs: message (required).
Get the status of audience screens
Inputs: no named parameters.
Get the status of all layers
Inputs: no named parameters.
Get the current status of all screens in ProPresenter
Inputs: no named parameters.
Get the current slide status information
Inputs: no named parameters.
Get the status of stage screens
Inputs: no named parameters.
Subscribe to status updates with specific configuration
Inputs: updates (required).
Set the configuration of audience screens
Inputs: screens (required).
Set the configuration of stage screens
Inputs: screens (required).
Get details of a specific theme
Inputs: id (required).
Get all themes in the library
Inputs: no named parameters.
Get a specific slide from a theme
Inputs: id (required), themeSlide (required).
Get thumbnail for a specific theme slide
Inputs: id (required), themeSlide (required).
Update a specific slide in a theme
Inputs: id (required), themeSlide (required), slideData (required).
Perform timeline operation (play, pause, rewind) on active presentation
Inputs: operation (required).
Get details of a specific timer
Inputs: timerId (required).
Get all timers and their current states
Inputs: no named parameters.
Get the current/active timer
Inputs: no named parameters.
Get the current system time from ProPresenter
Inputs: no named parameters.
Get the video countdown timer information
Inputs: no named parameters.
Increment a specific timer by a duration
Inputs: timerId (required), duration (required).
Perform an operation on all timers simultaneously
Inputs: operation (required).
Perform a specific operation on a timer (start, stop, reset)
Inputs: timerId (required), operation (required).
Reset a specific timer
Inputs: timerId (required).
Start a specific timer
Inputs: timerId (required).
Stop a specific timer
Inputs: timerId (required).
Cancel auto-advance for presentation or announcement layer
Inputs: layer (required).
Get auto-advance status for presentation or announcement layer
Inputs: layer (required).
Get the current content on the specified layer
Inputs: layer (required).
Get the current playback time of the specified layer
Inputs: layer (required).
Go to the end of content in the specified layer
Inputs: layer (required), time.
Pause the specified layer (presentation, announcement, or audio)
Inputs: layer (required).
Play the specified layer (presentation, announcement, or audio)
Inputs: layer (required).
Set the playback time of the specified layer
Inputs: layer (required), time (required).
Skip backward in the specified layer by a given time
Inputs: layer (required), time (required).
Skip forward in the specified layer by a given time
Inputs: layer (required), time (required).
Trigger a specific group in the active presentation
Inputs: groupId (required).
Retrigger the currently active presentation (starts from beginning)
Inputs: no named parameters.
Trigger a specific cue by index in the focused presentation
Inputs: index (required).
Trigger a specific group in the focused presentation
Inputs: groupId (required).
Trigger the next cue in the focused presentation
Inputs: no named parameters.
Trigger the currently focused presentation
Inputs: no named parameters.
Trigger the previous slide in the focused presentation
Inputs: no named parameters.
Trigger the next cue in the current presentation
Inputs: no named parameters.
Trigger a specific presentation by UUID, optionally starting at a specific slide index
Inputs: presentationUuid (required), index.
Trigger a specific cue by index in a presentation by UUID
Inputs: presentationUuid (required), index (required).
Trigger a specific group in a presentation by UUID
Inputs: presentationUuid (required), groupId (required).
Trigger the next cue in a specific presentation by UUID
Inputs: presentationUuid (required).
Trigger the previous cue in a specific presentation by UUID
Inputs: presentationUuid (required).
Trigger the previous cue in the current presentation
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 177 tools
Many tools have overlapping functionality, such as multiple 'trigger' variants (e.g., trigger_next_slide, trigger_focused_next, trigger_presentation_next) that are difficult to distinguish. The large number of similar operations across different categories (presentation, playlist, audio, announcement) without clear boundaries causes confusion.
Tool names consistently use snake_case and follow a predictable category_action_detail pattern (e.g., announcement_focus_active, audio_get_playlists). There are a few outliers like 'find_my_mouse' that break the pattern, but overall the naming is very systematic.
With 177 tools, the surface is excessively fine-grained. Many tools could be combined with parameters (e.g., a single 'trigger' tool with type and action parameters). This high count overwhelms agents and suggests poor scoping for the intended purpose.
The tool set covers extensive functionality for ProPresenter, including presentations, playlists, audio, announcements, props, messages, timers, stage, and transport. Minor gaps may exist (e.g., moving playlist items), but overall it provides comprehensive coverage for the domain.
Create, edit, export and manage presentations. Requires a paid PPT.AI API merchant account.
Control evmux live streaming studios: scenes, layers, participants, media, banners and broadcast.
Manage cloud-hosted 24/7 video streams, playlists, destinations, schedules, media and workspaces.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.