MCP Server Documentation
How to enable, configure, and connect AI agents to the GenX Pro MCP Server. 59 tools across 10 categories — the full production pipeline, accessible from any MCP-compatible client.
Overview
GenX Pro includes a built-in MCP Server (Model Context Protocol) that runs locally on your machine. When enabled, AI agents like Claude, Cursor, Windsurf, OpenClaw, and any other MCP-compatible client can connect and access the full Beast Mode production pipeline — transcriptions, scripts, voiceovers, shorts, pod shorts, video editing, AI generation, and Cloud Library management.
The server runs on localhost:3999 by default. It reuses your existing GenX Pro login — no API keys, no tokens, no extra configuration. As long as GenX Pro is open on your machine (even minimized to the Dock or system tray), the MCP server is live and agents can connect.
Setup & Settings
Click the gear icon in the top-right header bar to open MCP settings.
- Enable / Disable — toggle the MCP server on or off. When disabled, no connections are accepted.
- Port — default
3999, configurable from 1024 to 65535. If the port is busy, the server auto-increments up to 10 times. - Status — shows running state, active port, and connected client count
- Config Copy — one-click copy of the JSON config block for your agent
The server also appears in your system tray (menu bar on Mac, taskbar on Windows) with a status dot showing whether MCP is active and how many clients are connected.
Tool Reference
59 tools across 10 categories. All tools are available to any connected MCP client. Tools that consume daily allowance or Beast credits are marked in their descriptions.
🎨 Generation 12 tools
| Tool | Description |
|---|---|
gen_video | Generate a video from a text prompt |
gen_video_extend | Extend a video from its last frame |
gen_video_style | Generate a character video in a new scene |
gen_photo | Generate a photo from a text prompt |
gen_photo_architect | AI-expand a brief idea into a structured photo spec |
gen_scene_creator | Expand a video idea into a detailed prompt |
gen_aura | Generate premium photo with text rendering |
gen_photo_edit | Edit a photo with natural language instructions |
gen_enhance | Upscale, remove background, remove objects, or headshot |
gen_music | Generate background music (5-150 seconds) |
gen_sfx | Generate a sound effect (1-35 seconds) |
gen_allowance | Check daily generation allowance (used/remaining) |
🎙 Podcast Discovery 3 tools
| Tool | Description |
|---|---|
podcast_search | Search for podcasts by name |
podcast_episodes | Get episodes from a podcast RSS feed URL |
podcast_episodes_from_url | Get episodes from an Apple Podcasts or RSS URL |
📝 Text Workstation 8 tools
| Tool | Description |
|---|---|
text_options | Returns available options (tone, length, format, models, languages) |
save_script | Save a script to Cloud Library |
text_generate_script | Generate a script with AI |
text_script_ab | Generate an A/B variation of an existing script |
text_localize_script | Translate a script to another language |
text_create_inteliscripts | Generate 3-10 unique scripts from a transcript |
text_transcribe | Transcribe audio to text (92x realtime) |
text_translate | Translate text or transcript to another language |
🎤 Voice Studio 2 tools
| Tool | Description |
|---|---|
create_voiceover | Generate voiceover from text with cloned or catalog voices |
list_voices | List favorite voices and voice profiles |
🎬 Daily Shorts 6 tools
| Tool | Description |
|---|---|
daily_short_options | Returns available modes, styles, caption presets, positions |
daily_plan_master | Browse available voiceovers for master creation |
daily_submit_master | Submit a master short job with chosen voiceover |
daily_plan_replica | Browse available masters and voiceovers for replicas |
daily_submit_replica | Submit replica jobs in different languages |
short_assemble | Manually trigger assembly for a ready short (fallback) |
🎧 Pod Shorts 5 tools
| Tool | Description |
|---|---|
pod_analyze | Analyze transcript for viral segments with hook scores |
pod_get_segments | Get ranked segments from a completed analysis |
pod_list_analyses | Browse completed segment analyses |
pod_plan | Browse transcripts, analyses, and segments for planning |
pod_submit_short | Submit Pod Short jobs from chosen segments |
🎥 Video Editing 3 tools
| Tool | Description |
|---|---|
video_add_frame | Add a colored stroke/frame border around a video |
video_trim | Trim a video to a specific time range |
video_stitch | Stitch multiple videos together sequentially |
⚡ Workflow Pipelines 4 tools
| Tool | Description |
|---|---|
daily_gen_master | Script or topic to finished master short in one call |
daily_gen_replica | Replicate a master with different voice, language, or captions |
daily_gen_batch | Create replicas in multiple languages in one call |
pod_gen_short | Full pipeline: analyze transcript to finished Pod Shorts |
📊 Jobs & Tracking 4 tools
| Tool | Description |
|---|---|
jobs_list | List all active and recent jobs |
jobs_get_status | Check job status and results |
jobs_cancel | Cancel a running job |
jobs_retry | Retry a failed job |
💼 Account & Library 12 tools
| Tool | Description |
|---|---|
setup | Validate session, return account info, credits, allowance, voices |
account_info | Get user info, workspace details, wallet balance |
account_credits | Check Beast Mode credit balance and usage |
library_open | Open local library folder in Finder/Explorer |
library_get_asset | Get asset details including download URL |
library_list_assets | Browse Cloud Library with type, date, and limit filters |
library_get_transcripts | Browse transcripts (source, word count, duration) |
library_get_scripts | Browse scripts (InteliScripts, generated, saved) |
library_get_voiceovers | Browse voiceover audio assets |
library_get_masters | Browse completed master shorts |
library_get_replicas | Browse completed replica shorts |
library_get_podshorts | Browse completed pod shorts |
Resources
In addition to tools, the MCP server exposes read-only resources that agents can query for live data without triggering any actions.
| URI | Description |
|---|---|
genx://account/info | Current user info, workspace details, daily allowance, wallet balance |
genx://jobs/active | Currently active jobs (pending + processing) |
genx://library/scripts | Saved scripts in Cloud Library |
genx://library/voiceovers | Generated voiceovers in Cloud Library |
genx://library/profiles | Voice profiles and favorites |
genx://library/masters | Completed master shorts (Daily Shorts) |
genx://library/analyses | Completed Pod Shorts segment analyses |
genx://presets/captions | Available caption presets with visual descriptions |
Example Workflows
Tell your agent what you want in natural language. It handles the tool calls.
Create a daily short from a topic
Replicate to multiple languages
Pod Shorts from a podcast
Autonomous daily pipeline
FAQ
Does the MCP server work when GenX Pro is minimized?
Yes. The server runs in the background as long as GenX Pro is open. You can minimize the window or close it to the system tray — the MCP server stays live.
Is the MCP server exposed to the internet?
No. The server only listens on localhost. It is not accessible from the network.
Only applications running on your machine can connect.
Do I need API keys?
No. The MCP server authenticates using your existing GenX Pro session automatically. No API keys, tokens, or environment variables needed.
What happens if the port is busy?
The server auto-increments the port (3999 → 4000 → 4001, etc.) up to 10 times. The active port is shown in Settings and the system tray.
Can multiple agents connect at the same time?
Yes. Each agent gets its own server session. The connected client count is shown in the system tray.
Are generation tools free?
Generation tools (video, photo, music, sound effects) use your daily allowance — 75 free generations per day. Beast Mode pipeline tools (shorts, voiceovers, transcriptions) use Beast credits from your workspace wallet.