🔌 Connection Details
Server Endpoint: http://localhost:3004
Health Check: GET http://localhost:3004/v1/health
Configuration: GET http://localhost:3004/config
Example: GET http://localhost:3004/example
🔐 Authentication
This MCP server requires a Genfeed.ai API key for authentication:
GENFEED_API_KEY=your-api-key-here
GENFEEDAI_API_URL=https://api.genfeed.ai
Set these environment variables when running the server or configure them in your Claude Desktop settings.
🤖 Connect from Claude Desktop
Add this server to your Claude Desktop configuration:
Claude Desktop Configuration
Config file location:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/claude-desktop/config.json
Add this configuration:
{
"mcpServers": {
"genfeed-ai": {
"command": "node",
"args": ["/path/to/genfeed/dist/mcp/main.js"],
"env": {
"NODE_ENV": "production",
"MCP_PORT": "3003",
"GENFEEDAI_API_URL": "https://api.genfeed.ai",
"GENFEED_API_KEY": "your-api-key-here"
}
}
}
}
- Install and build the Genfeed.ai MCP server
- Add the configuration above to your Claude Desktop config file
- Replace the path and API key with your actual values
- Restart Claude Desktop and start using the tools!
🛠️ Available Tools
- create_video Create AI-generated videos with customizable styles, duration, and voice-over options. Supports professional, casual, animated, documentary, and tutorial styles.
- get_video_status Check the processing status and progress of your video creation jobs. Returns real-time updates on video generation progress.
- list_videos Get a paginated list of all videos in your organization with optional limit and offset parameters.
- get_video_analytics Retrieve detailed analytics for specific videos including views, engagement metrics, and performance data across different time ranges.
📊 Available Resources
- genfeed://analytics/videos Comprehensive analytics data for all videos in your organization, accessible directly through MCP resources.
- genfeed://analytics/organization Organization-wide performance metrics, statistics, and aggregated analytics data.
💻 Example Usage
Once connected to Claude Desktop, you can use natural language to interact with Genfeed.ai:
# Create a professional video
"Create a professional video about AI trends with a 30-second duration and female voice-over"
# Check video status
"Check the status of video ID abc123"
# List recent videos
"Show me my last 5 videos"
# Get analytics
"Get analytics for video ID abc123 for the last 7 days"
# Access organization analytics
"Show me our organization's video performance metrics"
🚀 Installation Steps
- Clone Repository: git clone https://github.com/genfeedai/api.genfeed.ai.git
- Install Dependencies: npm install
- Build Project: npm run build
- Set Environment Variables: Configure GENFEED_API_KEY and other required env vars
- Configure Claude Desktop: Add the MCP server configuration
- Restart Claude Desktop: The server will be available in your AI assistant
⚠️ Important: This server requires a valid Genfeed.ai API key. Make sure to set the GENFEED_API_KEY environment variable or configure it in your Claude Desktop settings.