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.
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:
-
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
-
Create and activate a virtual environment (recommended): python -m venv .venv
On Windows
..venv\Scripts\activate
On macOS/Linux
source .venv/bin/activate
-
Install dependencies: pip install -r requirements.txt
-
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
-
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
mcp-agent
Build effective agents using Model Context Protocol and simple workflow patterns
nerve
The Simple Agent Development Kit.
mcp-checkpoint
MCP Checkpoint continuously secures and monitors Model Context Protocol operations through static and dynamic scans, revealing hidden risks in agent-to-tool communications.
nimbletools-core
NimbleTools is an open-source MCP runtime. Infrastructure for the agentic web.
muxi
An extensible AI agents framework
xcatcher -manifest
Agent-first Remote MCP for X (Twitter) batch crawling with x402 USDC top-up (Base/Solana). Includes OpenAPI + copy-paste ADK/curl E2E examples.