# PyAI Voice AI

> PyAI Voice AI is an MCP server for design and media. PyAI voice tools for AI apps: speech, transcription, recaps, dubbing and approved calls. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI
- **Website:** https://pyai.com/mcp
- **Repository:** https://github.com/atomsai/pyai-platform-backend/tree/HEAD/mcp
- **MCP Registry name:** io.github.atomsai/pyai
- **Categories:** design and media, AI models and LLM tooling, communication
- **Listing updated:** 2026-11-15

## About

Phone calls are the sensitive part, and the server is built around approval. Calling tools can preview a number and call request without buying or dialing, and a real call needs the telephony:manage permission, explicit confirmation and an idempotency key. An unconfirmed request returns needs_human instead of going through, and a sandbox key can't dial.

Beyond calls, the connection exposes PyAI's voice APIs to ChatGPT, Claude, Cursor and Codex: generating speech from text, transcribing recordings, creating voice agent profiles, summarizing calls into recaps, dubbing audio into another language, and rendering directed narration with a preview step. A compliance-review feature finds calls with missing disclosures and shows the supporting evidence.

The hosted endpoint signs in with browser OAuth: you pick a PyAI project and approve what the app may do, and the API key stays on the server. A local npm package reuses a saved CLI login instead. Access can be revoked under Connected AI apps in the PyAI console.

## Features

- **Text to speech:** list_voices and synthesize_speech turn text into audio with a supported voice.
- **Transcription:** transcribe_audio and transcription jobs convert recordings to text.
- **Voice agent profiles:** create_agent builds an agent with a greeting, boundaries, tools and knowledge.
- **Call recaps:** create_recap and get_recap summarize calls and pull out next steps.
- **Dubbing and narration:** Dub a recording into another language or direct, preview and render narration.
- **Approval-gated calling:** Dry-run previews first; dialing needs permission, confirmation and an idempotency key.
- **Project-scoped OAuth:** Sign in, choose a project and approve access; revoke in the console.

## Good for

- Turn a welcome message into voiceover audio
- Transcribe an interview and find key moments
- Summarize a sales call with objections and follow-ups
- Dub an English recording into Hindi
- Preview a phone call request before approving it
- Review calls for missing disclosures

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http pyai https://api.pyai.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.pyai.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pyai": {
      "url": "https://api.pyai.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pyai": {
      "type": "http",
      "url": "https://api.pyai.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pyai": {
      "serverUrl": "https://api.pyai.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pyai": {
      "type": "http",
      "url": "https://api.pyai.com/mcp"
    }
  }
}
```

## Tools

- `list_voices`: List available voices.
- `synthesize_speech`: Turn text into spoken audio.
- `transcribe_audio`: Transcribe an audio recording.
- `create_agent`: Create a voice agent profile.
- `create_recap`: Start a recap of a call.
- `get_recap`: Retrieve a recap.
- `discover_tools`: Find tools for a task or query.
- `get_started`: In-server setup guide.
- `whoami`: Show the connected account and project.
- `openapi_get`: Inspect the API contract before building requests.

## FAQ

### Do I copy an API key?

No for the hosted connection: you sign in with browser OAuth and the key stays on the server.

### Can MCP place a live call?

It can prepare or submit managed telephony requests, but dialing requires telephony:manage, explicit confirmation and an idempotency key.

### What does it cost?

It uses your project's normal PyAI credits and rates; reading the setup guide consumes no model credits. Omni is listed at $3.00 per hour, with $50 free credit at signup.

### How do I disconnect an app?

Revoke it under Connected AI apps in the PyAI console; access otherwise lasts up to 30 days.

### Can I run it locally?

Yes, the @pyai/mcp npm package reuses your saved PyAI CLI login.

### Is PyAI Voice AI free?

PyAI Voice AI is a paid product with a free trial.

### How do I add PyAI Voice AI to Claude Code?

Run this command in your terminal: claude mcp add --transport http pyai https://api.pyai.com/mcp

### What are the best alternatives to PyAI Voice AI?

The closest alternatives to PyAI Voice AI are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/pyai-voice-ai
