An API of Ice and Fire
liveBooksEntertainmentA Song of Ice and Fire (GoT) books, characters, houses. Keyless.
6tools
0msauth
free tier50 calls/day
Tools
booksSearch and list A Song of Ice and Fire books filterable by name, release date range (fromReleaseDate/toReleaseDate), with pagination (page, pageSize); returns ISBN, authors, publisher, number of pages
Parameters
NameTypeDescription
nameoptstring—fromReleaseDateoptstring—toReleaseDateoptstring—pageoptnumber—pageSizeoptnumber—Try it
Response
bookrequired: idSingle book by id.
Parameters
NameTypeDescription
idreqnumber—Try it
Response
charactersSearch and list ASOIAF characters filterable by name, culture, birth/death descriptor, gender, and alive status; returns aliases, titles, house affiliations, and book/POV appearances.
Parameters
NameTypeDescription
nameoptstring—cultureoptstring—bornoptstring—diedoptstring—isAliveoptboolean—genderoptstring—pageoptnumber—pageSizeoptnumber—Try it
Response
characterrequired: idSingle character by id.
Parameters
NameTypeDescription
idreqnumber—Try it
Response
housesSearch/list houses.
Parameters
NameTypeDescription
nameoptstring—regionoptstring—wordsoptstring—hasTitlesoptboolean—hasSeatsoptboolean—hasDiedOutoptboolean—hasAncestralWeaponsoptboolean—pageoptnumber—pageSizeoptnumber—Try it
Response
houserequired: idSingle house by id.
Parameters
NameTypeDescription
idreqnumber—Try it
Response
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/anapioficeandfire/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/anapioficeandfire/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"books","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("books", {});ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("a song of ice and fire (got) books, characters, houses");