# Jservice MCP > Jservice gives your AI agent access to a massive archive of historical Jeopardy! trivia clues. You can query thousands of facts by category, dollar value, or date range. Need random knowledge for a quiz? Get it instantly. This MCP turns static game show data into conversational knowledge. ## Overview - **Category:** knowledge-management - **Price:** Free - **Tags:** jeopardy, trivia, quiz, general-knowledge, historical-data ## Description This connection brings the world's biggest trivia database directly to your agent. Instead of manually searching through old clue books or trying to remember niche historical facts, you just ask your AI client. You can pull specific clues—say, 'What was the element symbol for gold in 1975?'—and get an answer right back. Need a fun quiz? Ask it to generate random challenges on any topic. The system lets you explore all known Jeopardy! categories and dive deep into specialized topics using natural conversation. It’s basically a vast, searchable library of general knowledge, powered by the Vinkius MCP catalog. ## Tools ### get_categories Retrieves a list of all available Jeopardy! categories. ### get_category Gets every clue associated with one specific category ID. ### get_clues Fetches a list of clues using filters like value, date, or category. ### get_random_clues Provides a random selection of trivia clues for immediate use. ## Prompt Examples **Prompt:** ``` Give me 3 random Jeopardy clues. ``` **Response:** ``` I've retrieved 3 random clues for you. One is from the 'Science' category: 'This element has the symbol Au'. Would you like the answers as well? ``` **Prompt:** ``` List 10 trivia categories and their IDs. ``` **Response:** ``` Here are 10 categories from the database: 1. Publications (ID: 12), 2. Sports (ID: 42), 3. Potent Potables (ID: 67)... Which one would you like to explore? ``` **Prompt:** ``` Find clues worth $1000 in category 42. ``` **Response:** ``` Searching for high-value clues in category 42 (Sports)... I found 2 clues worth $1000. One is about a famous 1920s baseball player. Should I reveal the clue text? ``` ## Capabilities ### List available trivia subjects You can get an instant list of all major Jeopardy! categories and their associated IDs. ### Retrieve highly specific clues Filter the database to pull exact clues using criteria like a dollar value, a category ID, or a date range. ### Generate spontaneous quizzes Ask for a random set of clues anytime you need quick trivia material. ### Focus on one topic area Get every clue associated with a single, defined category ID for focused study or gaming. ## Use Cases ### Running a corporate knowledge sprint A trainer needs to build three different quizzes for a team meeting. Instead of compiling them manually, they instruct their agent: 'Get 5 random clues using `get_random_clues` for the first quiz, then use `get_clues` to find only $200 value clues from the Sports category for the second.' The agent pulls everything in one go. ### Researching niche historical facts A history student needs to know about a specific event's coverage. They use `get_clues` and filter by both date range and category ID, pulling only the data relevant to that time period. ### Mapping out content pillars A marketer wants to see what topics are available for a new knowledge base. They start by calling `get_categories` to get a full list of subjects, allowing them to structure their entire content plan around the existing data. ### Quickly generating training material A manager needs 10 quick facts for an onboarding presentation. They ask the agent to retrieve random clues using `get_random_clues` and format them into a bulleted list, saving hours of research time. ## Benefits - Stop relying on memory. You can ask your agent to generate random clues using `get_random_clues`, perfect for spontaneous team quizzes. - Need context? Use the `get_categories` tool to first map out all possible topics, giving you a clear scope of data before deep diving into any one area. - Targeting specific knowledge is simple. The `get_clues` function lets you filter results by dollar value, date, or category ID—you only get what you need. - Deep study is straightforward with `get_category`. Instead of searching multiple pages, this tool pulls every clue for one subject so you can review the full scope of a topic. - Developers gain reliable data sources. You can test LLM retrieval pipelines against real-world, structured historical trivia sets. ## How It Works The bottom line is: you talk to your agent, it talks to this MCP, and you get a fact instantly. 1. First, tell your agent what kind of trivia you're interested in—for example, listing all available categories. 2. Next, narrow the search. You can ask for clues based on a specific category or filter by date and value to zero in on the exact data set needed. 3. The system returns structured clue text that your agent uses directly in conversation, providing instant historical knowledge. ## Frequently Asked Questions **How do I find out what categories are available using `get_categories`?** You simply ask your agent to run the `get_categories` tool. It will return a list of all major subjects and their unique IDs, letting you see exactly what topics you can pull data from. **Should I use `get_clues` or `get_category` for my research?** Use `get_clues` when you need to filter by multiple criteria, like a specific date *and* value. Use `get_category` only if you know the exact subject ID and want every clue within it. **Can I get clues for a specific year?** Yes, use the `get_clues` tool. This function allows you to filter results by date ranges, letting you narrow down the data set to only include clues from that time period. **Is there an easy way to make random quizzes?** Yes, just ask for random trivia using `get_random_clues`. It pulls a ready-made batch of mixed clues so you can start your quiz right away without any setup. **Does this MCP have an API key I need to set up?** No. Jservice is already a public database, meaning you connect and use it through the Vinkius platform without needing to manage or provide any personal API keys. **What happens if I need more than 100 results using `get_clues`?** The tool supports pagination via an offset parameter. If you hit the limit, simply include your desired starting index in the request payload, and it'll pull the next batch of clues. **Should I use `get_category` when I want to see every clue associated with a topic?** Yes. Use `get_category` if you need maximum depth for a specific subject. This function retrieves all related historical clues tied to that exact category ID. **How do I find clues that match both a specific dollar value and a category using `get_clues`?** You pass both the desired value and the category ID as parameters within the single `get_clues` call. This filters the results to show only the intersection of those two criteria. **Can I get multiple random clues at once?** Yes! Use the `get_random_clues` tool and specify the `count` parameter (up to 100) to receive a batch of random trivia questions. **How do I find clues from a specific category ID?** You can use `get_category` with the specific ID to get all clues in that category, or use `get_clues` and filter by the `category` parameter. **Is it possible to filter clues by their difficulty or dollar value?** Yes, the `get_clues` tool accepts a `value` parameter (e.g., 200, 400, 800) to help you find clues corresponding to specific Jeopardy! board positions.