🤖 TweetPilot MCP — Your Automated Tweeting Agent

MCP Server is a powerful, lightweight server designed to automate tweeting on your behalf. Whether you want to schedule tweets, post updates programmatically, or integrate tweeting into your apps, MCP Server has you covered.

🚀 See It in Action! 🎥 Live Demo: Want to see TweetPilot MCP in action? 👉 Watch the Demo Video on X 🔥

🔧 See how easy it is to automate your tweets using just a few lines of code.

🚀 Features

• 🐦 Automated Tweet Posting: Schedule and send tweets effortlessly
• 🔒 Secure OAuth Authentication: Safely connect your Twitter account
• ⚙️ RESTful API: Easily integrate tweeting capabilities into any app
• 🕒 Custom Scheduling: Post tweets at specific times or intervals
• 📊 Tweet Status Tracking: Monitor success or failure of tweets
• 🔄 Retry Mechanism: Automatic retries for failed tweet attempts

🛠️ Tech Stack

📦 Installation & Setup

Prerequisites

• Node.js (v14+)
• Twitter Developer Account with API keys & tokens
• (Optional) MongoDB for logging

Steps

1. Clone the repo

git clone https://github.com/yourusername/mcp-server.git
cd mcp-server

1. Install dependencies

npm install

1. Configure environment variables

Create a .env file with the following variables:

TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret
PORT=3000

1. Start the server

npm start

🧩 Usage

API Endpoints

Example: Post a tweet immediately

curl -X POST http://localhost:3000/tweet \
-H "Content-Type: application/json" \
-d '{"message": "Hello world from MCP Server!"}'

🤝 Contributing

Contributions are welcome! To contribute:

1. Fork the repo
2. Create your feature branch (git checkout -b feature/YourFeature)
3. Commit your changes (git commit -m 'Add feature')
4. Push to your branch (git push origin feature/YourFeature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.