{
  "info": {
    "name": "Helpdesk — mcp.ai",
    "description": "REST API for the Helpdesk 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/helpdesk",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "helpdesk_list_agents",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/agents",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "agents"
          ]
        },
        "description": "Retrieves all support agents (team members) in the HelpDesk account. Use this action to get a complete list of agents with their details including: - Agent profiles (name, email, avatar, job title) - ",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_canned_responses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/canned/responses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "canned",
            "responses"
          ]
        },
        "description": "Tool to list canned responses. Use when you need to retrieve all predefined reply templates for tickets.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_custom_fields",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/custom/fields",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "custom",
            "fields"
          ]
        },
        "description": "Tool to list all custom fields defined in the account. Use when you need to view or manage custom fields. Only callable after authentication.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_email_domains",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/email/domains",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "email",
            "domains"
          ]
        },
        "description": "Lists all email domains configured for the HelpDesk account. Returns a comprehensive list of all email domains set up in the HelpDesk account, including domain names, verification status, DNS records,",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_licenses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/licenses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "licenses"
          ]
        },
        "description": "Retrieves all licenses (account configurations) for the authenticated HelpDesk account. A license represents a customer account and contains subscription information, global settings, default team/tem",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_reply_addresses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/reply/addresses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "reply",
            "addresses"
          ]
        },
        "description": "Lists all reply addresses configured in the HelpDesk account. Reply addresses are email addresses used to receive and respond to support tickets. Each reply address must be associated with a verified ",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_rules",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/rules",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "rules"
          ]
        },
        "description": "Tool to retrieve a list of rules configured in the account. Use after authentication when you need an overview of all automation rules.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_subscriptions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/subscriptions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "subscriptions"
          ]
        },
        "description": "Lists all billing subscriptions for the HelpDesk account, including active, expired, canceled, and future subscriptions. Subscriptions represent the currently selected plan (team or enterprise) and nu",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"state\": \"\",\n  \"plan_codes\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_teams",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/teams",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "teams"
          ]
        },
        "description": "Lists all teams in the HelpDesk account. Returns a comprehensive list of all teams configured in the HelpDesk account, including team IDs, names, settings, reply addresses, and integration configurati",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_tickets",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/tickets",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "tickets"
          ]
        },
        "description": "List all tickets from a specified silo with cursor-based pagination support. This tool retrieves tickets from the helpdesk system with flexible sorting and pagination. Use this when you need to retrie",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"silo\": \"\",\n  \"order\": \"\",\n  \"sortBy\": \"\",\n  \"next.ID\": \"\",\n  \"prev.ID\": \"\",\n  \"pageSize\": 0,\n  \"next.value\": \"\",\n  \"prev.value\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_trusted_emails",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/trusted/emails",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "trusted",
            "emails"
          ]
        },
        "description": "Tool to retrieve a list of trusted email addresses or domains. Use when managing your spam whitelist after authenticating.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_views",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/views",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "views"
          ]
        },
        "description": "Tool to list agent views. Use when you need to retrieve saved ticket views after authentication.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_list_webhooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "webhooks"
          ]
        },
        "description": "Lists all configured webhooks for the HelpDesk account. Webhooks allow you to receive real-time notifications about ticket events (creation, updates, status changes, assignments, etc.) sent as HTTP PO",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "helpdesk_view_agent",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/view/agent",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "view",
            "agent"
          ]
        },
        "description": "Retrieves comprehensive details for a specific agent in the HelpDesk system. Returns complete agent information including profile details, role assignments, team memberships, status, settings, and sig",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"agentID\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}