# Convolo AI — how to use (mcp.ai)

Connect your Convolo AI account and use 7 tools for AI sales tools straight from your AI agent. Connect with your own API key. Convolo.ai is an AI-powered communications platform designed to enhance sales calls and improve conversion rates through rapid lead response and integration capabilities.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_convolo_ai?ms=1787291340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `convolo_ai_create_character`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/convolo_ai`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/convolo_ai/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/convolo_ai/create/character` — Tool to create a new character. Use when you have name, voice type, backstory, and optional actions ready.
  - body: { actions?: string[], charName: string, backstory: string, voiceType: string }
- `POST https://api.mcp.ai/api/convolo_ai/evaluate/character` — Evaluates a conversation session across 9 quality dimensions (clarity, courtesy, product knowledge, etc.) using AI analysis. Returns structured ratings and feedback. Prerequisites: - A valid session_i
  - body: { prompt: string, variables?: object, session_id: string, character_id: string }
- `POST https://api.mcp.ai/api/convolo_ai/generate/starter/conversation` — Generates AI-powered conversation starter suggestions for a character. This tool creates contextually relevant opening lines or follow-up dialogue suggestions that can be used to initiate or continue 
  - body: { charId: string, sessionId: string }
- `POST https://api.mcp.ai/api/convolo_ai/get/character/response` — Tool to generate a response from a ConvAI character based on text or audio input. Use when needing a text or voice reply in an ongoing session.
  - body: { file?: string, charID: string, stream?: string, userText?: string, sessionID: string, sample_rate?: string, voiceResponse: boolean }
- `POST https://api.mcp.ai/api/convolo_ai/list/voices` — Tool to retrieve the list of available voice types. Use when selecting voices before generating speech.
  - body: { accept?: string, contentType?: string, use_alt_domain?: boolean }
- `POST https://api.mcp.ai/api/convolo_ai/set/core/ai/settings` — Updates the core AI settings (model and/or temperature) for an existing Convai character. Use this action to: - Switch the AI model powering a character (e.g., from GPT-4o to Claude) - Adjust response
  - body: { charID: string, temperature?: number, model_group_name?: string }
- `POST https://api.mcp.ai/api/convolo_ai/upload/knowledge/bank` — Tool to upload a knowledge bank file. Use when you have a file ready to add to Convolo AI's knowledge bank (Enterprise plan only).
  - body: { file: string, file_name: string }

## Example prompts
- "What can I do in Convolo AI?"
- "Show me a summary of my Convolo AI account"

## More
- Page: https://mcp.ai/convolo_ai
- Agent spec (llms.txt): https://mcp.ai/convolo_ai/llms.txt
- Postman collection: https://mcp.ai/convolo_ai/postman.json