# HelpSpot — how to use (mcp.ai)

Connect your HelpSpot account and use 10 tools for customer support straight from your AI agent. Connect with your own API key. HelpSpot is a customer support platform for managing requests, staff workflows, time tracking, saved responses, reports, and help desk metadata.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_help_spot?ms=1787293380000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `help_spot_create_request`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/help_spot`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/help_spot/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/help_spot/create/request` — Create a staff-side support request with an initial customer-visible or internal note. Configured HelpSpot automations may send notifications.
  - body: { note: string, title?: string, is_open?: boolean, is_urgent?: boolean, portal_id?: integer, status_id?: integer, category_id: integer, customer_id?: string, custom_fields?: object[], customer_email?: string, customer_phone?: string, note_visibility?: string, assigned_staff_id?: integer, customer_last_name?: string, customer_first_name?: string }
- `POST https://api.mcp.ai/api/help_spot/get/current/user` — Return the connected HelpSpot staff user's identity, defaults, and support capabilities without authentication tokens.
- `POST https://api.mcp.ai/api/help_spot/get/request` — Return one support request with normalized history and optional time total; fail clearly when HelpSpot returns its sparse HTTP-200 missing-request shape.
  - body: { request_id: integer, include_history?: boolean, include_time_total?: boolean }
- `POST https://api.mcp.ai/api/help_spot/list/filters` — List the connected staff user's saved and built-in queue filters, including symbolic selectors such as inbox and myq.
- `POST https://api.mcp.ai/api/help_spot/list/saved/responses` — List reusable response templates available to the connected staff user, either all templates or the user's ten most-used templates.
  - body: { view?: string }
- `POST https://api.mcp.ai/api/help_spot/list/support/options` — List IDs and labels used to categorize, assign, route, or set the status of HelpSpot requests.
  - body: { active_only?: boolean, category_id?: integer, option_type: string }
- `POST https://api.mcp.ai/api/help_spot/run/filter` — Return one cursor-controlled page of request summaries from a saved or built-in HelpSpot queue filter.
  - body: { cursor?: string, filter_id: string, page_size?: integer }
- `POST https://api.mcp.ai/api/help_spot/search/requests` — Search support requests by text, customer, state, assignment, or date and return one concise cursor-controlled page.
  - body: { match?: string, query?: string, cursor?: string, is_open?: boolean, page_size?: integer, status_id?: integer, request_id?: integer, category_id?: integer, customer_id?: string, closed_after?: integer, opened_after?: integer, closed_before?: integer, opened_before?: integer, relative_date?: string, customer_email?: string, customer_phone?: string, assigned_staff_id?: integer, customer_last_name?: string, include_time_total?: boolean, customer_first_name?: string }
- `POST https://api.mcp.ai/api/help_spot/set/request/subscription` — Subscribe or unsubscribe a staff user from updates to one support request.
  - body: { staff_id: integer, request_id: integer, subscribed: boolean }
- `POST https://api.mcp.ai/api/help_spot/update/request` — Update request, customer, assignment, and state fields and optionally append one customer-visible or internal note. Configured HelpSpot notifications may be sent.
  - body: { note?: string, title?: string, is_open?: boolean, is_urgent?: boolean, status_id?: integer, request_id: integer, category_id?: integer, customer_id?: string, custom_fields?: object[], customer_email?: string, customer_phone?: string, note_visibility?: string, assigned_staff_id?: integer, customer_last_name?: string, customer_first_name?: string }

## Example prompts
- "What can I do in HelpSpot?"
- "Show me a summary of my HelpSpot account"

## More
- Page: https://mcp.ai/help_spot
- Agent spec (llms.txt): https://mcp.ai/help_spot/llms.txt
- Postman collection: https://mcp.ai/help_spot/postman.json