# Harry Potter API MCP for AI Agents AI Agent Connect

> Harry Potter API. This Connector lets you pull data on every character, house, and spell from the wizarding world into your AI client. Use it to build trivia apps, write fan fiction with accurate lore, or just settle debates about which house a character belongs to. No API keys or complex setups are required.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_CGZ3vdbXEFWU5drnyIXhISLaZR7EZsMsvLDp64pI/ai-agent-connect
- **Tags:** fictional-data, character-database, wizarding-world, metadata, entertainment-api, content-discovery

## Description

This Connector lets you pull data on every character, house, and spell from the wizarding world into your AI client. Use it to build trivia apps, write fan fiction with accurate lore, or just settle debates about which house a character belongs to. Because it's hosted on Vinkius, you can plug it into your favorite setup and start querying the lore immediately without worrying about authentication. It's the quickest way to get canonical details on spells, house rosters, and student records without leaving your workspace. You can get the full roster of magical creatures or find the specific roles of Hogwarts staff members in seconds. It's designed for anyone who wants to stay consistent with the books while creating content or exploring the series.

## Tools

### get_house_characters
Pull a roster of characters from a specific house including their patronus and species. This is great for seeing who belongs to a specific house.

### get_staff
Get a list of all Hogwarts teachers and staff members with their roles and houses. This helps you identify every professor at the school.

### get_students
Find students organized by house, year, and other character details. It is useful for finding students by house or character name.

### get_all_characters
Pull the entire roster of characters and magical creatures from the series. Use this to explore the full scope of the wizarding world.

### get_character
Fetch specific details like ancestry and alive status for a single character by their ID. This provides deep metadata on a single person.

### get_spells
Retrieve a list of all spells along with their magic types and descriptions. Use this to learn exactly what a charm or curse does.

## Prompt Examples

**Prompt:** 
```
Who are the main Gryffindor students?
```

**Response:** 
```
Here are the students currently in Gryffindor house:

| Name | House | Year | Patronus | Species |
| :--- | :--- | :--- | :--- | :--- |
| **Harry Potter** | Gryffindor | 1 | Stag | Human |
| **Hermione Granger** | Gryffindor | 1 | Otter | Human |
| **Ron Weasley** | Gryffindor | 1 | Jack Russell Terrier | Human |
| **Neville Longbottom** | Gryffindor | 1 | Doe | Human |
| **Ginny Weasley** | Gryffindor | 1 | - | Human |
```

**Prompt:** 
```
What does the Patronus spell do?
```

**Response:** 
```
The **Expecto Patronum** spell is a charm used to conjure a protective spirit guardian. 

*   **Type:** Charm
*   **Effect:** Conjures a protective spirit guardian.
*   **Requirement:** The caster must focus on a powerful happy memory.
*   **Form:** The Patronus takes the form of an animal unique to each wizard.
```

**Prompt:** 
```
List some Hogwarts staff members.
```

**Response:** 
```
Here are some of the key staff members at Hogwarts:

*   **Albus Dumbledore**: Headmaster (Gryffindor)
*   **Minerva McGonagall**: Transfiguration (Gryffindor)
*   **Severus Snape**: Potions/DADA (Slytherin)
*   **Filius Flitwick**: Charms (Ravenclaw)
*   **Pomona Sprout**: Herbology (Hufflepuff)
```

## Capabilities

### Pull full character rosters
Get a complete list of every person and creature in the series.

### Filter by Hogwarts house
See who belongs to Gryffindor, Slytherin, Ravenclaw, or Hufflepuff.

### Look up spell effects
Find specific magic types like charms or curses and what they actually do.

### Identify school staff
Get names, roles, and house affiliations for all teachers and professors.

### Search student records
Look up students by house, year, and species.

### Get specific character bios
Pull detailed info like ancestry and alive status for a single character.

## Use Cases

### Consistent Fan Fiction
A writer asks for the patronus of a specific character to make sure it fits the scene they are writing.

### Trivia App Development
A dev uses the agent to pull a list of all spells to populate a guess the effect game.

### Tabletop RPG Prep
A GM asks for all creatures and their species to create a bestiary for a homebrew campaign.

### Quick Lore Check
A fan asks which house a specific character belongs to while watching a movie marathon.

## Benefits

- Stop manual wiki searching by using get_all_characters to pull every character into your chat instantly.
- Keep your writing consistent by checking ancestry and species with get_character before you start a new scene.
- Build better trivia with get_spells to quickly grab every charm and curse effect in the series.
- Organize your world-building with get_students to see full rosters for every Hogwarts house.
- Save time on research by using get_staff to identify every professor and their specific role at school.

## How It Works

The bottom line is you get instant access to canonical Harry Potter lore without searching multiple websites.

1. Subscribe to the Harry Potter API MCP on Vinkius.
2. Connect your AI client to the Connector.
3. Ask your agent questions about characters, spells, or houses to get instant data.

## Frequently Asked Questions

**Can I use the Harry Potter API MCP for my fan fiction?**
Yes, it provides canonical details on character ancestry, species, and house affiliations. This helps you keep your story consistent with the established lore without constant research.

**Does the Harry Potter API MCP include spell effects?**
Yes, it includes the names, magic types, and specific effects for all spells. You can ask your agent to explain how a specific charm or curse works.

**Can I get a list of all characters with the Harry Potter API MCP?**
Yes, it can pull the entire roster of characters and magical creatures. You can use this to browse the whole wizarding world or look for specific types of creatures.

**Is there a cost to use the Harry Potter API MCP?**
No, it is completely free to use when you connect it through Vinkius. You get full access to the data without needing to manage separate subscriptions.

**Can I filter students by house using the Harry Potter API MCP?**
Yes, you can specifically request students from Gryffindor, Slytherin, Ravenclaw, or Hufflepuff. It also includes details like their year and patronus.

**Does the Harry Potter API MCP work with Claude?**
Yes, it works with Claude and any other MCP-compatible client. Once you connect it via Vinkius, your agent can use the tools naturally.

**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.).