Get the FREE Ultimate OpenClaw Setup Guide →

Reddit-News-Agent-System-Using -and-ADK

In this project multiple agents are created to fetch news from Reddit's subreddits based on user's query in natural language, summarized in the newscaster format and the final summarized news is returned to the user. Multimodality is also integrated in this project where, user can hear the summarized news.

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio rishabhmathur06-reddit-news-agent-system-using-mcp-and-adk python -m agents.coordinator \
  --env GOOGLE_API_KEY="Your Google Gemini or Vertex AI key" \
  --env REDDIT_CLIENT_ID="Your Reddit app client id" \
  --env REDDIT_USER_AGENT="Custom user agent for Reddit API" \
  --env ELEVENLABS_API_KEY="Your ElevenLabs API key" \
  --env REDDIT_CLIENT_SECRET="Your Reddit app client secret"

How to use

This MCP server coordinates a set of agents that fetch news from Reddit subreddits, summarize the content into a concise newscaster-style format, and optionally convert the final summary to speech. The main components are: Reddit Scout, which retrieves recent discussion titles from chosen subreddits; Summarizer, which condenses the retrieved content into a brief, readable summary; and Text-to-Speech (TTS), which can render the summarized content as spoken audio. You interact with the system via natural language prompts to request latest news, specify subreddits, or ask for a full summary. Use the provided environment to supply keys for Reddit API access and speech generation, and run the coordinator to orchestrate the agents and pass information using MCP communications.

How to install

Prerequisites:

  • Python 3.8+ installed on your system
  • Virtual environment support (recommended)
  • Internet access to install dependencies and fetch model/tool packages

Step-by-step installation:

  1. Clone the repository: git clone https://github.com/RishabhMathur06/Reddit-News-Agent-System-Using-MCP-and-ADK cd Reddit-News-Agent-System-Using-MCP-and-ADK

  2. Create and activate a virtual environment (recommended): python -m venv .venv

    On Windows

    ..venv\Scripts\activate

    On macOS/Linux

    source .venv/bin/activate

  3. Install dependencies: pip install -r requirements.txt

  4. Configure environment variables:

    • Copy example env and fill in keys: cp agents/.env.example agents/.env
    • Edit agents/.env and add your API keys and credentials (as described in the README): GOOGLE_API_KEY, REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USER_AGENT, ELEVENLABS_API_KEY
  5. Run the coordinator to start MCP server and agent orchestration: python -m agents.coordinator

Notes:

  • The exact module names (agents.coordinator) may vary if you reorganize the package structure; adjust the -m argument accordingly.
  • Ensure you activate the virtual environment in the same shell session where you start the coordinator.

Additional notes

Tips and common issues:

  • Ensure Reddit API credentials are valid and the user agent string is descriptive to avoid request throttling.
  • If using Vertex AI (Google GenAI), ensure GOOGLE_API_KEY corresponds to a valid project and endpoint; set GOOGLE_GENAI_USE_VERTEXAI accordingly in environment if required by the project.
  • If the ADK-based setup expects specific discovery or web view modes, start the web view first (per ADK docs) before interacting through the terminal.
  • Keep your .env/.env.local files secure and do not commit them to version control.
  • When running in a virtual environment, always activate it before launching any Python modules related to the MCP server.
  • If you modify the agent structure, update the coordinator imports and module references to reflect the new paths.

Related MCP Servers

Sponsor this space

Reach thousands of developers