Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use HP-API with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Explore the wizarding world. search characters, students, staff, houses and spells from the Harry Potter universe.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 6 capabilities

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

    Get house characters

    Houses: gryffindor, slytherin, ravenclaw, hufflepuff. Each entry includes name, actor, role, patronus and species. Useful for exploring house-specific character rosters. Get characters from a specific Hogwarts house

  2. 02

    Get students

    Each entry includes name, house, year, actor name, patronus, species and alive status. Useful for finding students by house or character. Get all Hogwarts students

  3. 03

    Get all characters

    Each entry includes name, house, role (student/staff/creature), actor name, patronus, species and alive status. Useful for exploring the entire Harry Potter universe. Get all Harry Potter characters and creatures

Capability set02 / 02

04-06

3 capabilities in this set.

Part of 6 available through HP-API.

  1. 04

    Get character

    Returns name, house, role, actor, patronus, species, ancestry and alive status. Use get_all_characters to find character IDs first. Get a specific Harry Potter character by ID

  2. 05

    Get spells

    Each entry includes the spell name, type (charm, curse, hex, etc.) and effect description. Useful for discovering spells and their effects. Get all Harry Potter spells

  3. 06

    Get staff

    Each entry includes name, house, role, actor name and alive status. Useful for finding professors and school staff. Get all Hogwarts staff and teachers

Observed, not estimated

856ms average. Fast in production.

HP-API is checked daily against the live service.

Daily averagePeak 959ms
Aug 20Today
Fastest day
725ms
Slowest day
959ms
14-day trend
Slowing+16%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 6 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of HP-API, so you can see the experience inside your AI.

It does not authenticate your account with HP-API. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

HP-API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_CGZ3vdbXEFWU5drnyIXhISLaZR7EZsMsvLDp64pI/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — HP-API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "harry-potter-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_CGZ3vdbXEFWU5drnyIXhISLaZR7EZsMsvLDp64pI/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions HP-API owners ask.

  • 01

    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.

  • 02

    What houses are available?

    All four Hogwarts houses: gryffindor, slytherin, ravenclaw and hufflepuff. Use get_house_characters to filter by any house.

  • 03

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

Explore

More in Knowledge Management

Suggestions