How to Use the An API of Ice And Fire MCP in Vercel AI SDK

Q: How do I initialize An API of Ice And Fire inside my Vercel AI SDK project?

Install @ai-sdk/mcp and run createMCPClient with your Vinkius HTTP URL. Pass the toolset directly to generateText to start querying Westeros data.

Q: Can I stream character filter results live using An API of Ice And Fire and Vercel AI SDK?

Yes, the listcharacters tool works with streamText to push names and cultures to your UI. The model processes the JSON payload and renders the list word-by-word.

Stream real-time Westeros lore directly into your Next.js UI using the Vercel AI SDK and this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect An API of Ice And Fire MCP to Vercel AI SDK

Create your Vinkius account to connect An API of Ice And Fire to Vercel AI SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup An API of Ice And Fire with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instant Westeros Data Streaming in Vercel AI SDK

The `list_characters` tool queries the Westeros character database to fetch detailed profiles based on culture, gender, or name. Instead of waiting for a full API response to finish, your Vercel AI SDK application streams these character details straight to the user's screen. You configure the transport as HTTP inside the MCP client to pipe these raw facts directly into `streamText`. This setup bypasses slow server-side rendering delays, making your game-of-thrones app feel incredibly fast.

Deep-Dive House Queries Without Lag

The `get_house` tool fetches specific noble house allegiances, regions, and ancestral weapons directly from the database. Your React front-end displays these house details instantly as the model extracts them, avoiding boring loading spinners. By feeding the MCP Server tools directly into your Edge Functions, you keep execution times under 50ms. Users get immediate answers about House Stark or Lannister right when they ask.

Chronological Book Searches on the Edge

The `list_books` tool pulls the entire published bibliography of the series to resolve timeline questions. Your AI agent uses this tool to cross-reference release dates and page counts on the fly. When the query wraps up, calling `mcpClient.close()` cleans up the HTTP connection immediately. This prevents memory leaks in serverless environments, keeping your hosting bill low.

Setup guide

Set up An API of Ice And Fire MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all An API of Ice And Fire tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent An API of Ice And Fire transactions",
});

console.log(text);
await mcpClient.close();

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by An API of Ice And Fire. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect An API of Ice And Fire now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about An API of Ice And Fire MCP in Vercel AI SDK

Install `@ai-sdk/mcp` and run `createMCPClient` with your Vinkius HTTP URL. Pass the toolset directly to `generateText` to start querying Westeros data.

Yes, the `list_characters` tool works with `streamText` to push names and cultures to your UI. The model processes the JSON payload and renders the list word-by-word.

Vinkius manages the underlying connection to the API of Ice and Fire. Your Vercel AI SDK app only talks to our secure sandbox, protecting you from direct API rate limits.

Yes, the MCP client runs on lightweight V8 isolates. This means you can deploy your Westeros search tools to Cloudflare Workers or Vercel Edge without issues.

We never store your queries, character searches, or house lookups. All data requested from the Westeros database passes through an ephemeral V8 sandbox that wipes itself clean the second your session closes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript