{"_id":"@aixlabs/vidmax-mcp-server","name":"@aixlabs/vidmax-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aixlabs/vidmax-mcp-server","version":"1.0.0","description":"MCP Server for VidMax API endpoints - Create videos, manage series, generate images via AI assistants","type":"module","main":"dist/index.js","bin":{"vidmax-mcp-server":"dist/index.js","vidmax-mcp":"dist/index.js"},"scripts":{"build":"tsup","build:standalone":"tsup --config tsup.standalone.config.ts","dev":"tsup --watch","start":"node dist/index.js","inspector":"npx @modelcontextprotocol/inspector dist/index.js","prepublishOnly":"npm run build","test":"echo \"Error: no test specified\" && exit 1"},"keywords":["mcp","model-context-protocol","vidmax","ai","video-generation","claude","anthropic","api-wrapper"],"author":{"name":"VidMax Team"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/your-org/aix-turborepo.git","directory":"packages/vidmax-mcp-server"},"homepage":"https://github.com/your-org/aix-turborepo/tree/main/packages/vidmax-mcp-server#readme","bugs":{"url":"https://github.com/your-org/aix-turborepo/issues"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.13.1","axios":"^1.7.0","zod":"^3.25.67"},"devDependencies":{"@types/node":"^20.0.0","esbuild":"^0.25.5","tsup":"^8.0.2","typescript":"^5.0.0"},"publishConfig":{"access":"public"},"_id":"@aixlabs/vidmax-mcp-server@1.0.0","gitHead":"9d3f24d27d0eb3d0753683327400ef8c18817f4f","_nodeVersion":"18.19.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-YXGrxAW76CFKgj7GhNDR52TjbRio38spznOxgOp3llGEi6U9BONwZEZ/10IjPtZYZKhcarXdWcnYCtcncDpMfw==","shasum":"ee6886c01b93578c63166f46040db8998cbcb3b9","tarball":"https://registry.npmjs.org/@aixlabs/vidmax-mcp-server/-/vidmax-mcp-server-1.0.0.tgz","fileCount":4,"unpackedSize":19892,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIB52IhUwPi4JlZgVaqEJ25jHfRfkNyX4nQqtUjQqYkuAAiEA4rSC6pmzPCDAu4uuHorbSUsvi/bULMJ8cawdpE4L8oI="}]},"_npmUser":{"name":"aix_labs","email":"shray@aixlabs.co","actor":{"name":"aix_labs","email":"shray@aixlabs.co","type":"user"}},"directories":{},"maintainers":[{"name":"aix_labs","email":"shray@aixlabs.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/vidmax-mcp-server_1.0.0_1750894607701_0.04811054640476908"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-25T23:36:47.629Z","1.0.0":"2025-06-25T23:36:47.888Z","modified":"2025-06-25T23:36:48.242Z"},"maintainers":[{"name":"aix_labs","email":"shray@aixlabs.co"}],"description":"MCP Server for VidMax API endpoints - Create videos, manage series, generate images via AI assistants","homepage":"https://github.com/your-org/aix-turborepo/tree/main/packages/vidmax-mcp-server#readme","keywords":["mcp","model-context-protocol","vidmax","ai","video-generation","claude","anthropic","api-wrapper"],"repository":{"type":"git","url":"git+https://github.com/your-org/aix-turborepo.git","directory":"packages/vidmax-mcp-server"},"author":{"name":"VidMax Team"},"bugs":{"url":"https://github.com/your-org/aix-turborepo/issues"},"license":"MIT","readme":"# VidMax MCP Server\n\nA Model Context Protocol (MCP) server that exposes VidMax API endpoints for use with AI assistants like Claude.\n\n## Features\n\nThis MCP server provides tools for:\n\n- **Health Monitoring**: Check API health status\n- **Video Management**: Create, retrieve, and render videos\n- **Series Management**: Create and manage video series\n- **Image Generation**: Generate AI images from prompts\n- **Voice Operations**: Manage voices and create voiceovers\n- **User & Team Info**: Access account and team information\n\n## Installation\n\n### Option 1: Install from npm (Recommended)\n\n```bash\n# Install globally\nnpm install -g @aixlabs/vidmax-mcp-server\n\n# Or run directly with npx\nnpx @aixlabs/vidmax-mcp-server\n```\n\n### Option 2: Local Development\n\n```bash\ncd packages/vidmax-mcp-server\npnpm install\npnpm build\n```\n\n## Configuration\n\nSet the following environment variables:\n\n```bash\n# Required: Your VidMax API key\nexport VIDMAX_API_KEY=\"your-api-key-here\"\n\n# Optional: Custom API base URL (defaults to https://dev.vidmax.ai/api/v1)\nexport VIDMAX_API_BASE_URL=\"https://dev.vidmax.ai/api/v1\"\n```\n\n## Usage\n\n### With Claude Code\n\n#### Option 1: Using npm package (Recommended)\n\n```bash\nclaude mcp add-json vidmax-mcp '{\n    \"command\": \"npx\",\n    \"args\": [\"@aixlabs/vidmax-mcp-server\"],\n    \"env\": {\n        \"VIDMAX_API_KEY\": \"your-api-key-here\",\n        \"VIDMAX_API_BASE_URL\": \"https://dev.vidmax.ai/api/v1\"\n    }\n}'\n```\n\n#### Option 2: Local development build\n\n```bash\nclaude mcp add-json vidmax-local '{\n    \"command\": \"node\",\n    \"args\": [\n        \"/Users/bansalshray/Desktop/Projects/ShrayBans/BansalVentures/aix-turborepo/packages/vidmax-mcp-server/dist/index.js\"\n    ],\n    \"env\": {\n        \"VIDMAX_API_KEY\": \"vm_live_05b252cb33105aaab034c130a2154507_cda0d4f\",\n        \"VIDMAX_API_BASE_URL\": \"http://localhost:3000/api/v1\"\n    }\n}'\n```\n\n### With Claude Desktop\n\n#### Option 1: Using npm package (Recommended)\n\nAdd to your Claude Desktop config (`~/Library/Application\\ Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"vidmax\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aixlabs/vidmax-mcp-server\"],\n      \"env\": {\n        \"VIDMAX_API_KEY\": \"your-api-key-here\",\n        \"VIDMAX_API_BASE_URL\": \"https://dev.vidmax.ai/api/v1\"\n      }\n    }\n  }\n}\n```\n\n#### Option 2: Local development build\n\n```json\n{\n  \"mcpServers\": {\n    \"vidmax\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/aix-turborepo/packages/vidmax-mcp-server/dist/index.js\"],\n      \"env\": {\n        \"VIDMAX_API_KEY\": \"your-api-key-here\",\n        \"VIDMAX_API_BASE_URL\": \"https://dev.vidmax.ai/api/v1\"\n      }\n    }\n  }\n}\n```\n\n### Testing with MCP Inspector\n\n```bash\nnpm run inspector\n```\n\nThen open http://localhost:4000 in your browser.\n\n## Available Tools\n\n### System Operations\n- `health_check` - Check API health\n- `auth_check` - Validate API key and authentication\n\n### Video Operations\n- `get_videos` - List videos with filtering\n- `get_video` - Get specific video details\n- `create_video` - Create AI video from prompt\n- `create_reddit_video` - Create video from Reddit post\n- `create_fake_text_video` - Create video from conversation\n- `render_video` - Render video to MP4\n\n### Series Operations\n- `get_series` - List all series\n- `create_series` - Create new series\n- `generate_series_video` - Generate video for series\n\n### Image Operations\n- `generate_image` - Generate AI image\n- `get_images` - List generated images\n\n### Voice Operations\n- `get_voices` - List available voices\n- `create_voiceover` - Create voiceover from text\n\n### Account Operations\n- `get_user_info` - Get user account info\n- `get_team_info` - Get team information\n\n## Resources\n\n- `vidmax://api/endpoints` - Complete API endpoint documentation\n- `vidmax://api/authentication` - Authentication guide\n\n## Example Usage\n\nOnce connected to Claude, you can use commands like:\n\n```\n\"Create a new video with the prompt 'A day in the life of a software developer'\"\n\n\"Generate an image with the prompt 'Futuristic cityscape at sunset'\"\n\n\"Get all my videos and show me their status\"\n\n\"Create a new series called 'Tech Tutorials' for educational content\"\n```\n\n## Development\n\n```bash\n# Build the server\nnpm run build\n\n# Watch for changes during development\nnpm run dev\n\n# Start the server\nnpm start\n\n# Test with MCP Inspector\nnpm run inspector\n```\n\n## Error Handling\n\nThe server handles API errors gracefully and returns structured error responses. Common issues:\n\n- **Authentication Error**: Check your API key is valid\n- **Network Error**: Verify the API base URL is correct\n- **Rate Limiting**: The API may rate limit requests\n- **Invalid Parameters**: Check tool input parameters match the schema","readmeFilename":"README.md","_rev":"1-5de44070d0fb377c3d7e6c3840f96fef"}