{
  "info": {
    "name": "HelpSpot — mcp.ai",
    "description": "REST API for the HelpSpot 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/help_spot",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "help_spot_create_request",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/request",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "request"
          ]
        },
        "description": "Create a staff-side support request with an initial customer-visible or internal note. Configured HelpSpot automations may send notifications.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"note\": \"\",\n  \"title\": \"\",\n  \"is_open\": false,\n  \"is_urgent\": false,\n  \"portal_id\": 0,\n  \"status_id\": 0,\n  \"category_id\": 0,\n  \"customer_id\": \"\",\n  \"custom_fields\": \"\",\n  \"customer_email\": \"\",\n  \"customer_phone\": \"\",\n  \"note_visibility\": \"\",\n  \"assigned_staff_id\": 0,\n  \"customer_last_name\": \"\",\n  \"customer_first_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_get_current_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/current/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "current",
            "user"
          ]
        },
        "description": "Return the connected HelpSpot staff user's identity, defaults, and support capabilities without authentication tokens.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_get_request",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/request",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "request"
          ]
        },
        "description": "Return one support request with normalized history and optional time total; fail clearly when HelpSpot returns its sparse HTTP-200 missing-request shape.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request_id\": 0,\n  \"include_history\": false,\n  \"include_time_total\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_list_filters",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/filters",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "filters"
          ]
        },
        "description": "List the connected staff user's saved and built-in queue filters, including symbolic selectors such as inbox and myq.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_list_saved_responses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/saved/responses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "saved",
            "responses"
          ]
        },
        "description": "List reusable response templates available to the connected staff user, either all templates or the user's ten most-used templates.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"view\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_list_support_options",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/support/options",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "support",
            "options"
          ]
        },
        "description": "List IDs and labels used to categorize, assign, route, or set the status of HelpSpot requests.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"active_only\": false,\n  \"category_id\": 0,\n  \"option_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_run_filter",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/run/filter",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "run",
            "filter"
          ]
        },
        "description": "Return one cursor-controlled page of request summaries from a saved or built-in HelpSpot queue filter.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"cursor\": \"\",\n  \"filter_id\": \"\",\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_search_requests",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/requests",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "requests"
          ]
        },
        "description": "Search support requests by text, customer, state, assignment, or date and return one concise cursor-controlled page.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"match\": \"\",\n  \"query\": \"\",\n  \"cursor\": \"\",\n  \"is_open\": false,\n  \"page_size\": 0,\n  \"status_id\": 0,\n  \"request_id\": 0,\n  \"category_id\": 0,\n  \"customer_id\": \"\",\n  \"closed_after\": 0,\n  \"opened_after\": 0,\n  \"closed_before\": 0,\n  \"opened_before\": 0,\n  \"relative_date\": \"\",\n  \"customer_email\": \"\",\n  \"customer_phone\": \"\",\n  \"assigned_staff_id\": 0,\n  \"customer_last_name\": \"\",\n  \"include_time_total\": false,\n  \"customer_first_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_set_request_subscription",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/set/request/subscription",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "set",
            "request",
            "subscription"
          ]
        },
        "description": "Subscribe or unsubscribe a staff user from updates to one support request.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"staff_id\": 0,\n  \"request_id\": 0,\n  \"subscribed\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "help_spot_update_request",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/request",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "request"
          ]
        },
        "description": "Update request, customer, assignment, and state fields and optionally append one customer-visible or internal note. Configured HelpSpot notifications may be sent.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"note\": \"\",\n  \"title\": \"\",\n  \"is_open\": false,\n  \"is_urgent\": false,\n  \"status_id\": 0,\n  \"request_id\": 0,\n  \"category_id\": 0,\n  \"customer_id\": \"\",\n  \"custom_fields\": \"\",\n  \"customer_email\": \"\",\n  \"customer_phone\": \"\",\n  \"note_visibility\": \"\",\n  \"assigned_staff_id\": 0,\n  \"customer_last_name\": \"\",\n  \"customer_first_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}