Skip to content
Vinkius

HP-API Connector for AI agents.

6 live capabilities

Access canonical wizarding world lore and character data for your projects.

Live agent request HP-API / Connector

Waiting for input…

AI Agent

Why people use HP-API

Harry Potter API Wizarding World Lore Data

This Connector changes that by putting the entire wizarding world inside your agent. You just ask a question and get the facts immediately. You get a clean, consistent flow of data for your next project.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get instant access to canonical Harry Potter lore without searching multiple websites.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Consistent Fan Fiction

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

  2. Real-world use case 02

    Trivia App Development

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

  3. Real-world use case 03

    Tabletop RPG Prep

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

Complete set · 6capabilities

The complete HP-API capability set.

These are the exact actions your AI can choose when you ask it to work with HP-API.

Capability set01 / 02

01—03

3 capabilities in this set.

Part of 6 available through HP-API.

  1. 01 Capability

    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.

  2. 02 Capability

    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.

  3. 03 Capability

    Get students

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

Capability set02 / 02

04—06

3 capabilities in this set.

Part of 6 available through HP-API.

  1. 04 Capability

    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.

  2. 05 Capability

    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.

  3. 06 Capability

    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.

Set up in minutes

One URL. Then ask HP-API to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use HP-API from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_CGZ3vdbXEFWU5drnyIXhISLaZR7EZsMsvLDp64pI/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it HP-API, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable HP-API for the conversation.

Where the request belongs

Work HP-API can move forward.

Built around the request

Fans who need accurate lore for projects, trivia lovers looking for deep-dive stats, and writers who want to keep their fan fiction consistent with the books.

01

Fan Fiction Writer

Checking character ancestry and species to ensure lore consistency while writing a new chapter.

02

Trivia Content Creator

Pulling lists of spells and house members to build a quiz or a social media thread.

03

RPG Game Master

Looking up magical creatures and spells to build a bestiary for a homebrew campaign.

Build the capability set

Add more capabilities.

Each Connector adds new actions and data without changing how you work.

Browse Connectors
The One logo
01 13 capabilities

The One

Access the complete lore of Middle-earth. browse books, movies, characters, and iconic quotes from The Lord of the Rings universe.

View Connector
An API of Ice And Fire logo
02 6 capabilities

An API of Ice And Fire

Explore the world of A Song of Ice and Fire. query books, characters, and noble houses of Westeros directly from any AI agent.

View Connector
Open5e logo
03 12 capabilities

Open5e

Access the comprehensive Open5e database for D&D 5th Edition. search monsters, spells, classes, and magic items directly from your AI agent.

View Connector
Hyrule Compendium logo
04 3 capabilities

Hyrule Compendium

Access the comprehensive Breath of the Wild and Tears of the Kingdom compendium. search creatures, monsters, materials, and equipment directly from your AI agent.

View Connector
AniList GraphQL logo
05 15 capabilities

AniList GraphQL

Access the world's largest anime and manga database. search titles, characters, staff, and manage your personal lists via GraphQL.

View Connector
Convai logo
06 25 capabilities

Convai

Build and manage conversational AI characters with backstory, narrative design, and knowledge banks for games and apps.

View Connector

Bring your own AI

Change the model, client or framework. Keep HP-API connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about HP-API.

The practical details behind the request, access and result.

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

One connection away

Give your agent a direct line to HP-API.

Connect HP-API once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available