README.md•2.72 kB
# ODIADEV MCP Server v4.1.0
Nigeria's AI Infrastructure - Production Ready MCP Server
## Quick Deployment
### Deploy to Vercel
`ash
git clone https://github.com/Odiabackend099/odiadev-mcp-server.git
cd odiadev-mcp-server
vercel --prod
`
### Set Environment Variables in Vercel Dashboard
`ash
FLW_SECRET_KEY=FLWSECK-your-secret-key-here
FLW_WEBHOOK_SECRET_HASH=your-webhook-hash
ODIA_TTS_BASE_URL=https://odiadev-tts-plug-n-play.onrender.com/speak
CORS_ALLOW_ORIGIN=https://odia.dev
VALID_API_KEYS=your_api_key_1,your_api_key_2
`
## API Endpoints
| Endpoint | Method | Purpose | Status |
|----------|--------|---------|---------|
| /api/healthcheck | GET | System health & diagnostics | Ready |
| /api/payments/initiate | POST | Flutterwave payment processing | Ready |
| /api/tts/speak | POST | Nigerian voice text-to-speech | Ready |
| /api/webhook/flutterwave | POST | Payment webhook processing | Ready |
## ODIADEV Agents
- **Agent Lexi**: WhatsApp business automation and customer onboarding
- **Agent MISS**: University academic support for Nigerian institutions
- **Agent Atlas**: Luxury travel and VIP client management
- **Agent Legal**: NDPR compliance and legal document processing
## Nigerian Network Optimizations
- **3-Retry Logic**: Automatic retries with 250ms/500ms/1000ms delays
- **Timeout Handling**: 30-second timeouts for slow 2G/3G connections
- **Minimal Payloads**: Optimized for limited data plans
- **Network-Friendly**: Works reliably on MTN, Airtel, Glo, and 9mobile
## Security Features
- CORS configured for Nigerian domains
- Input validation and sanitization
- Request timeout handling
- Error logging without exposing secrets
- API key authentication
- Webhook signature verification
## Local Development
`ash
npm install
vercel dev
`
Test endpoints:
`ash
curl http://localhost:3000/api/healthcheck
`
## Monitoring & Health
The health endpoint provides comprehensive system diagnostics:
- Service status and uptime
- Environment configuration
- MCP protocol capabilities
- Nigerian network optimizations status
## Production Deployment
1. **Fork this repository**
2. **Set environment variables in Vercel dashboard**
3. **Deploy**: ercel --prod
4. **Test**: Visit https://your-domain.vercel.app/api/healthcheck
## Documentation
- **API Docs**: [docs.odia.dev](https://docs.odia.dev)
- **Support**: [support.odia.dev](https://support.odia.dev)
- **MCP Protocol**: [Model Context Protocol](https://modelcontextprotocol.io)
## Company
**ODIADEV** - Building AI infrastructure for Nigerian businesses, universities, and government agencies.
---
**Built with love for Nigeria by ODIADEV Team**
*Empowering African businesses through AI automation*