How zulfaaisha832-max/ai-news-mcp-agent works
AI News MCP Agent is a personal research assistant: the agent fetches and filters news, generates a summary and learning recommendations, then uses its MCP tool connections to find YouTube resources, save a report to Notion, and send a Gmail notification. The graph also preserves the documented service integrations and the separate script-based entry point. Source excerpts establish the main agent calls and news/Gemini behavior; some server and integration details are documented only in the README, so those edges cite it.
Main entry points: agent.py Agent Orchestrator · mcp_client.py MCP Client · main.py Script Entry Point · notion_server.py Notion Tool Server
Components 19
Agent Workflow
- Agent Orchestrator
agent.py - Tool Decision
ai_brain.py - MCP Client
mcp_client.py
News And Learning
- News Fetching
tools/news.py - News Summary
tools/summary.py - Learning Suggestions
tools/learning.py
MCP Integrations
- Notion Tool Server
servers/notion_server.py - YouTube Tool Server
servers/youtube_server.py - Gmail Tool Server
servers/gmail_server.py
Standalone Scripts
- Script Entry Point
main.py - YouTube Search Script
tools/youtube.py - Notion Script Tool
tools/notion.py - Gmail Script Tool
tools/gmail.py
Other components
- Report Request
- Notion
- YouTube
- Gmail
- News API
- Gemini
Connections 25
- Report Request → Agent Orchestrator: requests report
README.md - Agent Orchestrator → MCP Client: connects servers
agent.py - Agent Orchestrator → News Fetching: fetches news
agent.py - Agent Orchestrator → News Summary: generates summary
agent.py - Agent Orchestrator → Learning Suggestions: generates learning
agent.py - Agent Orchestrator → Tool Decision: chooses tools
agent.py - News Fetching → News API: requests articles
tools/news.py - News Summary → Gemini: generates summary
tools/summary.py - Learning Suggestions → Gemini: generates suggestions
tools/learning.py - Tool Decision → Gemini: requests decision
ai_brain.py - MCP Client → Notion Tool Server: starts server
mcp_client.py - MCP Client → YouTube Tool Server: starts server
mcp_client.py - MCP Client → Gmail Tool Server: starts server
mcp_client.py - Agent Orchestrator → YouTube Tool Server: calls search tool
agent.py - Agent Orchestrator → Notion Tool Server: calls save tool
agent.py - Agent Orchestrator → Gmail Tool Server: calls email tool
agent.py - Notion Tool Server → Notion: creates report page
servers/notion_server.py - YouTube Tool Server → YouTube: searches videos
README.md - Gmail Tool Server → Gmail: sends report email
servers/gmail_server.py - Script Entry Point → Notion Script Tool: runs script
main.py - Script Entry Point → Gmail Script Tool: runs script
main.py - Script Entry Point → YouTube Search Script: runs script
main.py - Notion Script Tool → Notion: stores knowledge
README.md - Gmail Script Tool → Gmail: sends notifications
README.md - YouTube Search Script → YouTube: searches resources
README.md