AI Directory MCP Server

1# AI Directory MCP Server
2 
3MCP (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.
4 
5## Installation
6 
7```bash
8cd mcp-server
9npm install
10```
11 
12## Usage with Claude Desktop
13 
14Add to your Claude Desktop config (`claude_desktop_config.json`):
15 
16```json
17{
18  "mcpServers": {
19    "ai-directory": {
20      "command": "node",
21      "args": ["C:/Users/es/textmei-frontend/mcp-server/index.js"]
22    }
23  }
24}
25```
26 
27## Access Modes
28 
29### Public Mode (Default)
30By default, the server runs in **public mode** which only exposes webchat URLs for Voxie services. This is the mode used when publishing to npm.
31 
32### Full Access Mode
33For partners or internal use, set the environment variable to expose SMS/voice numbers:
34 
35```json
36{
37  "mcpServers": {
38    "ai-directory": {
39      "command": "node",
40      "args": ["C:/Users/es/textmei-frontend/mcp-server/index.js"],
41      "env": {
42        "VOXIE_FULL_ACCESS": "true"
43      }
44    }
45  }
46}
47```
48 
49## Available Tools
50 
51### `list_ai_services`
52List all AI services or filter by provider type.
53- `provider`: "all", "voxie", or "third-party"
54 
55### `get_ai_service`
56Get details about a specific service by ID.
57- `id`: Service ID (e.g., "voxie-us", "chatgpt-us")
58 
59### `find_ai_services_by_country`
60Find services available in a specific country.
61- `country`: Country name or partial match
62 
63### `chat_with_ai`
64Get a webchat URL to chat with a Voxie AI persona (recommended).
65- `persona`: "voxie", "rhodey", "soarie", "mia", or "wallie"
66 
67## Available Resources
68 
69- `ai-directory://services/all` - All services
70- `ai-directory://services/voxie` - Voxie AI personas
71- `ai-directory://services/third-party` - Third-party services
72 
73## API Endpoint
74 
75The directory is also available as a REST API at:
76- `https://voxie.network/api/ai-directory`
77 
78Query parameters:
79- `id` - Get specific service
80- `provider` - Filter by "voxie" or "third-party"
81- `country` - Filter by country name
82- `channel` - Filter by "sms", "voice", or "webchat"
83 
84## Publishing to npm
85 
86```bash
87npm publish --access public
88```
89 
90The public npm package only exposes webchat URLs, protecting your SMS/voice costs.
91