sonnyflylock/voxie-ai-directory-mcp

MCP (Model Context Protocol) server for the Voxie AI Phone Number Directory. Allows AI assistants to query information about AI services and get webchat URLs to interact with them.
Installation
Usage with Claude Desktop
Add to your Claude Desktop config (claude_desktop_config.json):
Access Modes
Public Mode (Default)
By default, the server runs in **public mode** which only exposes webchat URLs for Voxie services. This is the mode used when publishing to npm.
Full Access Mode
For partners or internal use, set the environment variable to expose SMS/voice numbers:
Available Tools
list_ai_services
List all AI services or filter by provider type.
- provider: "all", "voxie", or "third-party"
get_ai_service
Get details about a specific service by ID.
- id: Service ID (e.g., "voxie-us", "chatgpt-us")
find_ai_services_by_country
Find services available in a specific country.
- country: Country name or partial match
chat_with_ai
Get a webchat URL to chat with a Voxie AI persona (recommended).
- persona: "voxie", "rhodey", "soarie", "mia", or "wallie"
Available Resources
- ai-directory://services/all - All services
- ai-directory://services/voxie - Voxie AI personas
- ai-directory://services/third-party - Third-party services
API Endpoint
The directory is also available as a REST API at:
- https://voxie.network/api/ai-directory
Query parameters:
- id - Get specific service
- provider - Filter by "voxie" or "third-party"
- country - Filter by country name
- channel - Filter by "sms", "voice", or "webchat"
Publishing to npm
The public npm package only exposes webchat URLs, protecting your SMS/voice costs.