🧠 MCP TweetAgent

LLM-Powered Social Media Agent using the Model Context Protocol

---

📌 Overview

MCP TweetAgent is a smart, context-aware agent that generates and posts tweets autonomously using OpenAI's LLMs and the Model Context Protocol (MCP). Built with Node.js, it securely integrates with X (formerly Twitter) using OAuth 2.0 for Read/Write operations.

This project demonstrates how to combine LLM-driven content generation with automated social media posting, all orchestrated through an agent-based architecture with persistent context and memory handling.

---

✨ Features

• 🤖 LLM-Generated Content — Posts are dynamically created via GPT-powered prompts.
• 📚 Context-Aware Agent — Utilizes MCP for memory, system prompts, and action routing.
• 🔐 OAuth 2.0 Integration — Secure access with Twitter API v2 using Read/Write scopes.
• 🔁 Fully Automated Flow — No manual input needed once running.
• 🧰 Built with: Node.js, Twitter API v2, OpenAI API, dotenv

---

🚀 Tech Stack

• Node.js – Core backend runtime
• OpenAI API – Content generation
• Twitter API v2 – Post tweets
• Model Context Protocol (MCP) – Agent orchestration and memory
• OAuth 2.0 – Secure user authorization
• dotenv – Environment variable management

---

📦 Setup & Installation

1. Clone the repo:

   git clone https://github.com/your-username/mcp-tweetagent.git
   cd mcp-tweetagent