Medux MCP Server

Medux MCP Server

Connect AI assistants to Medux for AI media generation and editing: video, image, speech, voice cloning, avatars, and PDF/audio/video tools.

• Endpoint (streamable HTTP): https://medux.io/api/mcp/v1
• Authentication: Authorization: Bearer sk-medux-...
• Tools: 60+ (generation, editing, conversion, task query)

1. Get an API key

Create an API key (starts with sk-medux-) in your Medux account at https://medux.io. Keep it secret; do not commit it to a repository.

2. GitHub Copilot / VS Code

Requires VS Code with GitHub Copilot signed in, and Copilot Chat in Agent mode.

1. Run MCP: Open User Configuration from the Command Palette (⇧⌘P / Ctrl+Shift+P).

2. Add the server:

   {
     "servers": {
       "medux": {
         "type": "http",
         "url": "https://medux.io/api/mcp/v1",
         "headers": { "Authorization": "Bearer ${input:medux-api-key}" }
       }
     },
     "inputs": [
       { "type": "promptString", "id": "medux-api-key", "description": "Medux API key", "password": true }
     ]
   }
   

3. In the MCP Servers list, open the gear next to medux and choose Start Server (or Restart Server).

4. In Copilot Chat (Agent mode) open the tools picker and confirm the medux tools are listed.

5. Try a harmless request first, for example: "Use medux to list what you can do".

If the key prompt never appears

In some setups VS Code does not show the ${input:...} prompt, and tool calls end with Canceled or 401. Replace the header value with your key directly in your user-level mcp.json (never in a repository):

"headers": { "Authorization": "Bearer sk-medux-xxxxxxxx" }

Then restart the server.

Troubleshooting

Registry

Published to the MCP Registry as io.github.MeduxIO/medux through .github/workflows/publish-mcp.yml (GitHub OIDC). To release a new version: bump version in server.json, then run the workflow or push a v* tag.

License

MIT