News Agents

v1.0.0โ€ขSearch & Data Extractionโ€ขstable

๐Ÿ“ฐ Building News Agents to Summarize News with MCP, Q, and tmux

agentamazon-qmcptmux
Share:
318
Stars
0
Downloads
0
Weekly
0/5

What is News Agents?

News Agents is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ“ฐ building news agents to summarize news with mcp, q, and tmux

๐Ÿ“ฐ Building News Agents to Summarize News with MCP, Q, and tmux

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐Ÿ“ฐ Building News Agents to Summarize News with MCP, Q, and tm

Use Cases

Summarize news articles from multiple sources.
eugeneyan

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx news-agents

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use News Agents

News Agents is a multi-agent news summarization system that uses the Model Context Protocol to expose RSS feeds as tools, Amazon Q CLI as the agent orchestration framework, and tmux for parallel terminal management. Three sub-agents run concurrently, each consuming a slice of configured RSS feeds, and a main orchestrator agent merges their summaries into a single daily briefing. It is a reference architecture for building parallel, MCP-powered news pipelines.

Prerequisites

  • Python 3.11+ and uv package manager installed
  • Amazon Q CLI installed and authenticated with AWS credentials
  • tmux installed (for parallel agent sessions)
  • Git for cloning the repository
  • Active AWS account with Amazon Q Developer access
1

Install Amazon Q CLI

Follow the official AWS guide to install the Amazon Q CLI for your platform, then verify the installation.

# Verify installation
q --version
2

Clone the repository and install Python dependencies

Clone the news-agents repo and use `uv` to create a virtual environment and install all dependencies including the MCP RSS server.

git clone https://github.com/eugeneyan/news-agents.git
cd news-agents
uv sync
3

Configure your RSS feeds

Edit `feeds.txt` in the project root to list the RSS feed URLs you want the agents to monitor. Each URL goes on its own line.

# feeds.txt example
https://feeds.arstechnica.com/arstechnica/index
https://hnrss.org/frontpage
https://www.wired.com/feed/rss
4

Test the MCP server locally

Before running the full agent pipeline, verify the MCP RSS server starts correctly using the `mcp dev` command.

uv run mcp dev src/main.py
5

Launch the multi-agent pipeline

Start an Amazon Q chat session with tool trust enabled, add the agent context, then instruct the main agent to spin up sub-agents. The orchestrator uses tmux to open parallel sessions.

q chat --trust-all-tools
/context add --global context/agents.md
# Then type:
# "read context/main-agent.md and spin up sub agents"
6

Review generated summaries

After the agents complete their runs, individual feed summaries appear in `summaries/<feed-name>.md` and the consolidated daily briefing is written to `summaries/main-summary.md`.

cat summaries/main-summary.md

News Agents Examples

Client configuration

The MCP server is consumed by Amazon Q CLI, not Claude Desktop. This is the recommended way to run the MCP RSS server for local development.

# Run the MCP server directly for development
uv run mcp dev src/main.py

# Or invoke via Amazon Q with trusted tools
q chat --trust-all-tools

Prompts to try

Example prompts to use with Amazon Q after setting up the news-agents context.

- "Read context/main-agent.md and spin up sub agents to fetch today's news"
- "Summarize the top 5 AI stories from the Ars Technica and Wired feeds"
- "Add https://feeds.feedburner.com/TechCrunch to feeds.txt and re-run the agents"
- "Compare today's main-summary.md to yesterday's and highlight new developments"

Troubleshooting News Agents

`q chat` fails with authentication errors

Run `aws configure` to set your AWS credentials and region, or set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_DEFAULT_REGION environment variables. Ensure your IAM user or role has Amazon Q Developer permissions.

MCP server fails to start with import errors

Run `uv sync` again to ensure all dependencies are installed in the virtual environment. Use `uv tree` to verify the dependency graph. Python 3.11+ is required.

tmux sessions are not created for sub-agents

Ensure tmux is installed and accessible on PATH (`which tmux`). On macOS install via `brew install tmux`. The main agent requires an active tmux server โ€” start one manually with `tmux new -s main` before invoking the agent.

Frequently Asked Questions about News Agents

What is News Agents?

News Agents is a Model Context Protocol (MCP) server that ๐Ÿ“ฐ building news agents to summarize news with mcp, q, and tmux It connects AI assistants to external tools and data sources through a standardized interface.

How do I install News Agents?

Follow the installation instructions on the News Agents GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with News Agents?

News Agents works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is News Agents free to use?

Yes, News Agents is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "news-agents": { "command": "npx", "args": ["-y", "news-agents"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use News Agents?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides