{
  "markdown": "# propresenter-mcp\n\nA 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.\n\n## Official MCP Registry\n- https://registry.modelcontextprotocol.io/?q=alxpark%2Fpropresenter-mcp\n\n## Prerequisites\n\n- Node.js 18 or higher\n- ProPresenter 7 with API enabled\n- ProPresenter running and accessible on your network\n\n## Installation\n\n1. Clone this repository or download the source code\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Build the project:\n```bash\nnpm run build\n```\n\n## Configuration\n\nThe server connects to ProPresenter using environment variables:\n\n- `PROPRESENTER_URL` - The URL of your ProPresenter instance (default: `http://localhost:50000`)\n- `PROPRESENTER_PASSWORD` - The API password (if configured in ProPresenter)\n\n### ProPresenter Setup\n\n1. Open ProPresenter preferences\n2. Go to the Network tab\n3. Enable \"Network\" and note the port number (default: 50000)\n4. Optionally set a password for API access\n\n## Usage\n\n### With Claude Desktop\n\nAdd this to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"propresenter\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/propresenter-mcp/build/index.js\"],\n      \"env\": {\n        \"PROPRESENTER_URL\": \"http://localhost:50000\",\n        \"PROPRESENTER_PASSWORD\": \"your-password-if-needed\"\n      }\n    }\n  }\n}\n```\n\nReplace `/absolute/path/to/propresenter-mcp` with the actual path to this project.\n\n### With VS Code\n\nThis server can be debugged directly in VS Code using the included MCP configuration.\n\n1. Open this project in VS Code\n2. The server is automatically configured for debugging via `.vscode/mcp.json`\n3. Use the MCP extension to test and debug the server\n\n## Example Commands\n\nOnce connected, you can ask Claude to control ProPresenter:\n\n**Status & Information:**\n- \"What version of ProPresenter is running?\"\n- \"Show me the status of all screens\"\n- \"What's the status of audience screens?\"\n- \"Get the current slide information\"\n\n**Presentations:**\n- \"What presentation is currently active?\"\n- \"Trigger the presentation with UUID [uuid]\"\n- \"Go to the next slide\"\n- \"Go to slide number 5\"\n- \"Play the presentation timeline\"\n- \"Show me the chord chart\"\n- \"Get a thumbnail of slide 3\"\n\n**Announcements:**\n- \"What announcement is currently active?\"\n- \"Trigger the next announcement cue\"\n- \"Show me the announcement timeline status\"\n- \"Go to announcement cue 2\"\n\n**Audio & Media:**\n- \"List all audio playlists\"\n- \"Show me the contents of audio playlist [id]\"\n- \"Play the next song in the active playlist\"\n- \"Trigger the focused audio playlist\"\n- \"List all media playlists\"\n- \"Trigger media item [id] in playlist [playlist_id]\"\n\n**Playlists:**\n- \"List all presentation playlists\"\n- \"Show me the active playlist\"\n- \"Focus the next playlist\"\n- \"Trigger the first item in the focused playlist\"\n- \"Create a new playlist called 'Sunday Service'\"\n\n**Capture:**\n- \"What's the current capture status?\"\n- \"Start recording\"\n- \"Stop the capture\"\n- \"Show me available capture encodings for RTMP\"\n\n**Clear:**\n- \"Clear the announcements layer\"\n- \"Show me all clear groups\"\n- \"Trigger the clear group [id]\"\n- \"Create a new clear group\"\n\n**Library:**\n- \"List all my libraries\"\n- \"Show presentations in library [id]\"\n- \"Trigger presentation [id] from library [library_id]\"\n\n**Looks:**\n- \"Show me all configured looks\"\n- \"What look is currently live?\"\n- \"Switch to look [id]\"\n- \"Create a new look\"\n\n**Macros:**\n- \"List all macros\"\n- \"Trigger macro [id]\"\n- \"Show me all macro collections\"\n- \"Create a new macro\"\n\n**Props:**\n- \"List all props\"\n- \"Trigger prop [id]\"\n- \"Clear prop [id]\"\n- \"Pause auto-clear for prop [id]\"\n- \"List all prop collections\"\n\n**Stage:**\n- \"Show me the current stage message\"\n- \"Display stage message [message]\"\n- \"Hide the stage message\"\n- \"List all stage layouts\"\n- \"Set stage layout [layout_id] for screen [screen_id]\"\n\n**Messages:**\n- \"Show me all messages\"\n- \"Display message [id]\"\n- \"Hide message [id]\"\n- \"Create a new message\"\n\n**Timers:**\n- \"List all timers\"\n- \"Start timer [id]\"\n- \"Stop timer [id]\"\n- \"Reset the sermon timer\"\n- \"Create a countdown timer\"\n- \"Get the current system time\"\n\n**Themes:**\n- \"List all themes\"\n- \"Show me details of theme [id]\"\n- \"Get theme slide [slide_id] from theme [theme_id]\"\n\n**Transport:**\n- \"Play the presentation layer\"\n- \"Pause the audio layer\"\n- \"Skip forward 30 seconds on the announcement layer\"\n- \"Go to the end of the presentation\"\n- \"Get the current playback time\"\n\n**Masks:**\n- \"List all masks\"\n- \"Show me details of mask [id]\"\n\n**Triggers:**\n- \"Trigger the next cue\"\n- \"Trigger the previous media item\"\n\n## Development\n\n### Build\n```bash\nnpm run build\n```\n\n### Watch Mode\n```bash\nnpm run watch\n```\n\n## API Reference\n\nThis server implements the complete ProPresenter API documented at https://openapi.propresenter.com/\n\n### API Coverage\n\n- **Total Endpoints**: 231 REST API endpoints\n- **API Groups**: 27 functional groups\n- **Client Modules**: 18 TypeScript client classes\n- **Tool Definitions**: 18 MCP tool modules\n- **Handler Modules**: 18 request handler modules\n- **HTTP Methods**: Full support for GET, POST, PUT, DELETE operations\n- **Architecture**: Complete three-layer implementation (clients → tools → handlers)\n\nSee `api/api.md` for complete API documentation with all 231 endpoints organized by group.\n\n## Troubleshooting\n\n**Connection Issues:**\n- Verify ProPresenter is running and the API is enabled\n- Check that the URL and port are correct\n- Ensure no firewall is blocking the connection\n- Verify the password if authentication is enabled\n\n**Server Not Starting:**\n- Make sure you've built the project with `npm run build`\n- Check that Node.js 18+ is installed\n- Verify all dependencies are installed with `npm install`",
  "bytes": 6081,
  "sha": "d9741bdd9a4c269cad35a3866f19a0a4aaa0ac853b3208218a6352060774bfcf",
  "repo_slug": "alxpark/propresenter-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_alxpark_propresenter_mcp_fcafdb36/readme"
}