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

cd mcp-server
npm install

Usage with Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "ai-directory": {
      "command": "node",
      "args": ["C:/Users/es/textmei-frontend/mcp-server/index.js"]
    }
  }
}

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:

{
  "mcpServers": {
    "ai-directory": {
      "command": "node",
      "args": ["C:/Users/es/textmei-frontend/mcp-server/index.js"],
      "env": {
        "VOXIE_FULL_ACCESS": "true"
      }
    }
  }
}

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

npm publish --access public

The public npm package only exposes webchat URLs, protecting your SMS/voice costs.