• FILTERED
  • IDENTIFIED
  • GROUPED
  • HUMAN

How to search character metadata with your AI

Connect this MCP to your AI client to query the Ice And Fire character database. Once connected, you can filter through the entire roster using natural language.

Ask AI about this page

Short answer

How can I find specific characters in Ice And Fire?

You can ask your AI to pull lists of characters based on specific traits like gender, name, or culture. It uses the character database to filter the roster and return exactly who you asked for.

The results you get

Where your data lands

The AI processes your request and organizes the data into these outcomes.

FILTERED

Targeted character lists

The AI narrows down the massive character roster to only those that match your specific criteria. You get a clean list instead of scrolling through everything.

IDENTIFIED

Specific character details

If you search for a name, the AI finds the exact metadata associated with that individual. This makes finding specific lore details much faster.

GROUPED

Cultural and gender groupings

You can request lists grouped by specific cultures or genders. The AI handles the sorting so you don't have to.

HUMAN

Manual lore verification

The AI provides the data it finds, but you decide if the character's history fits your specific creative needs or story context.

The workflow

What your AI does when you ask for characters.

The AI acts as a bridge between your chat interface and the Ice And Fire data.

  1. Analyze the request

    Your AI looks at your prompt to determine if you are looking for a specific name, a group of people, or a specific culture.

    list_characters

  2. Query the database

    The AI calls the character tool to scan the available metadata for matches.

    list_characters

  3. Filter the results

    It strips away any characters that don't meet your gender or culture requirements.

    list_characters

  4. Present the list

    The AI formats the final list of names and details into a readable response for you.

    list_characters

Try it

Copy these to start.

Use these prompts to test the connection.

Starting points

These are basic examples. Swap out the cultures or genders for whatever you actually need to find.

An API of Ice And Fire Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_Ja84DzzEjw4m52hX5Z8VQXtnP5R8IVf6xwjhGPfG/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 — An API of Ice And Fire capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "an-api-of-ice-and-fire-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Ja84DzzEjw4m52hX5Z8VQXtnP5R8IVf6xwjhGPfG/mcp"
    }
  }
}
Copy into chat04

  • List all characters from the North.

  • Find all female characters in the database.

  • Who are the characters named Jaime?

  • Show me a list of characters belonging to the Reach culture.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect An API of Ice And Fire once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start querying immediately.

Connect An API of Ice And Fire to your AI

FAQ

How this task behaves

  • 01

    Can the AI add new characters to the list?

    No. This MCP only allows the AI to read and list existing character metadata.

  • 02

    Can I search for characters by their house name?

    You can search by culture, gender, or name. If house names are categorized under culture in the data, the AI can find them.

  • 03

    Does the AI change any character details?

    No. The AI cannot edit, delete, or modify any of the character information in the database.

  • 04

    Can I filter by character age?

    No. The current tools only support filtering by culture, gender, and name.

  • 05

    How does the AI handle misspelled names?

    The AI will attempt to find the closest match in the database, but results depend on how the tool handles the search string.

  • More questions about An API of Ice And Fire? The Connector page answers them. See everything the An API of Ice And Fire Connector can do

Connect An API of Ice And Fire to Claude, Cursor, ChatGPT & more