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

Related MCP server: OpenAPI to Model Context Protocol (MCP)

📁 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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tech News Update Agent