Thruai Voice Agent Server

What is Thruai Voice Agent Server?

Thruai Voice Agent Server is a Model Context Protocol (MCP) server that enables AI assistants like Claude and GPT to discover and use ThruAI's voice AI platform. It provides 50+ tools for creating voice agents, making calls, managing telephony, building workflows, and analyzing usage.

How to use Thruai Voice Agent Server?

Run directly with npx using the command THRUAI_API_KEY=sk_live_... npx github:mgWellPay/thruai-mcp-server. Alternatively, install globally or locally via npm. Configure by setting the THRUAI_API_KEY environment variable; optionally set THRUAI_BASE_URL for custom endpoints during the beta period.

Key features of Thruai Voice Agent Server

• One‑command quick start for a voice agent with phone number
• Full CRUD for voice agents (S2S or traditional pipeline)
• Outbound calls from agents to any phone number
• Usage and cost analytics with component breakdown
• Telephony: search, provision, and assign phone numbers
• Workflows with 30+ node types (CRM, calendar, email, etc.)

Use cases of Thruai Voice Agent Server

• Create a customer support voice agent with a local phone number
• Make outbound sales calls to a lead list and qualify prospects
• Analyze call transcripts, duration, cost, and AI insights
• Build complex automation workflows integrating CRM, email, and web tools
• Launch outbound calling campaigns with automated contact management

FAQ from Thruai Voice Agent Server

What API key is required?

A ThruAI API key starting with sk_live_ from your ThruAI account Settings → API Keys is required. Set it as the THRUAI_API_KEY environment variable.

How do I install the server?

The recommended method is to run with npx: THRUAI_API_KEY=sk_live_... npx github:mgWellPay/thruai-mcp-server. You can also install globally with npm install -g and run thruai-mcp.

Is ThruAI still in beta?

Yes. ThruAI is in active development, and the default API endpoint (api.thru.ai) may require a custom base URL during the beta. Set THRUAI_BASE_URL in your environment if needed.

What tools does the server expose?

Over 50 tools organized into domains: quick start, agent management, calls, telephony, workflows, campaigns, webhooks, custom tools, analytics, provider discovery, feedback, and schema discovery.

How does authentication work?

Authentication is via an API key passed as the THRUAI_API_KEY environment variable. All API calls are authorized against that key. Webhooks support optional HMAC signature verification.