# Delighted — how to use (mcp.ai)

Connect your Delighted account and use 13 tools for forms and surveys straight from your AI agent. Connect with your own API key. Delighted uses the Net Promoter System® to gather real feedback from your customers, in minutes, not weeks. No technical knowledge required.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_delighted?ms=1787291280000`
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. `delighted_add_person_to_autopilot_email`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/delighted`
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/delighted/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/delighted/add/person/to/autopilot/email` — Add a person to Autopilot email or update their properties. Autopilot automatically schedules and sends recurring email surveys at the frequency configured in your Delighted account settings. Use this
  - body: { person_id?: string, properties?: object, person_name?: string, person_email: string, person_phone_number?: string }
- `POST https://api.mcp.ai/api/delighted/add/person/to/autopilot/sms` — Tool to add a person to Autopilot or update their properties for SMS-based surveys. Use when you need to schedule automated survey delivery via SMS. Prerequisites: SMS Autopilot must be configured in 
  - body: { person_id?: string, properties?: object, person_name?: string, person_email?: string, person_phone_number: string }
- `POST https://api.mcp.ai/api/delighted/create/person` — Tool to create or update a person and schedule a survey email. Use when you need to add a new person to Delighted, update existing person details, or schedule a survey with custom properties for segme
  - body: { name?: string, send?: boolean, delay?: integer, email?: string, channel?: string, properties?: object, email_update?: string, last_sent_at?: integer, phone_number?: string, phone_number_update?: string }
- `POST https://api.mcp.ai/api/delighted/delete/pending/survey/requests` — Tool to remove all pending (scheduled but not yet sent) survey requests for a person. Use when you need to cancel all future surveys for a specific email address.
  - body: { person_email: string }
- `POST https://api.mcp.ai/api/delighted/delete/person` — Tool to remove a person and all associated data from Delighted. Use when you need to permanently delete a person's information. Deletion includes surveys, responses, properties, Autopilot membership, 
  - body: { person_identifier: string }
- `POST https://api.mcp.ai/api/delighted/get/autopilot/email/configuration` — Tool to retrieve the current Autopilot configuration for email distribution. Returns configuration details including whether Autopilot is active, survey frequency, and timestamps.
- `POST https://api.mcp.ai/api/delighted/get/autopilot/sms/configuration` — Tool to retrieve the current Autopilot configuration for SMS distribution. Use when you need to check whether Autopilot is enabled, review survey frequency settings, or examine configuration timestamp
- `POST https://api.mcp.ai/api/delighted/list/autopilot/sms/memberships` — Tool to retrieve all Autopilot memberships for SMS distribution platform. Use when you need to list people enrolled in Autopilot SMS or filter by specific person details.
  - body: { per_page?: integer, person_id?: string, person_email?: string, person_phone_number?: string }
- `POST https://api.mcp.ai/api/delighted/list/bounced/people` — Tool to retrieve all bounced people for your account, ordered by bounce time (oldest first). Use when you need to identify email addresses that have bounced. Supports pagination via per_page and page 
  - body: { page?: integer, since?: integer, until?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/delighted/list/people` — Tool to retrieve all people for your account in creation order. Use when you need to list contacts, filter by email or phone number, or paginate through your people database. Supports cursor-based pag
  - body: { email?: string, since?: integer, until?: integer, per_page?: integer, page_info?: string, phone_number?: string }
- `POST https://api.mcp.ai/api/delighted/list/survey/responses` — Tool to retrieve all survey responses for your account with pagination support and optional filtering. Use when you need to access survey feedback data, filter by date range, trend, person, or sort by
  - body: { page?: integer, order?: string, since?: integer, trend?: string, until?: integer, expand?: string[], per_page?: integer, person_id?: string, person_email?: string, updated_since?: integer, updated_until?: integer }
- `POST https://api.mcp.ai/api/delighted/list/unsubscribed/people` — Tool to retrieve all unsubscribed people for your account, ordered by unsubscribe time (oldest first). Use when you need to identify people who have unsubscribed. Supports pagination via per_page and 
  - body: { page?: integer, since?: integer, until?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/delighted/unsubscribe/person` — Tool to add a person to your unsubscribe list, preventing them from receiving any future surveys via email. Use when you need to permanently unsubscribe someone from all email surveys. This is functio
  - body: { person_email: string }

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

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