MCP Tools Documentation for AI Voice Agents

What Are MCP Tools?

MCP (Model Context Protocol) is an open standard for connecting AI models to external tools and data sources. Voxentis supports MCP natively — register an MCP server and your agents can call any tool it exposes during a conversation.

• Tool signatures follow the pattern: {server_name}_{tool_name}
• MCP servers run as separate processes and communicate over stdio or HTTP
• Tools are automatically discovered from the MCP server manifest
• Each tool call is authenticated and logged for audit purposes

Endpoints

Register MCP Server

curl -X POST https://api.voxentis.com/v1/tools/mcp/servers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "filesystem",
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/data"]
  }'

Response — 201 Created

{
  "id": "mcp_abc123",
  "name": "filesystem",
  "transport": "stdio",
  "status": "connected",
  "tools": [
    { "name": "filesystem_read_file", "description": "Read a file from the filesystem" },
    { "name": "filesystem_write_file", "description": "Write content to a file" },
    { "name": "filesystem_list_directory", "description": "List files in a directory" }
  ]
}

Invoke an MCP Tool

curl -X POST https://api.voxentis.com/v1/tools/mcp/invoke \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "filesystem_read_file",
    "arguments": { "path": "/data/customers.json" }
  }'

After registering an MCP server, assign its tools to an agent using PATCH /agents/{id}/config with the tools array.