qrvote

QR-code contests, surveys, quizzes and scavenger hunts: read results, manage your own.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
94%
Calidad de los nombres
97%
Riesgo de envenenamiento
60%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (3)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains URL to non-standard domainen draft_contest
  • MEDIUMTool description contains URL to non-standard domainen add_judge

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~3,771Tokens (definiciones de herramientas)
~1.6 KBTamaño de respuesta típico
Impacto significativo en la atención (2.95% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "qrvote": {
      "url": "https://mcp.qrvote.org/mcp/organizer"
    }
  }
}

Puntos de conexión remotos

https://mcp.qrvote.org/mcp/organizerstreamable-http
https://mcp.qrvote.org/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (14)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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"
  ]
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada14 herramientas