What You'll Set Up

By the end of this guide, your AI agent will be able to build and manage AI voice agents, make outbound phone calls, handle inbound calls, run batch call campaigns, and configure phone numbers — all through a simple conversation.

This integration is especially useful for sales teams, customer support operations, and anyone running phone-based outreach at scale. Instead of manually configuring voice agents and dialing campaigns in a dashboard, your agent handles it for you.

Retell AI

38 tools · Give your agents control over AI voice calling

Before You Begin

Make sure you have:

A Retell AI account — Sign up at retell.ai
A Pipeworks workspace — Sign up at pipeworks.ai if you haven't already

Info

Retell AI offers a free tier to get started. Check their pricing page for details on call minutes and feature limits.

Steps

Get your Retell AI API key

If you don't have an API key yet, click Create API Key to generate one.

Open your Pipeworks console

Log into your Pipeworks workspace and go to the Integrations page. Find Retell AI in the list and click on it.

Enter your API key

Paste your Retell AI API key into the Retell API Key field and click Connect.

Pipeworks encrypts your credentials with AES-256-GCM before storing them. The plaintext is never saved to disk and is only decrypted when your integration container starts.

Start the integration

Click Start to launch the Retell AI integration container. This takes a few seconds. Once the status shows Running, your agent is ready to manage voice calls.

Test the connection

Use the Test button in your Pipeworks console to verify the connection. This sends a simple request to confirm your API key is working.

What Your Agent Can Do

Once connected, your AI agent has access to 35 tools covering the full Retell AI platform:

Voice agents — Create, update, delete, and publish AI voice agents with custom configurations
LLM and prompts — Configure the language model powering your agents, including prompts, tools, and live transfer settings
Conversation flows — Build and manage structured conversation flows for your voice agents
Phone calls — Make single outbound calls or run batch call campaigns with full control over scheduling and parameters
Phone numbers — Buy, release, and configure phone numbers for inbound and outbound use
Knowledge bases — Create and manage knowledge bases that your voice agents can reference during calls
Voice browsing — Browse and select from available voices for your agents

Connecting from Your AI Agent

Add the Pipeworks tools endpoint to your agent's configuration. Here's an example for Claude Desktop:

json

{'{'}
  "mcpServers": {'{'}
    "pipeworks-retell-ai": {'{'}
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.pipeworks.ai/tools/retell-ai"]
    {'}'}
  {'}'}
{'}'}

Claude Desktop will prompt you to sign in through Pipeworks when you first connect. No access key needed.

Troubleshooting

Connection test fails? Double-check that you copied the full API key from your Retell AI dashboard.

Getting "Invalid API key" errors? Verify your API key is active in the Retell AI dashboard and that your account is in good standing.

Agent can't find tools? Verify your Pipeworks session is authenticated and that the integration status shows "Running" in your Pipeworks console.

Connect Retell AI to Pipeworks

Prerequisites