MCP server for the Voxie AI Phone Number Directory
Server provides 4 well-named, read-only discovery tools with complete input schemas and clear descriptions. All tools follow verb-noun naming convention (list_, get_, find_, chat_with_). Descriptions are adequate (90-180 chars) and explain WHEN to use each tool. Input schemas are properly typed with enums where applicable. However, output schemas are completely undocumented, the code returns JSON.stringify() with no structured schema definition visible to clients. Error handling is absent: no guidance on what happens if an ID is invalid, a country name doesn't match, or the service is unavailable. The tools are well-scoped and compositional (list → get is a natural chain), but lack the production-grade output documentation and error recovery patterns expected in a 70+ score.
Get a webchat URL to chat with a Voxie AI persona. This is the recommended way to interact with Voxie AIs.
Find AI services available in a specific country or region
Get details about a specific AI service by its ID (e.g., 'voxie-us', 'chatgpt-us')
List AI services that can be accessed via webchat (and phone for some). Returns all services or filter by provider type.
Output schemas completely undocumented. All 4 tools return JSON.stringify() with no documented response structure, field types, or required fields visible to clients.
No error handling or recovery guidance. Invalid inputs (bad country name, non-existent service ID) are not documented as errors or recovery paths.
Parameter descriptions lack actionable constraints. 'country' parameter says 'partial match' but doesn't specify case-sensitivity, minimum length, or valid patterns. 'id' parameter has no format guidance.
Missing discovery hints in descriptions. LLM may not know that list_ai_services() should be called first to discover valid service IDs before calling get_ai_service().
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 57 | 2026-07-28+ | v2 |