# Trivia Quiz Generator MCP

> The Trivia Quiz Generator MCP Server provides instant access to thousands of curated trivia questions. Your agent can fetch random, filtered question sets across multiple categories—like History or Science—or list every available topic and tag for building educational content.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Tags:** quiz, trivia, educational-content, data-retrieval, content-generation

## Description

This server gives your agent immediate access to thousands of curated trivia questions. You can build complex content or just whip up a quick quiz, depending on what you need. Your agent uses three specific tools—`list_trivia_categories`, `list_trivia_tags`, and `get_trivia_questions`—to handle everything from topic planning to delivering the final question set.

If you're starting out and don't know what kind of trivia you want, use `list_trivia_categories`. This tool spits out every major category the server holds data for; it’s your master list of topics like 'Science,' 'History,' or 'Film & TV.' You can check this whole rundown to figure out where you wanna head.

Need something more specific than just a big category? Use `list_trivia_tags`. This gives you granular tags—the niche stuff. Instead of finding general questions about 'Literature,' you might want questions tagged specifically for 'Victorian Poetry' or 'Shakespearean Tragedy.' That’s what this tool lets your agent find.

When you know exactly what you need, `get_trivia_questions` pulls the data. You can tell it to grab random questions and even narrow them down by both a specific category *and* a difficulty level—like 'medium' or 'hard.' The questions returned aren't just facts; they include one correct answer and three plausible wrong answers, which is exactly what you need for building an actual quiz game. You don't gotta worry about formatting the multiple-choice options.

So, if you’re planning a study guide, your agent first runs `list_trivia_categories` to map out all available topics. Then, it uses `list_trivia_tags` if you need to focus on a really specific theme. Finally, when it's time for the quiz, it calls `get_trivia_questions`, pulling filtered sets that give you everything—the question, the right answer, and three convincing decoys. It’s designed to handle all the content retrieval so your agent just needs to talk naturally with the user.

## Tools

### list_trivia_categories
Lists every major available trivia category the server holds data for.

### get_trivia_questions
Gets random trivia questions, allowing filtering by category and difficulty level.

### list_trivia_tags
Provides a list of specific tags, letting you find questions related to niche topics.

## Prompt Examples

**Prompt:** 
```
Get 5 hard science trivia questions.
```

**Response:** 
```
Retrieving 5 hard science questions... I have them ready! Each question comes with one correct answer and three incorrect options. Ready to test your science knowledge?
```

**Prompt:** 
```
List all trivia categories.
```

**Response:** 
```
Fetching the categories... The Trivia API offers a wide range, including Music, Sport & Leisure, Film & TV, Arts & Literature, History, Society & Culture, Science, and Geography.
```

**Prompt:** 
```
Give me a random trivia question about Geography.
```

**Response:** 
```
Searching for a geography question... Here it is: 'Which country is known as the Land of the Rising Sun?' Options: Japan (Correct), China, Thailand, South Korea. Good luck!
```

## Capabilities

### Fetch Question Sets
Retrieves random or filtered trivia questions, providing a distinct correct answer and three plausible wrong answers.

### List All Topics
Returns a comprehensive list of all available trivia categories and subcategories for content planning.

### Search by Theme
Finds questions related to specific, user-defined themes or topics using provided tags.

## Use Cases

### Building an Educational Module
A teacher needs 10 questions about the French Revolution. Instead of searching dozens of sites, they tell their agent to first run `list_trivia_categories` to verify 'History.' Then, they use a specific prompt that triggers `get_trivia_questions` with parameters for 'History' and 'medium difficulty,' getting exactly the data needed.

### Creating Themed Night Games
A corporate event planner wants to run three rounds: one on movies, one on geography, and one on sports. They instruct their agent to first call `list_trivia_tags` to verify the available tags for each theme, then execute multiple calls to `get_trivia_questions`, ensuring maximum thematic variety.

### Generating Flashcards
A student is studying biology. They ask their agent to pull 20 'easy' questions about Science using `get_trivia_questions`. The resulting structured data allows the agent to quickly summarize or format these Q&As for printable flashcards.

### Content Auditing
A content team needs to know what topics they haven't covered yet. They run `list_trivia_categories` and then compare the list against their existing knowledge base, finding gaps in areas like 'Society & Culture' or specific tags.

## Benefits

- **Variety:** You don't have to stick to one topic. Using `list_trivia_categories` shows you all available subjects, from Science to Pop Culture, so your content never feels repetitive.
- **Control Difficulty:** Need a warm-up round? Use the difficulty filter in `get_trivia_questions`. Or do you want the participants stumped? Set it to 'hard.'
- **Targeted Content:** Forget browsing. If you know you need questions about 'Renaissance Art,' use `list_trivia_tags` first, then pull only relevant sets with `get_trivia_questions`.
- **Efficiency:** The server gives you the full data packet every time—question, correct answer, and three wrong options. You get ready-to-use content immediately.
- **Scalability:** Since this is a public API connection, your agent can run these queries constantly without needing complex internal database management.

## How It Works

The bottom line is that your agent converts complex knowledge retrieval into simple, actionable data feeds for any application.

1. Your agent first uses `list_trivia_categories` to identify the desired knowledge domain (e.g., History).
2. Next, it runs `get_trivia_questions`, passing the selected category and difficulty level as parameters.
3. The server returns a structured list of questions, each containing four options and the single correct answer.

## Frequently Asked Questions

**How do I see what categories are available with the Trivia Quiz Generator MCP Server?**
Run the `list_trivia_categories` tool. This immediately provides a comprehensive list of all major topics (like History, Science, or Pop Culture) that have associated questions.

**Can I find niche questions using the Trivia Quiz Generator MCP Server?**
Yes. Use `list_trivia_tags` to see available themes. Then pass a specific tag into `get_trivia_questions` to pull only content related to that topic.

**Does get_trivia_questions give me just the question or all options?**
It gives you everything: the main question, three incorrect options, and one designated correct answer. The data is fully structured for immediate use.

**Is there a limit to how many questions I can get using the Trivia Quiz Generator MCP Server?**
The server handles bulk retrieval efficiently. You specify the number you need, and it pulls that quantity while maintaining filtering by category or difficulty.

**Do I need an API key or special credentials to use the `get_trivia_questions` tool?**
No, you don't. This MCP server is set up for public access, meaning your agent connects directly through Vinkius without needing private keys or authentication setup.

**If I run into an issue using `get_trivia_questions` with bad parameters, what should I expect?**
The server returns a specific error message detailing which parameter was invalid. It'll usually suggest the required format or list acceptable values to correct your request.

**Is the Trivia Quiz Generator MCP Server compatible with all my coding tools and AI agents?**
Yes, it operates on the Model Context Protocol (MCP) standard. As long as your agent supports this protocol—including Claude, Cursor, or VS Code—you can connect to it.

**Should I use `list_trivia_tags` before trying to generate questions?**
It's smart practice. Running `list_trivia_tags` first gives you a complete inventory of available themes, letting your agent narrow down the topic exactly before calling `get_trivia_questions`.

**Can I get 10 random history questions?**
Yes! Use the `get_trivia_questions` tool and set the `categories` parameter to 'history' and `limit` to 10. It will return a set of history-themed questions.

**How can I filter by difficulty?**
The `get_trivia_questions` tool has a `difficulties` parameter. You can specify 'easy', 'medium', or 'hard' to get questions at the desired challenge level.

**What are the available categories?**
You can use the `list_trivia_categories` tool to see the full list. Common categories include Arts & Literature, Film & TV, Geography, History, Music, and Science.