{
  "info": {
    "name": "Chatforma — mcp.ai",
    "description": "REST API for the Chatforma 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/chatforma",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "chatforma_get_user_variable",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/user/variable",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "user",
            "variable"
          ]
        },
        "description": "Get the current value of one bot variable for one bot user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0,\n  \"bot_user_id\": 0,\n  \"variable_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_list_bots",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/bots",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "bots"
          ]
        },
        "description": "List bots belonging to the connected Chatforma account so their IDs can be used in bot-scoped tools.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_list_dialog_messages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/dialog/messages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "dialog",
            "messages"
          ]
        },
        "description": "Return one page of messages exchanged in a specific user's bot dialog, with a cursor for continuing the history.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0,\n  \"user_id\": 0,\n  \"per_page\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_list_predefined_messages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/predefined/messages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "predefined",
            "messages"
          ]
        },
        "description": "List predefined messages configured in a bot so a message ID can be selected for sending.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_list_segments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/segments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "segments"
          ]
        },
        "description": "List the user segments configured for a bot, including segment IDs needed for targeted sends.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_list_users",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "users"
          ]
        },
        "description": "List a bot's users, members of one segment, or users with open dialogs; choose the view that matches the task.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"view\": \"\",\n  \"bot_id\": 0,\n  \"deleted\": false,\n  \"per_page\": 0,\n  \"segment_id\": \"\",\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_list_variables",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/variables",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "variables"
          ]
        },
        "description": "List variables configured for a bot, including IDs and types needed to read user-specific values.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_send_dialog_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/send/dialog/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "send",
            "dialog",
            "message"
          ]
        },
        "description": "Immediately send a user-visible text message into a specific user's bot dialog. This irreversible action may contact a real user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0,\n  \"message\": \"\",\n  \"user_id\": 0,\n  \"idempotency_key\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_send_predefined_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/send/predefined/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "send",
            "predefined",
            "message"
          ]
        },
        "description": "Send a configured bot message to one user or dispatch it to a segment. This irreversible action may contact one or many real users.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0,\n  \"run_at\": \"\",\n  \"message_id\": \"\",\n  \"segment_id\": \"\",\n  \"bot_user_id\": 0,\n  \"recipient_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "chatforma_send_text_dispatch",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/send/text/dispatch",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "send",
            "text",
            "dispatch"
          ]
        },
        "description": "Create a user-visible text dispatch for one bot user or a segment. Delivery may be immediate or scheduled where supported and cannot be undone through this API.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"bot_id\": 0,\n  \"run_at\": \"\",\n  \"content\": \"\",\n  \"segment_id\": \"\",\n  \"bot_user_id\": 0,\n  \"recipient_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}