# HelpSpot — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/help_spot

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_help_spot?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/help_spot/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/help_spot/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/help_spot/skill.md
Postman collection (v2.1): https://mcp.ai/help_spot/postman.json

## Tools
- help_spot_create_request(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) — Create a staff-side support request with an initial customer-visible or internal note. Configured HelpSpot automations may send notifications.
- help_spot_get_current_user() — Return the connected HelpSpot staff user's identity, defaults, and support capabilities without authentication tokens.
- help_spot_get_request(request_id: integer, include_history?: boolean, include_time_total?: boolean) — Return one support request with normalized history and optional time total; fail clearly when HelpSpot returns its sparse HTTP-200 missing-request shape.
- help_spot_list_filters() — List the connected staff user's saved and built-in queue filters, including symbolic selectors such as inbox and myq.
- help_spot_list_saved_responses(view?: string) — List reusable response templates available to the connected staff user, either all templates or the user's ten most-used templates.
- help_spot_list_support_options(active_only?: boolean, category_id?: integer, option_type: string) — List IDs and labels used to categorize, assign, route, or set the status of HelpSpot requests.
- help_spot_run_filter(cursor?: string, filter_id: string, page_size?: integer) — Return one cursor-controlled page of request summaries from a saved or built-in HelpSpot queue filter.
- help_spot_search_requests(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) — Search support requests by text, customer, state, assignment, or date and return one concise cursor-controlled page.
- help_spot_set_request_subscription(staff_id: integer, request_id: integer, subscribed: boolean) — Subscribe or unsubscribe a staff user from updates to one support request.
- help_spot_update_request(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) — Update request, customer, assignment, and state fields and optionally append one customer-visible or internal note. Configured HelpSpot notifications may be sent.

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

## Links
Docs: https://mcp.ai/docs/mcps/help_spot
Website: https://mcp.ai/mcps/help_spot