{
  "info": {
    "name": "Botstar — mcp.ai",
    "description": "REST API for the Botstar 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/botstar",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "botstar_create_bot",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/bot",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "bot"
          ]
        },
        "description": "Tool to create a new bot in BotStar. Use when you need to create a new bot instance with a specific name.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_create_bot_attribute",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/bot/attribute",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "bot",
            "attribute"
          ]
        },
        "description": "Tool to create a new bot attribute in BotStar. Bot attributes are global variables for a bot and support multilingual values. Use when you need to define custom data fields for your bot.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"desc\": \"\",\n  \"name\": \"\",\n  \"value\": \"\",\n  \"bot_id\": \"\",\n  \"data_type\": \"\",\n  \"additional_values\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_create_cms_entity",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/cms/entity",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "cms",
            "entity"
          ]
        },
        "description": "Tool to create a CMS entity in BotStar with a name and optional fields. Use when you need to define a new content structure with custom fields supporting various data types.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"name\": \"\",\n  \"bot_id\": \"\",\n  \"fields\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_create_entity_fields",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/entity/fields",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "entity",
            "fields"
          ]
        },
        "description": "Tool to create entity field(s) in BotStar CMS. Supports multiple field types including text, multiple_values, single_option, multiple_options, image, date, and entity. Use when you need to add new fie",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"botId\": \"\",\n  \"fields\": \"\",\n  \"entityId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_create_entity_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/entity/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "entity",
            "item"
          ]
        },
        "description": "Tool to create a new entity item in BotStar CMS. Use when adding items to a CMS entity with custom field values.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"name\": \"\",\n  \"bot_id\": \"\",\n  \"status\": \"\",\n  \"entity_id\": \"\",\n  \"additional_fields\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_create_user_attributes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/user/attributes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "user",
            "attributes"
          ]
        },
        "description": "Tool to create custom user attributes in BotStar. Use when you need to define new custom attributes for users with specified field name and type.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": \"\",\n  \"field_name\": \"\",\n  \"field_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_delete_bot_attribute",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/bot/attribute",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "bot",
            "attribute"
          ]
        },
        "description": "Tool to delete a bot attribute by ID. Use when you need to remove a custom attribute from a bot.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"bot_id\": \"\",\n  \"attribute_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_delete_cms_entity",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/cms/entity",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "cms",
            "entity"
          ]
        },
        "description": "Tool to delete a CMS entity by ID. Use when you need to remove an entity from the bot's content management system.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"bot_id\": \"\",\n  \"entity_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_delete_entity_fields",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/entity/fields",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "entity",
            "fields"
          ]
        },
        "description": "Tool to delete entity field(s) from a CMS entity. Use when you need to remove fields from a CMS entity by their unique names.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"bot_id\": \"\",\n  \"entity_id\": \"\",\n  \"unique_names\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_delete_entity_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/entity/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "entity",
            "item"
          ]
        },
        "description": "Tool to delete an entity item from a CMS entity. Use when you need to remove a specific item from a bot's CMS entity.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"bot_id\": \"\",\n  \"entity_id\": \"\",\n  \"entity_item_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_get_bot",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/bot",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "bot"
          ]
        },
        "description": "Tool to get your bot by bot ID. Use when you need detailed bot information including ID, name, and team name.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_get_bot_app_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/bot/app/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "bot",
            "app",
            "id"
          ]
        },
        "description": "Tool to retrieve the BotStar application ID (`appId`). Use when initializing or reinitializing the live chat widget.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0,\n  \"bot_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_get_cms_entity",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/cms/entity",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "cms",
            "entity"
          ]
        },
        "description": "Tool to get a specific CMS entity by ID. Returns entity details including fields configuration. Use when you need to retrieve metadata about a CMS entity structure.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"bot_id\": \"\",\n  \"entity_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_get_entity_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/entity/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "entity",
            "item"
          ]
        },
        "description": "Tool to retrieve a specific item from a CMS entity with all field values. Use when you need to get detailed information about a single entity item.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"bot_id\": \"\",\n  \"entity_id\": \"\",\n  \"entity_item_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_list_bot_attributes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/bot/attributes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "bot",
            "attributes"
          ]
        },
        "description": "Tool to get all bot attributes from BotStar. Returns array of bot attributes with id, name, desc, value, and data_type. Use when you need to retrieve or inspect all attributes configured for a bot.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"bot_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_list_bots",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/bots",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "bots"
          ]
        },
        "description": "Tool to get your list of bots. Use when you need to retrieve all bots associated with your account. Returns an array of bots with their id, name, and team_name.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"limit\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_list_cms_entities",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/cms/entities",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "cms",
            "entities"
          ]
        },
        "description": "Tool to retrieve all CMS entities for a bot. Use when you need to access entity definitions, field configurations, or available entity schemas.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"botId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_list_entity_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/entity/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "entity",
            "items"
          ]
        },
        "description": "Tool to retrieve all entity items with pagination support. Use when you need to list CMS entity items, with optional filtering by name and status.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"name\": \"\",\n  \"page\": 0,\n  \"limit\": 0,\n  \"bot_id\": \"\",\n  \"status\": \"\",\n  \"entity_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_livechat_boot",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/livechat/boot",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "livechat",
            "boot"
          ]
        },
        "description": "Tool to reinitialize the live chat widget with provided data. Use after initial load to reset or update widget configuration.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"mode\": \"\",\n  \"user\": {},\n  \"appId\": \"\",\n  \"block\": \"\",\n  \"variables\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_livechat_close",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/livechat/close",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "livechat",
            "close"
          ]
        },
        "description": "Tool to hide the live chat window. Use when the chat widget is configured in livechat or popup mode.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_livechat_on_close",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/livechat/on/close",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "livechat",
            "on",
            "close"
          ]
        },
        "description": "Tool to register a callback when the chat window is closed. Use after the widget is initialized. Example prompt: \"Register an onClose handler that logs 'Goodbye!' to the console.\"",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"callback_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_livechat_on_open",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/livechat/on/open",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "livechat",
            "on",
            "open"
          ]
        },
        "description": "Tool to register a callback when the chat window is opened. Use after widget initialization.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"callback\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_livechat_open",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/livechat/open",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "livechat",
            "open"
          ]
        },
        "description": "Tool to show the live chat window. Use after the widget has been bootstrapped with BotStarApi('boot') to programmatically open the chat window (mode must be 'livechat' or 'popup').",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_livechat_update",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/livechat/update",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "livechat",
            "update"
          ]
        },
        "description": "Tool to update user details on the current live chat session. Use when you need to modify user profile attributes during an active conversation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tags\": \"\",\n  \"email\": \"\",\n  \"avatar\": \"\",\n  \"gender\": \"\",\n  \"user_id\": \"\",\n  \"birthday\": \"\",\n  \"last_name\": \"\",\n  \"first_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_publish_bot",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/publish/bot",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "publish",
            "bot"
          ]
        },
        "description": "Tool to publish a bot to live. Use when you need to deploy changes to the production environment.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_update_bot_attribute",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/bot/attribute",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "bot",
            "attribute"
          ]
        },
        "description": "Tool to update a bot attribute in BotStar. Use when you need to modify the description or value of a bot attribute with optional multilingual support.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"desc\": \"\",\n  \"value\": \"\",\n  \"bot_id\": \"\",\n  \"attribute_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_update_cms_entity",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/cms/entity",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "cms",
            "entity"
          ]
        },
        "description": "Tool to update a CMS entity in BotStar. Use when you need to modify the name or configuration of an existing CMS entity.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"name\": \"\",\n  \"bot_id\": \"\",\n  \"entity_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_update_entity_fields",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/entity/fields",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "entity",
            "fields"
          ]
        },
        "description": "Tool to update entity field(s) in BotStar CMS. Use when you need to modify the name or options of existing fields.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"bot_id\": \"\",\n  \"fields\": \"\",\n  \"entity_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_update_entity_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/entity/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "entity",
            "item"
          ]
        },
        "description": "Tool to update a CMS entity item in BotStar. Use when you need to modify the name, status, or custom field values of an entity item.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"name\": \"\",\n  \"bot_id\": \"\",\n  \"status\": \"\",\n  \"entity_id\": \"\",\n  \"custom_fields\": {},\n  \"entity_item_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_webview_get_parameter",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/webview/get/parameter",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "webview",
            "get",
            "parameter"
          ]
        },
        "description": "Tool to retrieve a parameter value passed from the BotStar chatbot to the webview. Use inside onChatBotReady after your page loads in modal mode with bs:input meta tags.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"parameter_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "botstar_webview_send_response",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/webview/send/response",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "webview",
            "send",
            "response"
          ]
        },
        "description": "Tool to send data from the webview back to the BotStar chatbot. Use when you need to transmit responses or custom outputs from an open webview.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"outputs\": {},\n  \"response\": \"\",\n  \"outlet_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}