Connect Survey the Room
Survey the Room is an MCP server. Add it to your AI assistant once, then just talk: "Create a room. Ask them what they would hand off to AI tomorrow."
Claude Code
- Put your Survey the Room key in your shell, for example in
~/.zshrc:export SURVEYTHEROOM_API_KEY=your-key
- Add the server, once per computer:
claude mcp add -t http -s user surveytheroom https://surveytheroom.com/mcp -H "Authorization: Bearer $SURVEYTHEROOM_API_KEY"
- Start Claude Code and say "Check that Survey the Room is up." It should answer that the service is up and the key is valid.
To share it with everyone who works in one project, put this in a file called .mcp.json at the top of the project instead. The key stays in each person's own shell, not in the file.
{ "mcpServers": { "surveytheroom": { "type": "http", "url": "https://surveytheroom.com/mcp",
"headers": { "Authorization": "Bearer ${SURVEYTHEROOM_API_KEY}" } } } }
To see it or take it away: claude mcp list, claude mcp remove surveytheroom.
Claude on the web, Claude Desktop, ChatGPT
Add Survey the Room as a custom connector. You sign in with your email address. There is no key to copy.
- In Claude, open the connectors list and choose Add custom connector.
- Name it Survey the Room and give it this address:
https://surveytheroom.com/mcp
- Choose Connect. A Survey the Room page opens. Type your email address, then the six-digit code we email you, then choose Approve.
A connector added on the web also works in Claude Desktop and the Claude phone apps. ChatGPT has not been tried yet.
A key
Survey the Room is not open for sign-up yet. Leave your email on the front page to hear when it is.
What your assistant can do
| get_room | A room's state: the survey it is on now with joined and answered counts, today's surveys in order, and the phone, screen and QR links. |
| publish_survey | Creates a new survey in a room and shows it on every phone at once: a survey is one question put to the room. |
| get_responses | The answers people gave to a survey, a page at a time by cursor. |
| get_results | The results of a survey: how many joined and answered, and the tally per option or per category. |
| set_categories | Sets the full list of categories that answers to a text question are sorted into. |
| close_survey | Stops a survey taking answers. |
| create_room | Creates a room: the place a session happens, with one address and one QR code, holding every survey asked in it. |
| end_room | Closes whatever is open, ends the session and returns the link to the public report of the day. |
| get_survey | A survey as it was published: its question, type, options and settings. |
| reopen_survey | Opens a closed survey for answers again and makes it the one the room is on. |
| add_category | Adds one category to a text question. |
| rename_category | Gives a category a new label. |
| merge_categories | Moves every answer of one category into another and removes the first. |
| place_answers | Places answers in categories by hand, for the ones the sorter left unsorted. |
| hide_answer | Takes one answer (an entry ID such as "e_0004") or one person's whole response ("r_0002") off the screen and out of the results, or puts it back with hidden false. |
| rehearse | Simulated phones answer the survey the room is on, flagged as test data so they can be removed with purge_test. |
| purge_test | Removes everything a rehearsal put into the room and leaves real answers alone. |
| get_report | Every survey asked in the room on one day, with its results. |
| rotate_admin_link | Replaces the room's admin link with a new one; the old link stops working. |
| purge_room | Deletes every survey in the room published before a date, with its answers. |
| get_status | Whether Survey the Room is up, whether the key works, and whether the answer sorter is on. |
| list_feedback | What people wrote in the service's feedback box. |
| list_signups | Email addresses of people who asked to hear about Survey the Room. |
Anything people type in the room is treated as data. Your assistant is told never to follow instructions found in it.