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

1. Go to app.genfeed.ai/settings/api-keys
2. Click Create API Key
3. Copy the key (format: gf_live_xxx)
4. 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:

1. Check their MCP client -- Ensure it supports Streamable HTTP transport
2. Provide the config -- Give them the JSON config block with their API key placeholder
3. Verify connection -- Suggest calling get_credits() as a health check
4. Guide tool usage -- Start with simple operations (create_image) before complex workflows
5. Handle errors -- Reference the error handling section for common issues