# Simplesat — how to use (mcp.ai)

Connect your Simplesat account and use 9 tools for CRM straight from your AI agent. Connect with your own API key. Simplesat captures customer feedback and CSAT scores through surveys, integrating directly with helpdesk systems for real-time performance insights.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/simplesat/create/or/update/customer2` — Tool to create a new customer or update an existing customer if one already exists with the same email. Use when you need to add or modify customer information including name, email, company, tags, ex
  - body: { name?: string, tags?: string[], email: string, company?: string, external_id?: string, custom_attributes?: object }
- `POST https://api.mcp.ai/api/simplesat/create/or/update/team/member` — This tool creates a new team member or updates an existing one if a team member with the same email address is found. It is an independent action that requires only basic team member information (emai
  - body: { email: string, phone?: string, title?: string, last_name: string, first_name: string }
- `POST https://api.mcp.ai/api/simplesat/get/customer` — Tool to retrieve a single customer by their Simplesat ID. Returns customer details including name, email, company, tags, and custom attributes.
  - body: { id: string }
- `POST https://api.mcp.ai/api/simplesat/list/answers` — Tool to fetch a list of all answers from Simplesat. Returns answers with detailed question, customer, ticket, and team member information. Supports filtering by modified date and pagination. Note: Thi
  - body: { page?: integer, page_size?: integer, modified__gte?: string, modified__lte?: string }
- `POST https://api.mcp.ai/api/simplesat/list/questions` — Tool to retrieve a paginated list of all questions in Simplesat. Use when you need to fetch question details including order, metric type, text, rating scale, choices, and conditional rules. Supports 
  - body: { page?: integer, metric?: string, page_size?: integer, survey_id?: integer }
- `POST https://api.mcp.ai/api/simplesat/list/surveys` — Tool to list all surveys in the Simplesat account. Returns survey details including id, name, and metric type (CSAT, NPS, CES). Use when you need to retrieve available surveys or find a specific surve
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/simplesat/search/answers` — Tool to search and retrieve answers from Simplesat with advanced filtering. Use when you need to find specific answers based on filters like date range, choice value, sentiment, survey, customer, or c
  - body: { page?: integer, filters?: object[], end_date?: string, operator?: string, page_size?: integer, start_date?: string }
- `POST https://api.mcp.ai/api/simplesat/search/responses` — Tool to search and retrieve responses from Simplesat by applying specific filters. Returns all responses from the last 30 days by default if no date range is specified. Supports filtering by date rang
  - body: { page?: integer, filters?: object[], end_date?: string, operator?: string, page_size?: integer, start_date?: string }
- `POST https://api.mcp.ai/api/simplesat/update/customer` — Tool to update an existing customer by their Simplesat ID. Use when you need to modify customer information such as name, email, company, external ID, tags, or custom attributes.
  - body: { id: string, name?: string, tags?: string[], email?: string, company?: string, external_id?: integer, custom_attributes?: object }

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

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