# Quiz Maker — MCP tool `findutils:quiz_maker`

Build a quiz from multiple-choice, true/false and open-ended questions and return the numbered quiz, an answer key (with model answers for open-ended questions), a printable plain-text sheet, Markdown, and (when answers are given) the graded score with per-question results. Open-ended answers are graded only through `marks`.

- Category: education
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/quiz-maker/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/quiz-maker/
- Same tool on the other surface: https://findutils.com/api/quiz-maker/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "quiz_maker",
      "arguments": {
        "questions": [
          {
            "question": "Capital of France?",
            "options": [
              "Berlin",
              "Madrid",
              "Paris"
            ],
            "correct_index": 2
          }
        ]
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `questions` | array | yes | Questions: { type?: "multiple_choice" \| "true_false" \| "open_ended" (default multiple_choice), question, options (2–10 strings; true/false defaults to ["True","False"]; not used for open_ended), correct_index (0-based; not used for open_ended), model_answer (open_ended only, optional) }. |
| `title` | string | no | Quiz title. Default "Quiz Maker". |
| `answers` | array | no | Optional answer per question, null for unanswered: the chosen option index (0-based) for a choice question, the written response for an open-ended one. When given, the quiz is graded. |
| `marks` | array | no | Optional verdict per question for open-ended answers (true = right, false = wrong, null = not marked yet). Ignored for choice questions, which grade themselves. |

Example arguments (verified):

```json
{
  "questions": [
    {
      "question": "Capital of France?",
      "options": [
        "Berlin",
        "Madrid",
        "Paris"
      ],
      "correct_index": 2
    }
  ]
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/quiz-maker/execute \
  -H "Content-Type: application/json" \
  -d '{
    "questions": [
      {
        "question": "Capital of France?",
        "options": [
          "Berlin",
          "Madrid",
          "Paris"
        ],
        "correct_index": 2
      }
    ]
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/quiz-maker
```

Full REST reference: https://findutils.com/api/quiz-maker/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt