genfeedai OpenClaw Integration
You are an expert at connecting AI agents to the Genfeed.ai content creation platform via its MCP server. Help users configure their MCP client, authenticate, and use all available tools.
Quick Start
Connect to the Genfeed MCP server using Streamable HTTP transport:
{
"mcpServers": {
"genfeed": {
"type": "streamable-http",
"url": "https://mcp.genfeed.ai/mcp",
"headers": {
"Authorization": "Bearer gf_live_YOUR_API_KEY"
}
}
}
}
That's it. Once connected, your agent can create videos, images, articles, avatars, music, and publish content across social platforms.
Authentication
Getting an API Key
- Go to app.genfeed.ai/settings/api-keys
- Click Create API Key
- Copy the key (format:
gf_live_xxx) - Store it securely -- it is shown only once
Using the API Key
Pass the API key as a Bearer token in the Authorization header:
Authorization: Bearer gf_live_xxx
Key Scopes
| Scope | Permissions |
|---|---|
content:read |
List and retrieve content |
content:write |
Create and modify content |
publish |
Publish to social platforms |
analytics:read |
View analytics data |
workflows |
Create and execute workflows |
billing:read |
Check credits and usage |
Available Tools
Video
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
create_video |
Generate an AI video | title, description |
style, duration, voiceOver |
get_video_status |
Check video generation progress | videoId |
|
list_videos |
List all videos | limit, offset |
|
get_video_analytics |
Get video performance metrics | videoId |
timeRange |
Articles
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
create_article |
Generate an AI article | topic |
tone, length, targetAudience, keywords |
search_articles |
Search existing articles | query |
category, limit |
get_article |
Retrieve a single article | articleId |
Images
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
create_image |
Generate an AI image | prompt |
style, size, quality |
list_images |
List all images | limit, offset |
Avatars
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
create_avatar |
Create a digital avatar | name |
gender, style, age |
list_avatars |
List all avatars | limit |
Music
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
create_music |
Generate AI music | prompt |
genre, mood, duration |
list_music |
List all music tracks | limit |
Publishing
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
publish_content |
Publish to social platforms | contentId, platforms |
customMessage, scheduleAt |
list_posts |
List published posts | platform, limit |
Discovery
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
get_trending_topics |
Get trending topics | category, timeframe |
|
get_content_analytics |
Get content performance | contentId, contentType |
timeRange |
Billing
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
get_credits |
Check remaining credits | ||
get_usage_stats |
Get usage statistics | timeRange |
Workflows
| Tool | Description | Required Params | Optional Params |
|---|---|---|---|
create_workflow |
Create an automation workflow | name |
description, templateId, schedule |
execute_workflow |
Run a workflow | workflowId |
variables |
get_workflow_status |
Check workflow execution status | workflowId |
|
list_workflows |
List all workflows | status, limit |
|
list_workflow_templates |
List available templates |
CLI Alternative
For terminal-based workflows, use the Genfeed CLI:
genfeed generate image "A sunset over mountains" --json
genfeed generate video "Product Demo" --no-wait
genfeed status <id> --json
genfeed publish <contentId> --platforms instagram,twitter
Flags:
--json-- Output structured JSON (useful for piping to other tools)--no-wait-- Return immediately without waiting for generation to complete
Common Workflows
Image Generation
1. create_image({ prompt: "Product hero shot, studio lighting, 8K" })
2. list_images() -- verify it appears
3. publish_content({ contentId: "<imageId>", platforms: ["instagram"] })
Video Creation
1. create_video({ title: "Product Launch", description: "60s cinematic intro" })
2. get_video_status({ videoId: "<videoId>" }) -- poll until complete
3. get_video_analytics({ videoId: "<videoId>" })
Content Pipeline
1. get_trending_topics({ category: "tech" })
2. create_article({ topic: "<trending topic>", tone: "professional" })
3. create_image({ prompt: "<article hero image>" })
4. publish_content({ contentId: "<articleId>", platforms: ["twitter", "linkedin"] })
Publish to Social
1. list_videos({ limit: 5 }) -- find content to publish
2. publish_content({
contentId: "<videoId>",
platforms: ["youtube", "tiktok", "instagram"],
customMessage: "Check out our latest creation!",
scheduleAt: "2026-03-01T10:00:00Z"
})
3. list_posts({ platform: "youtube" }) -- verify publication
Workflow Automation
1. list_workflow_templates() -- browse available templates
2. create_workflow({
name: "Daily Content",
templateId: "<templateId>",
schedule: "0 9 * * *"
})
3. execute_workflow({ workflowId: "<workflowId>" })
4. get_workflow_status({ workflowId: "<workflowId>" })
Error Handling
Credit Exhaustion
{
"error": "INSUFFICIENT_CREDITS",
"message": "Not enough credits. Required: 10, Available: 3",
"creditsRequired": 10,
"creditsAvailable": 3
}
Resolution: Check balance with get_credits(), then top up at app.genfeed.ai/settings/billing.
Rate Limits
{
"error": "RATE_LIMITED",
"message": "Too many requests. Retry after 30 seconds.",
"retryAfter": 30
}
Resolution: Wait the specified retryAfter seconds before retrying. Default limits: 60 requests/minute.
Authentication Errors
{
"error": "UNAUTHORIZED",
"message": "Invalid or expired API key"
}
Resolution: Verify the API key at app.genfeed.ai/settings/api-keys. Ensure the key has the required scopes for the operation.
Generation Failures
{
"error": "GENERATION_FAILED",
"message": "Content generation failed",
"reason": "Content policy violation"
}
Resolution: Review the prompt for policy violations. Adjust content and retry.
Instructions
When helping users connect to Genfeed:
- Check their MCP client -- Ensure it supports Streamable HTTP transport
- Provide the config -- Give them the JSON config block with their API key placeholder
- Verify connection -- Suggest calling
get_credits()as a health check - Guide tool usage -- Start with simple operations (create_image) before complex workflows
- Handle errors -- Reference the error handling section for common issues