Genfeed MCP server

Genfeed.ai

The open-source content engine your agent can run. Self-host it free or use Cloud.

Create on-brand videos, images and posts, then review and publish to your connected channels. Work in Genfeed or connect the AI agent you already use.

<!-- TODO(demo): add the pinned demo video/GIF here (brief in → agent drafts → waits for approval → publishes). Real footage only; no mock media. -->

npx @genfeedai/create my-genfeed

Needs Docker Compose v2 and Node.js 24. The wizard verifies the release bundle, asks for your OpenRouter API key, then starts it. Install guide: genfeed.ai/self-hosted · docs.genfeed.ai.

If Genfeed is useful, a ⭐ on GitHub helps others find it.

[!WARNING]

Genfeed is 0.x and under active development. Breaking changes ship with an

Upgrade note in the release body; semver becomes strict at v1.0.0.

Self-host it (Community), run it on your Mac (Desktop), or use the hosted product at genfeed.ai (SaaS). Same code, three deployment modes.

Requirements (Community)

Docker Desktop. Both npx @genfeedai/create and the release bundle below need it.

• Docker Engine with the Docker Compose v2 plugin (docker compose version), or

This is capacity guidance based on the reported v0.2.15 image footprint; see system requirements.

• Node.js 24 (>=24 <25), only for npx @genfeedai/create.
• Free host ports 3000 (web), 3010 (API), 3011 (WebSocket) and 3014 (MCP).
• Plan for at least 15 GB of free disk, plus room for media, backups, and upgrades.

docker-compose package. With Docker CE, install docker-compose-plugin from Docker's apt repository.

• RAM: no minimum is published. Tested on 8 CPU / 15 GiB.
• Debian 13 provides Compose v2 in its

See troubleshooting if the app logs P1001: Can't reach database server at postgres:5432.

Quick start (Community)

One command (recommended):

npx @genfeedai/create my-genfeed

It downloads and verifies the release bundle, prompts for your OpenRouter key, then starts the stack. Checksums, auth, providers, and upgrades: self-hosting guide.

Release bundle (no Node.js): set OPENROUTERAPIKEY in .env to a real key from openrouter.ai/keys before starting. The container exits at start without it.

curl -fLO https://github.com/genfeedai/genfeed.ai/releases/latest/download/genfeed-selfhosted.tar.gz
curl -fLO https://github.com/genfeedai/genfeed.ai/releases/latest/download/genfeed-selfhosted.tar.gz.sha256
sha256sum -c genfeed-selfhosted.tar.gz.sha256
tar -xzf genfeed-selfhosted.tar.gz && cd genfeed-selfhosted-v*
cp .env.example .env
# Edit .env: set OPENROUTER_API_KEY to your real OpenRouter key, then:
docker compose --env-file .env -f compose.yml up -d

On macOS, use shasum -a 256 -c genfeed-selfhosted.tar.gz.sha256 for the checksum step. The API and WebSocket ports bind to 127.0.0.1; a remote browser needs a reverse proxy configured as described in the self-hosting guide.

Shortened. The full README is on GitHub.