qrvote
QR-code contests, surveys, quizzes and scavenger hunts: read results, manage your own.
Should I use this
Quality & Safety
Findings (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainin draft_contest
- MEDIUMTool description contains URL to non-standard domainin add_judge
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"qrvote": {
"url": "https://mcp.qrvote.org/mcp/organizer"
}
}
}Remote endpoints
https://mcp.qrvote.org/mcp/organizerstreamable-httphttps://mcp.qrvote.org/mcpstreamable-httpWhat it can do
Tool inventory
Tools (14)
🟢draft_contest(kind, title, description, entries, questions, ...)
Make a link that opens qrvote’s create form already filled in: name, entries or questions, rules, closing time, look. Give the link to the person: they check it and click Create (it needs a human check). Nothing is created until they do. To manage it afterwards, they can connect you at https://mcp.qrvote.org/mcp/organizer.
Input Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"contest",
"survey",
"quiz",
"hunt"
],
"description": "contest: people vote for entries; survey: questions; quiz: questions with right answers and a leaderboard; hunt: find QR checkpoints"
},
"title": {
"type": "string",
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 1000
},
"entries": {
"type": "array",
"maxItems": 200,
"description": "Contests: the entries; hunts: the checkpoints. A name, or { name, description }.",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 80
},
"description": {
"type": "string",
"maxLength": 300
}
},
"required": [
"name"
]
}
]
}
},
"questions": {
"type": "array",
"maxItems": 50,
"description": "Surveys and quizzes, as in setQuestions: { type: single|multi|yesno|likert|rating|short|long, prompt, options? (single/multi), max? (rating 5 or 10), required?, answer? (quiz: option index, list of indexes, yesno 1/0, or accepted texts for short) }",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"single",
"multi",
"yesno",
"likert",
"rating",
"short",
"long"
]
},
"prompt": {
"type": "string",
"maxLength": 300
},
"options": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 20
},
"max": {
"type": "integer",
"enum": [
5,
10
]
},
"required": {
"type": "boolean"
},
"answer": {}
},
"required": [
"type",
"prompt"
]
}
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60
},
"maxItems": 20,
"description": "Contests: separate awards, one vote in each (e.g. Scariest, Funniest)"
},
"mode": {
"type": "string",
"enum": [
"single",
"each"
],
"description": "Contests: one vote in total, or one vote per entry (like/heart each)"
},
"results": {
"type": "string",
"enum": [
"live",
"after",
"private"
],
"description": "When people see results"
},
"closesAt": {
"type": "string",
"description": "When voting ends, ISO 8601 with a time zone offset"
},
"theme": {
"type": "string",
"enum": [
"classic",
"halloween",
"harvest",
"winter",
"garden",
"carnival",
"beach",
"sports",
"hearts",
"stars"
]
},
"leaderboard": {
"type": "boolean",
"description": "Quizzes: show a leaderboard"
},
"host": {
"type": "boolean",
"description": "Quizzes: run it live on a big screen, one question at a time"
}
},
"required": [
"kind",
"title"
],
"description": "What to fill the create form with. Same shapes as the API (https://qrvote.org/openapi.json)."
}🟡set_entry_photo(slug, entry, photo_url)
Give an entry (or hunt checkpoint) a photo from a public https image URL: JPEG, PNG or WebP, up to 3 MB. Hidden metadata (GPS, camera) is removed. Replaces any photo it had. Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$"
},
"entry": {
"type": "integer",
"description": "The entry’s id, from get_dashboard’s entrants"
},
"photo_url": {
"type": "string",
"pattern": "^https://",
"maxLength": 2000
}
},
"required": [
"slug",
"entry",
"photo_url"
]
}🟢get_campaign(slug)
A contest, survey or hunt as the public sees it Entries (contests), questions (surveys) or checkpoints (hunts; unfound ones show only their clue). Entry QR codes are never included when scanning is required. Public: no key needed.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
}
},
"required": [
"slug"
]
}🟢get_results(slug)
Results: vote tallies, survey totals, or a hunt leaderboard Public when the organizer made results visible; otherwise send the organizer key. Contests also return categoryResults (standings per award category) and, once voting has closed, judgeResults (each criterion averaged over the judges, summed). Written survey answers and individual judges' scores are never included here. Public; the organizer key also unlocks private results.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
}
},
"required": [
"slug"
]
}🟢get_dashboard(slug)
Everything on the organizer dashboard Settings, entries with vote counts, ballot tickets, fairness signals (grouped, hashed), and survey or hunt data. Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
}
},
"required": [
"slug"
]
}🟡update_settings(slug, title, description, results, allowChange, ...)
Change settings, or end / reopen voting Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
},
"title": {
"type": "string",
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 1000
},
"results": {
"type": "string",
"enum": [
"live",
"after",
"private"
]
},
"allowChange": {
"type": "boolean"
},
"requireBallot": {
"type": "boolean"
},
"ipLimit": {
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"opensAt": {
"type": [
"integer",
"null"
]
},
"closesAt": {
"type": [
"integer",
"null"
]
},
"categories": {
"type": "array",
"maxItems": 10,
"description": "Contests: award categories. Names (new) or {id, name} (keeps that category's votes when renaming). A category with votes can't be removed.",
"items": {
"oneOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string",
"maxLength": 40
}
}
}
]
}
},
"criteria": {
"type": "array",
"maxItems": 5,
"description": "Contests: what judges score, 1–10 each. Empty turns judging off.",
"items": {
"type": "string",
"maxLength": 30
}
},
"theme": {
"type": "string",
"description": "classic, halloween, harvest, winter, garden, carnival, beach, sports, hearts, stars, or custom:<accent hex>-<second hex> (e.g. custom:1a73e8-ff8a5b)",
"pattern": "^(classic|halloween|harvest|winter|garden|carnival|beach|sports|hearts|stars|custom:[0-9a-f]{6}-[0-9a-f]{6})$"
},
"closed": {
"type": "boolean",
"description": "true ends voting now; false reopens it"
}
},
"required": [
"slug"
]
}🟡add_judge(slug, name)
Contests: add a judge (judging must be on) The dashboard (getDashboard → judging.judges) then lists the judge with their private scorecard link key: https://qrvote.org/j/<slug>#<id>.<key>. Give it to that judge only. Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
},
"name": {
"type": "string",
"maxLength": 60
}
},
"required": [
"slug",
"name"
]
}🔴remove_judge(slug, id)
Contests: remove a judge, their link and their scores Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
},
"id": {
"type": "integer"
}
},
"required": [
"slug",
"id"
]
}🟡add_entries(slug, entrants)
Add entries (contests) or checkpoints (hunts) Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
},
"entrants": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 80
},
"description": {
"type": "string",
"maxLength": 300
}
}
}
}
},
"required": [
"slug",
"entrants"
]
}🟢export_csv(slug)
Download votes, survey responses or hunt players as CSV Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
}
},
"required": [
"slug"
]
}🟢list_responses(slug)
Survey responses, newest first (up to 500). Quizzes include each response's score. Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
}
},
"required": [
"slug"
]
}⚪host_step(slug, action)
Run a live quiz: start, reveal, next question, finish, or pause/resume its clock For quizzes with host = true. Body: { action: 'start' | 'reveal' | 'next' | 'finish' | 'pause' | 'resume' }. Steps must follow lobby → question → reveal → question … → done; anything else is 409. With hostSecs > 0 the quiz also moves on by itself (each question hostSecs seconds, each answer shown 8 s); pause/resume stop and restart that clock, and a step by hand restarts it. Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
},
"action": {
"type": "string",
"enum": [
"start",
"reveal",
"next",
"finish",
"pause",
"resume"
]
}
},
"required": [
"slug",
"action"
]
}🟡set_questions(slug, questions)
Surveys and quizzes: replace the questions (only until the first response) Body: { questions: [...] }, 1–50, in order; the whole list is replaced. Each: { type, prompt (≤300 chars), required?, options?, max?, answer?, id? }. type is single (pick one) or multi (pick any) with options (2–20 distinct texts), yesno, likert (disagree…agree), rating (max 5 or 10 stars), short or long (written). Quizzes: answer is the correct option index (single; yesno uses 1 = yes, 0 = no), a list of option indexes (multi), or a list of accepted texts (short); at least one question needs one. Send a question's id back to keep its picture. Refused with 409 once anyone has answered; the answer key can still be fixed with setAnswerKey. Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
},
"questions": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"single",
"multi",
"yesno",
"likert",
"rating",
"short",
"long"
]
},
"prompt": {
"type": "string",
"maxLength": 300
},
"required": {
"type": "boolean"
},
"options": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 20
},
"max": {
"type": "integer",
"enum": [
5,
10
]
},
"answer": {},
"id": {
"type": "integer"
}
},
"required": [
"type",
"prompt"
]
}
}
},
"required": [
"slug",
"questions"
]
}🟡set_answer_key(slug, answers)
Fix a quiz's answer key (allowed after people have answered; every score updates) Body: { answers: { <question id>: key | null } }. The key is an option index (single; yes/no uses 1 = yes, 0 = no), a list of option indexes (multi, all must match), or a list of accepted texts (short; case, accents and punctuation are ignored). null stops scoring that question. At least one question must stay scored. Needs the organizer key.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "The id in the public link, e.g. `scarecrow-contest-2026-ab12` from https://qrvote.org/c/scarecrow-contest-2026-ab12"
},
"answers": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"slug",
"answers"
]
}Community
Evidence