Harry Potter

liveBooksEntertainment

Characters, houses, spells and staff from the Harry Potter books.

4tools
0msauth
free tier50 calls/day

Tools

list_characters

List Harry Potter characters (wizards, witches, and other figures). Optionally filter by Hogwarts house (Gryffindor, Slytherin, Hufflepuff, Ravenclaw) and/or a name substring.

No parameters required.

▶Try it
list_students

Return all Hogwarts students from the HP API (up to 60), each with name, house, species, gender, ancestry, patronus, wand, actor, date of birth, and alive status.

No parameters required.

▶Try it
list_staff

Return all Hogwarts staff members (professors and employees) from the HP API, each with name, house, species, gender, ancestry, patronus, wand, actor, date of birth, and alive status.

No parameters required.

▶Try it
list_spells

List Harry Potter spells with their effects. Optionally filter by a spell-name substring.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/harrypotter/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/harrypotter/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_characters","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("list_characters", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("characters, houses, spells and staff from the harry potter books");