Example prompts

Once the plugin is installed and connected, just describe what you want in plain language — Claude Code picks the right MCP tool for the job. The prompts below map to real tools exposed by @oratora/mcp.

Check the connection

Who am I connected to on Oratora, and what's on my plan?

Calls whoami — confirms the API key works and shows entitlements (for example, whether quizzes or team mode are available on your plan). It's worth running once after setup.

Forms

Build a hackathon feedback form — a rating, what to improve, and email.

Create a form from the "survey" template, then list my forms.

Add an email field to my "Hackathon feedback" form and publish it.

How many responses did my feedback form get, and what's the breakdown?

Turn my "Onboarding" form into a multistep wizard, with a section break before the contact fields.

Close the "Q3 survey" form so it stops accepting responses.

These map to create_form, list_forms, get_form, add_form_field, update_form_settings, publish_form, get_form_responses, update_form, update_form_field, remove_form_field, reorder_form_fields, close_form and delete_form. create_form understands templates such as survey, contact, rsvp, lead, quiz, poll, the hackathon (hack-*), retro (retro-*) and HR-pulse (pulse-*) templates, and can publish in the same call.

Editing a form you already made works the same way — just ask. Claude reads the current form first (get_form) to find the right field, then adds, edits, removes, or reorders fields, updates the title or settings, and re-publishes. Editing a single field replaces that field's configuration, so Claude keeps the parts you didn't ask to change. Deleting a form (or a field) is permanent, so Claude confirms before doing it.

Live sessions, quizzes and games

Make a 5-question JavaScript quiz and open it.

Create a live session named "Team standup" with a word cloud asking what people are working on, and open it.

Add a poll to my "Team standup" session asking which framework the team should pick.

List my sessions and their join codes.

Turn on team mode for my "Trivia night" session and add two teams, Red and Blue.

Present the quiz activity in my running session, then end the session when it's done.

Build a workshop kickoff: an intro slide, an agenda slide with 4 bullets, then a warm-up poll.

These map to create_session, open_session, add_activity, list_sessions, set_team_mode, add_team, list_teams, remove_team, present_activity and end_session. Sessions can run live (host-driven) or self_paced (async); quizzes require the scoring entitlement, which whoami will confirm.

Multi-round series

Set up a 3-round trivia league with two teams, Red and Blue.

List my series and their join codes.

A series is an event whose score carries across several rounds (each round is a session). These map to create_series and list_series — create_series can seed the competing teams and the round line-up in one call. You then build and run each round from the dashboard, where the running leaderboard carries across rounds. Series require the series entitlement, which whoami will confirm.

Sponsor reports

Make a sponsor report for Acme covering last quarter.

List the sponsor reports I've generated.

A sponsor report is a generated rollup of participation and engagement across your events, shared at a public URL you can send to a sponsor. These map to create_sponsor_report (optionally scoped to a start/end window; omit both for an all-time rollup) and list_sponsor_reports. Sponsor reports require the data export & analytics entitlement, which whoami will confirm.