{
  "info": {
    "name": "Convolo AI — mcp.ai",
    "description": "REST API for the Convolo AI MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/convolo_ai",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "convolo_ai_create_character",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/character",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "character"
          ]
        },
        "description": "Tool to create a new character. Use when you have name, voice type, backstory, and optional actions ready.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"actions\": \"\",\n  \"charName\": \"\",\n  \"backstory\": \"\",\n  \"voiceType\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "convolo_ai_evaluate_character",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/evaluate/character",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "evaluate",
            "character"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"prompt\": \"\",\n  \"variables\": {},\n  \"session_id\": \"\",\n  \"character_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "convolo_ai_generate_starter_conversation",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/generate/starter/conversation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "generate",
            "starter",
            "conversation"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"charId\": \"\",\n  \"sessionId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "convolo_ai_get_character_response",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/character/response",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "character",
            "response"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"file\": \"\",\n  \"charID\": \"\",\n  \"stream\": \"\",\n  \"userText\": \"\",\n  \"sessionID\": \"\",\n  \"sample_rate\": \"\",\n  \"voiceResponse\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "convolo_ai_list_voices",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/voices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "voices"
          ]
        },
        "description": "Tool to retrieve the list of available voice types. Use when selecting voices before generating speech.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"accept\": \"\",\n  \"contentType\": \"\",\n  \"use_alt_domain\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "convolo_ai_set_core_ai_settings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/set/core/ai/settings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "set",
            "core",
            "ai",
            "settings"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"charID\": \"\",\n  \"temperature\": 0,\n  \"model_group_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "convolo_ai_upload_knowledge_bank",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/upload/knowledge/bank",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "upload",
            "knowledge",
            "bank"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"file\": \"\",\n  \"file_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}