- DIRECTORY
- ROLES
- SEARCH
- HUMAN
Short answer
How can I find Hogwarts professors and their roles?
Your AI pulls the complete faculty directory from the Harry Potter API. You'll get names and specific job titles through a simple chat. Here is how the data is handled.
The results you get
Where the data lands
The AI handles the heavy lifting of searching the API so you don't have to.
DIRECTORY
Full staff lists
The AI pulls the entire list of professors. You get a clean roster of everyone teaching at the school.
ROLES
Specific job titles
The AI identifies exactly what each person teaches. You'll see which staff members handle Potions, Charms, or Defense.
SEARCH
Targeted faculty lookups
Ask for a specific person or a specific subject. The AI finds the exact match in the directory.
HUMAN
Your own analysis
The AI provides the raw faculty data. You decide how to use these names for your own research or writing.
The workflow
What your AI does when the request arrives.
The AI acts as the bridge between your chat and the Harry Potter API.
Fetch faculty data
The AI reaches out to the API to find the staff records.
get_staffIdentify roles
The AI looks through the returned data to find specific teaching assignments.
get_staffFilter results
The AI narrows down the list based on the specific department you asked for.
get_staffPresent information
The AI formats the names and roles into a clear response for your chat.
get_staff
Try it
Copy these to start.
Use these prompts to begin your research.
Starting points
These are basic requests. You can swap out the subjects or names to find different people.
HP-API Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_CGZ3vdbXEFWU5drnyIXhISLaZR7EZsMsvLDp64pI/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — HP-API capabilities are ready to use.
{
"mcpServers": {
"harry-potter-api-mcp": {
"url": "https://edge.vinkius.com/vk_preview_CGZ3vdbXEFWU5drnyIXhISLaZR7EZsMsvLDp64pI/mcp"
}
}
}List all the professors at Hogwarts.
Who is the current Potions professor?
Show me a list of all staff members and their specific roles.
Which staff members teach Defense Against the Dark Arts?
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Start here
Connect Harry Potter API once, then ask.
One click connects the API to your client. Your credentials stay encrypted and the setup is handled by Vinkius.
Connect Harry Potter API to your AIFAQ
How this task behaves
- 01
Can the AI add new professors to the list?
No. The AI can only read the existing directory through the API.
- 02
Can I use this to find student information?
No. This specific task is limited to staff and faculty data.
- 03
Does the AI remember the staff list for later?
The AI uses the data during your session, but it doesn't store a permanent database of the school.
- 04
Can the AI change a professor's role?
No. The tool is read-only for the staff directory.
- 05
How does the AI get the names?
It pulls them directly from the Harry Potter API using the get_staff tool.
More questions about Harry Potter API? The Connector page answers them. See everything the Harry Potter API Connector can do
Connect HP-API to Claude, Cursor, ChatGPT & more
