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

   git clone https://github.com/LEKKALAGANESH/Eleven-Labs-MCP-Integration.git
   cd Eleven-Labs-MCP-Integration
   

2. Install dependencies

   pip install -r requirements.txt
   

3. Configure environment variables

   cp .env.example .env
   # Edit .env with your actual values
   

4. Run the server

   uvicorn app.main:app --reload
   

🔧 Configuration

Create a .env file with the following variables:

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:

{
  "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:

{
  "phone_number": "+1234567890"
}

Response:

{
  "result": {
    "conversation_id": "conv_3401k1casackffe9emj08wgf9zsd",
    "call_sid": "CA12265951d92ca816f1f15693d7efd6a2",
    "status": "success"
  }
}

🎯 Usage Examples

Using curl

1. Create the agent:

   curl -X POST "http://localhost:8000/create-agent"
   

2. Make a call:

   curl -X POST "http://localhost:8000/call" \
        -H "Content-Type: application/json" \
        -d '{"phone_number": "+1234567890"}'
   

Using Python requests

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
• FastAPI Documentation
• MCP (Model Context Protocol)

📝 License

This project is open source and available under the MIT 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