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

Clone the repository

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

Install dependencies
```
pip install -r requirements.txt
```

Configure environment variables

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

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

Create the agent:

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

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

📝 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

Tech News Update Agent

README Documentation