# A Song of Ice And Fire MCP > An API of Ice And Fire connects George R.R. Martin's sprawling lore directly into your agent. You can query details on Westerosi noble houses, search thousands of characters by culture or name, and pull metadata for books in the series with natural conversation. Stop guessing lore facts; start retrieving them. ## Overview - **Category:** databases - **Price:** Free - **Tags:** asoiaf, game-of-thrones, westeros, fantasy-lore, book-database ## Description Need to verify a fact about House Lannister? Want to list every book title or find the lineage of a specific character like Daenerys Targaryen? This MCP connects the definitive A Song of Ice and Fire database directly to your agent, letting you explore the entire world of Westeros through plain conversation. You don't have to leave your workspace just to check a motto or a family tie. Instead of sifting through fragmented wiki pages, your AI client handles complex queries instantly. When integrated with Vinkius, this MCP gives you access to all these powerful lore tools in one place. It’s built for writers who need facts fast, researchers studying fantasy genealogy, and developers building applications around deep world-building. ## Tools ### get_book Retrieves all specific details for a single book title in the series. ### get_character Gets full biographical details for any single character in the database. ### get_house Retrieves the specific motto, seat, and regional information for a single house. ### list_books Returns an exhaustive list of every published book available in the A Song of Ice and Fire canon. ### list_characters Provides a comprehensive list of characters, allowing you to filter results by culture, gender, or name. ### list_houses Lists all noble families and houses, filtered by region or name to narrow down results. ## Prompt Examples **Prompt:** ``` List all the books in the A Song of Ice and Fire series. ``` **Response:** ``` I've retrieved the list of books. There are several entries including 'A Game of Thrones', 'A Clash of Kings', and 'A Storm of Swords'. Would you like the details for a specific one? ``` **Prompt:** ``` Find characters from the Valyrian culture. ``` **Response:** ``` Searching for Valyrian characters... I found several, including Aegon Targaryen and Daenerys Targaryen. Would you like me to fetch the full metadata for any of these characters using their ID? ``` **Prompt:** ``` Get the details for House Stark using its ID 362. ``` **Response:** ``` Inspecting House Stark (ID: 362)... Their region is 'The North', their seat is 'Winterfell', and their words are 'Winter is Coming'. They also possess the ancestral weapon 'Ice'. ``` ## Capabilities ### Query Books Metadata List every book in the series or get detailed metadata like page counts and ISBN for a specific title. ### Search Character Details Find characters across the continent by filtering results using name, gender, culture, or alias. ### Retrieve House Lore Explore the noble houses of Westeros to get information on their ancestral seats, regional location, and defining mottos. ## Use Cases ### Checking Character Lineage A writer needs to know the parentage of a minor noble. Instead of searching multiple wiki pages, they ask their agent: 'What is the full history of this character?' The MCP uses `get_character` and returns all family ties, titles, and aliases in one response. ### Comparing Noble Houses A game designer needs to compare three different noble families. They ask their agent to list houses filtered by region. The MCP uses `list_houses` first, then the developer can systematically run `get_house` for each one, compiling a clean data sheet. ### Outlining Book Arcs A fan researcher wants to see which books cover specific events. They ask their agent to list all books in the series (`list_books`) and then cross-reference key characters using `get_character` on each title for a complete overview. ## Benefits - Stop cross-referencing Wikipedia. Use the `list_books` tool to get a complete roster of all available books in the series, giving you immediate scope over the canon. - Build robust world models by using `get_house` and `get_character`. You can instantly pull specific data like ancestral seats or family titles for deep-dive continuity checks. - Eliminate guesswork when writing. If you need to know a character's full biography, simply use the `get_character` tool to retrieve their titles, aliases, and parentage in one go. - Drafting content is faster using `list_characters`. You can filter by culture or gender to pull specific groups of characters without digging through thousands of entries. - Verify regional details effortlessly. Use `list_houses` first, then follow up with `get_house` to confirm a house’s official motto and geographical region. ## How It Works The bottom line is: You talk naturally; the MCP handles the complex database retrieval for you. 1. Connect this MCP to your preferred AI client through Vinkius. 2. Tell your agent what lore you need to know—for example, 'What are the books about House Stark?' 3. The MCP executes the necessary data lookups and presents the structured results back to your conversation. ## Frequently Asked Questions **How do I find all the books using list_books?** You simply ask your agent to execute `list_books`. This tool returns a complete catalog of titles in the A Song of Ice and Fire series, letting you see every available book at once. **Can I look up a house's motto with get_house?** Yes. The `get_house` tool retrieves core details for any noble family, including their official motto (words) and ancestral seat. Just provide the name of the house you are interested in. **Is list_characters better than listing by culture?** Both work, but `list_characters` offers filtering options. You can use filters for culture, gender, or name to narrow your search before pulling detailed records with `get_character`. **What if I need details on a book's ISBN?** The `get_book` tool provides specific metadata points like the ISBN and page counts for any selected title, ensuring you have accurate publication data. **Do I need to know the house ID to use get_house?** No. You just tell your agent which noble house you want details on. The MCP handles the lookup using `get_house` once you provide the name.