# sonnyflylock/voxie-ai-directory-mcp [Health: Active]

**Category:** 🔗 Aggregators  
**Repository:** https://github.com/sonnyflylock/voxie-ai-directory-mcp  
**GitHub Stars:** 3  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/sonnyflylock-voxie-ai-directory-mcp

## Description
AI Phone Number Directory providing access to AI services via webchat. Query Voxie AI personas and third-party services like ChatGPT, with instant webchat URLs for free interactions.

## Tools
Capabilities this server exposes over MCP:

- **list_ai_services** — List all AI services or filter by provider type.
- **get_ai_service** — Get details about a specific service by ID.
- **find_ai_services_by_country** — Find services available in a specific country.
- **chat_with_ai** — Get a webchat URL to chat with a Voxie AI persona (recommended).

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "voxie-ai-directory-mcp": {
    "command": "npx",
    "args": ["-y","sonnyflylock-voxie-ai-directory-mcp"],
    "env": {
      "VOXIE_FULL_ACCESS": ""
    }
  }
}
```

**Requires environment variables:** `VOXIE_FULL_ACCESS` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# AI Directory MCP Server

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

```bash
cd mcp-server
npm install
```

## Usage with Claude Desktop

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

```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:

```json
{
  "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

```bash
npm publish --access public
```

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