contentforge-mcp

@gentry-ai-bot/contentforge

Content pipeline MCP server — from topic research to published article in one workflow.

ContentForge is a Model Context Protocol (MCP) server that provides AI agents and LLM clients with tools for the full content creation pipeline: topic research → image sourcing → SEO metadata → affiliate link enrichment → CMS publishing.

Available Tools

Tool	Description
list_sites	List all available sites and their categories from the CMS
source_images	Search for stock images on Pexels (URLs, alt text, photographer credit)
seo_metadata	Generate SEO metadata: slug, meta description, schema.org markup, internal link suggestions
enrich_links	Scan article content for Amazon product URLs and add affiliate tags
publish_article	Publish a complete article to the CMS (with auto-categorization and tag support)
get_existing_articles	Retrieve existing articles from a site (for internal linking and dedup)

Quick Start

Option 1: Stdio Mode (local, via npx)

npx @gentry-ai-bot/contentforge --stdio

Option 2: Hosted Mode (SSE, remote)

Connect to the hosted instance:

• SSE endpoint: https://bubbly-optimism-production.up.railway.app/sse
• Messages endpoint: https://bubbly-optimism-production.up.railway.app/messages
• Health check: https://bubbly-optimism-production.up.railway.app/health

Requires an API key via the x-api-key header.

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

Stdio mode (local):

{
  "mcpServers": {
    "contentforge": {
      "command": "npx",
      "args": ["@gentry-ai-bot/contentforge", "--stdio"],
      "env": {
        "CONTENTFORGE_CMS_URL": "https://your-cms-api.example.com",
        "CONTENTFORGE_CMS_KEY": "your-cms-api-key",
        "CONTENTFORGE_PEXELS_KEY": "your-pexels-api-key",
        "CONTENTFORGE_AMAZON_TAG": "your-affiliate-tag"
      }
    }
  }
}

Hosted mode (SSE):

{
  "mcpServers": {
    "contentforge": {
      "url": "https://bubbly-optimism-production.up.railway.app/sse",
      "headers": {
        "x-api-key": "your-api-key"
      }
    }
  }
}

Other MCP Clients

Any MCP-compatible client can connect via:

• Stdio: Run npx @gentry-ai-bot/contentforge --stdio as a subprocess
• SSE: Connect to the /sse endpoint with an x-api-key header

Environment Variables

Variable	Required	Description
CONTENTFORGE_CMS_URL	Yes (stdio)	CMS API base URL
CONTENTFORGE_CMS_KEY	Yes (stdio)	CMS API key
CONTENTFORGE_PEXELS_KEY	Yes	Pexels API key for image sourcing
CONTENTFORGE_AMAZON_TAG	No	Amazon affiliate tag (default: pickwise05-20)
CONTENTFORGE_API_KEY	No	API key for hosted mode authentication
PORT	No	HTTP server port (default: 3000)

Authentication

• Stdio mode: No auth needed — runs locally as a subprocess
• Hosted mode: Pass your API key via the x-api-key HTTP header on both /sse and /messages endpoints
• Rate limited to 100 requests/hour per API key

How It Works

• Research — Use list_sites and get_existing_articles to understand what content exists
• Source Images — Use source_images to find relevant stock photography from Pexels
• Optimize — Use seo_metadata to generate slugs, meta descriptions, and schema.org markup
• Monetize — Use enrich_links to automatically add affiliate tags to product links
• Publish — Use publish_article to push the finished article to your CMS

License

MIT