Simplesat MCP server
17 operations0 webhooks
Customer feedback from Simplesat - manage customers and team members, list surveys and questions, search and read responses and answers, correct an answer, and send a survey by email.
Try Simplesat with your agent
Connect Simplesat, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Simplesat on my account, then run one read-only example and show me the result.
Simplesat tools and triggers
Tools are what your agent can do in Simplesat through Corsair's MCP server. Triggers are the Simplesat events a routine can start from.
Customers
- BulkWrite
Queue many customer upserts in one request. The answer carries a request_id rather than the stored records, because the write is queued
customers.bulk
- CreateWrite
Create or update a customer. Simplesat matches on external_id or email, so it is an upsert rather than a plain create
customers.create
- GetRead-only
Read one customer by their Simplesat id, with their tags and custom attributes
customers.get
- ListRead-only
List customers with filters for when they were created or modified and whether they are subscribed; follow `next` for the following page
customers.list
- UpdateWrite
Update one customer by their Simplesat id, replacing the fields sent
customers.update
Responses
- CreateWrite
Create a response, or update the one that already matches it. `created` backdates it, which is how a survey answered elsewhere is imported
responses.create
- GetRead-only
Read one response with its survey, customer, answers and team members
responses.get
- SearchRead-only
Search responses by date range and filters such as customer email, with each response's answers and team members
responses.search
- UpdateWrite
Update one response by id. The body takes the same shape as a create, so the whole response is sent back
responses.update
Answers
- GetRead-only
Read one answer with its question, chosen option, sentiment and comment
answers.get
- SearchRead-only
Search answers by date range and filters such as sentiment, across every survey
answers.search
- UpdateWrite
Change an answer's chosen option, comment or sentiment. The question and survey it belongs to are fixed
answers.update
Surveys
- EmailDestructive
Send a survey to one customer by email. This notifies a real person, and the survey is identified by its token
surveys.email
- ListRead-only
List the surveys on the account with their metric, type and survey_token
surveys.list
Team Members
- CreateWrite
Create or update a team member, which is how a response is attributed to the person who handled it
teamMembers.create
- GetRead-only
Read one team member with their groups and custom attributes
teamMembers.get
Questions
- ListRead-only
List the questions behind the surveys, filtered by survey or metric, with their types and choices
questions.list
Connect Simplesat to Claude, ChatGPT or Cursor
- 1
Connect Simplesat in Corsair
Add your Simplesat API key once in Corsair. Corsair stores the credential encrypted and makes the Simplesat API calls for your agent, so it never goes into a prompt or a config file. Connect Simplesat
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Simplesat. On a ChatGPT personal plan, connect Simplesat here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Simplesat's read and write operations run right away and its 1 destructive operation waits for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/simplesat, add the Simplesat plugin, and connect with an API key. Then call methods like corsair.simplesat.api.answers.get() from your app. Corsair keeps each tenant isolated.
Yes. Simplesat requires an API key from your Simplesat account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Simplesat, GitHub, Notion, Stripe, and the rest. Trigger Simplesat from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for customer feedback from Simplesat - manage customers and team members, list surveys and questions, search and read responses and answers, correct an answer, and send a survey by email. Common builds include sync jobs, admin tooling, and agents that call Simplesat APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Simplesat API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/simplesat in the open repo. When Simplesat ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Simplesat data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Simplesat data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Simplesat on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 1 destructive Simplesat operation. You can change a link's mode at hub.corsair.dev/me.