Tech News Update Agent

# ElevenLabs MCP Integration - Tech News Update Agent A FastAPI backend to create an ElevenLabs agent that makes outbound calls to deliver friendly, jargon-free tech news updates. This project demonstrates the integration of ElevenLabs MCP (Model Context Protocol) for creating conversational AI agents with voice capabilities. ## 🚀 Features - **Conversational AI Agent**: Creates a confident, friendly tech-savvy colleague - **Voice Integration**: Uses ElevenLabs Alice voice for natural-sounding calls - **Tech News Delivery**: Provides updates about AI, programming, and cybersecurity - **Simple API**: Easy-to-use endpoints for agent creation and call management - **MCP Integration**: Leverages ElevenLabs MCP for seamless agent management ## 📁 Project Structure ``` ElevenLabs/ ├── app/ │ ├── main.py # FastAPI application with endpoints │ ├── elevenlabs_client.py # ElevenLabs API client functions │ └── config.py # Configuration and environment variables ├── requirements.txt # Python dependencies ├── .env.example # Environment variables template ├── .gitignore # Git ignore rules └── README.md # Project documentation ``` ## 🛠️ Setup ### Prerequisites - Python 3.8+ - ElevenLabs API key - ElevenLabs phone number (for outbound calls) - Git ### Installation 1. **Clone the repository** ```bash git clone https://github.com/LEKKALAGANESH/Eleven-Labs-MCP-Integration.git cd Eleven-Labs-MCP-Integration ``` 2. **Install dependencies** ```bash pip install -r requirements.txt ``` 3. **Configure environment variables** ```bash cp .env.example .env # Edit .env with your actual values ``` 4. **Run the server** ```bash uvicorn app.main:app --reload ``` ## 🔧 Configuration Create a `.env` file with the following variables: ```env ELEVENLABS_API_KEY=your_elevenlabs_api_key ELEVENLABS_BASE_URL=https://api.elevenlabs.io/v1 AGENT_VOICE_ID=Xb7hH8MSUJpSbSDYk0k2 AGENT_PHONE_NUMBER_ID=your_phone_number_id ``` ## 📡 API Endpoints ### 1. Create Agent **POST** `/create-agent` Creates a new Tech News Update Agent with predefined personality and voice. **Response:** ```json { "agent": { "agent_id": "agent_5701k1capwtse9fske3xgefspyra", "name": "Tech News Update Agent", "voice_id": "Xb7hH8MSUJpSbSDYk0k2" } } ``` ### 2. Make Outbound Call **POST** `/call` Initiates an outbound call to the specified phone number. **Request Body:** ```json { "phone_number": "+1234567890" } ``` **Response:** ```json { "result": { "conversation_id": "conv_3401k1casackffe9emj08wgf9zsd", "call_sid": "CA12265951d92ca816f1f15693d7efd6a2", "status": "success" } } ``` ## 🎯 Usage Examples ### Using curl 1. **Create the agent:** ```bash curl -X POST "http://localhost:8000/create-agent" ``` 2. **Make a call:** ```bash curl -X POST "http://localhost:8000/call" \ -H "Content-Type: application/json" \ -d '{"phone_number": "+1234567890"}' ``` ### Using Python requests ```python import requests # Create agent response = requests.post("http://localhost:8000/create-agent") agent_data = response.json() agent_id = agent_data["agent"]["agent_id"] # Make call call_data = {"phone_number": "+1234567890"} response = requests.post("http://localhost:8000/call", json=call_data) print(response.json()) ``` ## 🤖 Agent Personality The Tech News Update Agent is configured with: - **Tone**: Confident, friendly, and conversational - **Voice**: Alice (female voice) for natural communication - **Expertise**: AI, programming, and cybersecurity updates - **Style**: Jargon-free explanations with practical implications - **Approach**: Like a knowledgeable colleague sharing interesting news ## ⚠️ Important Notes - **Phone Verification**: You must have a verified or paid ElevenLabs/Twilio account to call unverified numbers - **Agent ID**: After creating the agent, update the `agent_id` in `main.py` with the returned ID - **API Limits**: Be aware of ElevenLabs API rate limits and usage quotas - **Environment Variables**: Never commit your actual API keys to version control ## 🔗 Related Links - [ElevenLabs API Documentation](https://docs.elevenlabs.io/) - [FastAPI Documentation](https://fastapi.tiangolo.com/) - [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) ## 📝 License This project is open source and available under the [MIT License](LICENSE). ## 🤝 Contributing Contributions are welcome! Please feel free to submit a Pull Request. ## 📞 Support For support, please open an issue in the GitHub repository or contact the maintainers. --- **Built with ❤️ using ElevenLabs MCP Integration**