# Retently — how to use (mcp.ai)

Connect your Retently account and use 15 tools for forms and surveys straight from your AI agent. Connect with your own API key. Retently is a customer experience management platform that enables businesses to collect, analyze, and act on customer feedback through surveys and integrations.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/retently/add/feedback/tags` — Add tags to feedback items by providing feedback IDs and corresponding tags.
  - body: { id: string, op?: string, tags: string[] }
- `POST https://api.mcp.ai/api/retently/add/feedback/topics` — Add topics to feedback items by providing feedback IDs and corresponding topics.
  - body: { topics: object[], operation?: string, feedback_id: string }
- `POST https://api.mcp.ai/api/retently/create/or/update/customers` — Tool to create new customers or update existing ones by providing their details, including email, name, company, tags, and properties. Use this to manage your customer base in Retently.
  - body: { subscribers: object[] }
- `POST https://api.mcp.ai/api/retently/delete/customers` — Delete customers from the workspace by providing their unique IDs.
  - body: { subscribers: object[] }
- `POST https://api.mcp.ai/api/retently/get/campaigns` — Tool to retrieve a list of campaigns associated with the account. Use when you need to get details about all campaigns.
- `POST https://api.mcp.ai/api/retently/get/customer/by/id` — Tool to retrieve detailed information about a specific customer by their unique ID. Use when you need to get all the details of a customer.
  - body: { customer_id: string }
- `POST https://api.mcp.ai/api/retently/get/customers` — Retrieve a list of customers with optional parameters for pagination, sorting, and filtering by email or date range.
  - body: { page?: integer, sort?: string, email?: string, limit?: integer, endDate?: string, startDate?: string }
- `POST https://api.mcp.ai/api/retently/get/feedback` — Tool to retrieve feedback received from customers. Use when you need to get a list of feedback, with optional parameters for pagination and sorting.
  - body: { page?: integer, sort?: string, email?: string, limit?: integer, endDate?: string, startDate?: string, campaignId?: string, customerId?: string }
- `POST https://api.mcp.ai/api/retently/get/feedback/by/id` — Tool to retrieve detailed information about specific feedback by its unique ID. Use when you need to get the details of a single feedback entry.
  - body: { feedback_id: string }
- `POST https://api.mcp.ai/api/retently/get/latest/score` — Tool to retrieve the latest NPS score for the account. Use when you need to get the most up-to-date NPS score.
- `POST https://api.mcp.ai/api/retently/get/outbox` — Retrieve the outbox of surveys that are scheduled to be sent.
  - body: { page?: integer, sort?: string, email?: string, limit?: integer }
- `POST https://api.mcp.ai/api/retently/get/reports` — Tool to retrieve reports related to NPS surveys, including scores and trends. Use when you need to get campaign performance data.
  - body: { end_date?: string, start_date?: string, campaign_id?: string }
- `POST https://api.mcp.ai/api/retently/get/templates` — Tool to retrieve a list of survey templates available in the account. Use when you need to get the available survey templates.
- `POST https://api.mcp.ai/api/retently/send/transactional/survey` — Tool to send a transactional survey to customers. Use when you need to send a survey to a customer after a specific event, with an optional delay.
  - body: { delay?: integer, campaign_id: string, subscribers: object[] }
- `POST https://api.mcp.ai/api/retently/unsubscribe/customers` — Unsubscribe customers from receiving surveys by providing their email addresses.
  - body: { message?: string, subscribers: object[] }

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

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