# Harry Potter Lore MCP

> Harry Potter API MCP lets you access the canonical lore of the wizarding world. Search characters, staff, students, and spells from the entire Harry Potter universe instantly. Find detailed data on patronuses, houses, species, and character roles without needing any API keys.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Tags:** fictional-data, character-database, wizarding-world, metadata, entertainment-api, content-discovery

## Description

Need to write fan fiction or build a trivia quiz set in Hogwarts? This MCP gives you direct access to every known detail about the magical world. You can pull up complete rosters of students organized by house, find specific professors, or map out the full spellbook—names, types, and effects included. It's like having J.K. Rowling’s entire database right in your chat window. Instead of piecing together character names from different websites, you simply ask your agent for a list of all Gryffindor students, and you get structured data back. Because this MCP is hosted on Vinkius, you connect once to the catalog and gain access to this deep lore knowledge alongside other specialized tools. It's pure, canonical data designed for writers, academics, and any fan who needs reliable details about the world.

## Tools

### get_all_characters
Retrieves a comprehensive list of every character and creature in the Harry Potter universe.

### get_character
Pulls all known attributes for one specific individual, using their unique ID to pull the data.

### get_house_characters
Filters and lists characters belonging exclusively to a specified Hogwarts house.

### get_spells
Provides a complete list of spells, including their type (charm, hex) and what they do.

### get_staff
Lists all faculty members and teachers at Hogwarts with details on their role and house.

### get_students
Retrieves a roster of current students, detailing their year level and house affiliation.

## Prompt Examples

**Prompt:** 
```
Show me all Gryffindor students.
```

**Response:** 
```
Found 25+ Gryffindor students including: Harry Potter (stag patronus, half-blood), Hermione Granger (otter patronus, muggle-born), Ron Weasley (Jack Russell terrier patronus, pure-blood), Neville Longbottom, Ginny Weasley, Dean Thomas, Seamus Finnigan, Lavender Brown and more.
```

**Prompt:** 
```
What spell creates a Patronus?
```

**Response:** 
```
The Expecto Patronum spell creates a Patronus. It's a charm that conjures a protective spirit guardian. The spell requires the caster to focus on a powerful happy memory. The Patronus takes the form of an animal unique to each wizard.
```

**Prompt:** 
```
Who are all the Hogwarts staff members?
```

**Response:** 
```
Hogwarts staff includes: Albus Dumbledore (Headmaster, Gryffindor), Minerva McGonagall (Transfiguration, Gryffindor), Severus Snape (Potions/DADA, Slytherin), Filius Flitwick (Charms, Ravenclaw), Pomona Sprout (Herbology, Hufflepuff), Rubeus Hagrid (Care of Magical Creatures, Gryffindor), Argus Filch (caretaker), Sybill Trelawney (Divination) and more.
```

## Capabilities

### List all characters
Retrieves a complete list of every character and magical creature in the Harry Potter universe.

### Fetch single character profile
Gets all known details for one specific individual, including their patronus or species.

### Filter characters by house
Provides a roster of characters belonging only to Gryffindor, Slytherin, Ravenclaw, or Hufflepuff.

### Get all magical spells
Retrieves the full spellbook, detailing each spell's name, type, and effect.

### List school staff
Finds a roster of professors and administrative staff at Hogwarts.

### Get student rosters
Retrieves all current students, detailing their house and year.

## Use Cases

### Building a character database for a game
A developer needs to populate a new mini-game with lore. Instead of copying data, they ask the agent to run `get_all_characters` and get a clean, structured list that includes species and patronuses for every entity.

### Writing a professor's backstory
A writer needs details on Minerva McGonagall. They use the tools to specifically target staff members using `get_staff` and pull her full profile, ensuring canonical accuracy for their plot point.

### Generating a house-specific quiz
A content creator is making a quiz only about Slytherin. They use the `get_house_characters` tool to filter the list immediately by 'Slytherin,' limiting their data scope and making the quiz accurate.

### Designing a magic system guide
A user needs to explain how Expecto Patronum works. They run `get_spells` to confirm the spell's type, effect description, and necessary components for their guide.

## Benefits

- Stop guessing character details. The `get_character` tool pulls every attribute—patronus, species, ancestry—for accurate profiles.
- Need a full roster? Use `get_students` or `get_staff` to instantly list all individuals at Hogwarts without manual searching across multiple tabs.
- Building trivia is easier with dedicated tools. You can use `get_house_characters` to pull only Gryffindor members, making your content hyper-focused.
- Spell mechanics are precise. The `get_spells` tool gives you the name, type, and effect of every spell in the book.
- The system handles scale. You can use `get_all_characters` to build massive databases that include creatures alongside people.

## How It Works

The bottom line is you get direct access to deep character and spell data through natural conversation, without writing any code or managing keys.

1. Subscribe to this MCP on Vinkius. You don't need an API key; connection is immediate.
2. Ask your AI client for the specific data you need (e.g., 'List all spells').
3. The MCP runs the appropriate tool, and your agent receives a structured, usable list of canonical lore.

## Frequently Asked Questions

**How do I get a list of all characters using get_all_characters?**
You simply ask your agent to run `get_all_characters`. It returns every character and creature, providing details like their house, role, and patronus.

**Is there a way to find all students from Hogwarts? Use get_students.**
Yes. The `get_students` tool gives you the current student roster with key details, including who belongs to which house and what year they are in.

**What is the difference between get_staff and get_all_characters?**
`get_staff` limits your results only to professors and school employees. `get_all_characters`, however, includes staff plus students, creatures, and every other magical being.

**How can I find all the different spells available? Use get_spells.**
To see the full spellbook, call `get_spells`. This tool delivers a complete list of names, types (charm, hex), and detailed effect descriptions.

**When I use get_house_characters, how do I narrow down the results to just a specific house?**
You specify the exact house name (like Gryffindor or Ravenclaw) in your request. This filters the character roster immediately, giving you only students and staff belonging to that single Hogwarts house.

**I need deep details on one person; should I use get_character instead of listing everyone with get_all_characters?**
Yes. If you know the unique ID, calling get_character delivers a comprehensive profile for that single individual. It pulls rich data like ancestry and patronus without needing to filter through the entire database.

**What is the difference in scope between using get_students versus get_staff?**
They cover different roles. get_students focuses on academic records, providing details like year and patronus for students. get_staff provides professional titles, detailing faculty members like professors or headmasters.

**Does get_all_characters include magical creatures in addition to people?**
Yes. This tool pulls the complete roster of the entire universe. It includes not only characters and students but also various magical creatures, giving you a full view beyond just human figures.

**Do I need an API key?**
No! The Harry Potter API (hp-api.onrender.com) is completely free and requires no authentication. Just subscribe and start exploring.

**What houses are available?**
All four Hogwarts houses: gryffindor, slytherin, ravenclaw and hufflepuff. Use get_house_characters to filter by any house.

**Does the API include creatures and non-human characters?**
Yes! get_all_characters includes humans, magical creatures, ghosts and sentient beings. Each entry includes species info (human, half-giant, house-elf, centaur, etc.).