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

  1. Put your Survey the Room key in your shell, for example in ~/.zshrc:
    export SURVEYTHEROOM_API_KEY=your-key
  2. Add the server, once per computer:
    claude mcp add -t http -s user surveytheroom https://surveytheroom.com/mcp -H "Authorization: Bearer $SURVEYTHEROOM_API_KEY"
  3. 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.

  1. In Claude, open the connectors list and choose Add custom connector.
  2. Name it Survey the Room and give it this address:
    https://surveytheroom.com/mcp
  3. 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_roomA 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_surveyCreates a new survey in a room and shows it on every phone at once: a survey is one question put to the room.
get_responsesThe answers people gave to a survey, a page at a time by cursor.
get_resultsThe results of a survey: how many joined and answered, and the tally per option or per category.
set_categoriesSets the full list of categories that answers to a text question are sorted into.
close_surveyStops a survey taking answers.
create_roomCreates a room: the place a session happens, with one address and one QR code, holding every survey asked in it.
end_roomCloses whatever is open, ends the session and returns the link to the public report of the day.
get_surveyA survey as it was published: its question, type, options and settings.
reopen_surveyOpens a closed survey for answers again and makes it the one the room is on.
add_categoryAdds one category to a text question.
rename_categoryGives a category a new label.
merge_categoriesMoves every answer of one category into another and removes the first.
place_answersPlaces answers in categories by hand, for the ones the sorter left unsorted.
hide_answerTakes 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.
rehearseSimulated phones answer the survey the room is on, flagged as test data so they can be removed with purge_test.
purge_testRemoves everything a rehearsal put into the room and leaves real answers alone.
get_reportEvery survey asked in the room on one day, with its results.
rotate_admin_linkReplaces the room's admin link with a new one; the old link stops working.
purge_roomDeletes every survey in the room published before a date, with its answers.
get_statusWhether Survey the Room is up, whether the key works, and whether the answer sorter is on.
list_feedbackWhat people wrote in the service's feedback box.
list_signupsEmail 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.