News Instagram

You have a complete MCP server that automates the end‑to‑end workflow of turning Canadian news into Instagram posts. It scrapes trusted sources, analyzes content with AI, generates visuals and captions, schedules posts, and publishes them via the MCP protocol, while providing analytics and safety safeguards.

How to use

Use an MCP client to connect to the News Instagram MCP Server and drive the workflow. You can scrape the latest articles, analyze content, generate Instagram-ready posts, schedule them for optimal times, and publish or fetch analytics. The server exposes MCP tools for each step and real‑time resources for articles, posts, analytics, and configuration.

Typical usage patterns include: initiating a scrape to gather new articles, running analysis to determine categories and sentiment, generating posts with branded visuals and captions, scheduling posts for peak engagement, and publishing selected posts immediately or reviewing analytics to inform future content. You can operate via Claude Desktop or any MCP client that adheres to the MCP specification.

How to install

Prerequisites you need before installation are Python and a working environment for running the MCP server.

# Clone the server repository
git clone https://github.com/zegh6389/news-instagram-mcp.git
cd news-instagram-mcp

# Create a virtual environment
python -m venv .venv
. .venv/Scripts/activate  # Windows
# source .venv/bin/activate  # Linux/macOS

# Install dependencies
pip install -r requirements.txt

Configure environment variables and credentials for the MCP server according to your setup. A minimal example uses a local Python runtime within a virtual environment and runs the server in MCP stdio mode.

# Start the MCP server in stdio mode
python main.py --stdio

Configuration and security notes

The server supports MCP clients and provides a set of tools for scraping, analyzing, generating posts, scheduling, publishing, and analytics. Configuration is done through a combination of environment variables and YAML/JSON configuration files. Safety features include content moderation, rate limiting, and duplicate/content quality checks to help protect your account and maintain post quality.

Key environment variables you’ll typically configure include credentials for Instagram and AI services, as well as database settings and logging levels. For the runtime used in MCP stdio, you may see environment paths such as the Python virtual environment path and the main entry script being invoked.

Tools and endpoints you can use

The MCP server provides six primary tools to cover the full workflow: scrape_news, analyze_content, generate_post, schedule_post, publish_post, and get_analytics. These tools enable you to gather articles, process them with AI, create Instagram posts from articles, schedule them for optimal times, publish immediately, and retrieve performance metrics.

Troubleshooting and tips

If you encounter login or API access issues, verify your credentials and that any required two‑factor authentication or app passwords are correctly configured. For scraping, confirm that RSS feeds and site selectors are up to date. If a module cannot be found, reinstall dependencies with a fresh virtual environment. For database issues, ensure the database file exists and has appropriate permissions.

Available tools

scrape_news

Scrape latest articles from configured news sources using RSS feeds and site-specific selectors.

analyze_content

Analyze scraped articles to categorize content, determine sentiment, and extract keywords.

generate_post

Create an Instagram post from an article, including visuals and AI-generated captions.

schedule_post

Schedule posts for optimal engagement times based on analytics and configured rules.

publish_post

Publish posts immediately to Instagram via the configured API client.

get_analytics

Return performance metrics and insights from posted content.