How to Use the Uselessfacts MCP in Vercel AI SDK

Q: How does Uselessfacts work with Vercel AI SDK?

You connect to the MCP Server using mcpClient.tools() and pass it into your stream function. The data comes back as a stream, meaning users see the fact appear character by character in real time.

Q: Can I use Uselessfacts to generate content for a German audience with Vercel AI SDK?

Yep. Both getrandomfact() and gettodayfact() let you pass 'de' as the language parameter, so your streaming UI will show facts in German.

Q: Does Uselessfacts support specific fact retrieval for Vercel AI SDK?

Absolutely. By using getfact(id), you can pull any piece of useless trivia if you know the exact ID. It gives you precise control over the content displayed.

Stream facts into your UI with Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Uselessfacts MCP to Vercel AI SDK

Create your Vinkius account to connect Uselessfacts 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 Uselessfacts with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Displaying random facts in real time.

Call `get_random_fact()` to fetch a quirky fact. When you pass this tool result through the streaming endpoint, users see the text appear live on screen, avoiding any loading spinners. You can even let the user specify the language—`en` or `de`—right in the prompt when calling the MCP Server.

Retrieving a specific fact by ID.

Need one exact piece of trivia? Use `get_fact(id)` to pull a useless fact based on its unique identifier. This is great for widgets that need predictable content, not just random noise. The client handles this call easily; you just pass the tool's output stream into your React or Next.js component.

Generating daily trivia for a widget.

Use `get_today_fact()` to automatically fetch the fact of the day, which is perfect for site headers or personalized greetings. This function also lets you select between English and German. The process works flawlessly with Edge Functions because the tool result streams directly into your user-facing product.

Setup guide

Set up Uselessfacts 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 Uselessfacts 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 Uselessfacts 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 Uselessfacts. 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 Uselessfacts 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 Uselessfacts MCP in Vercel AI SDK

You connect to the MCP Server using `mcpClient.tools()` and pass it into your stream function. The data comes back as a stream, meaning users see the fact appear character by character in real time.

This MCP Server only touches useless facts (strings). Since it's read-only trivia, there are no write operations or sensitive records involved. You just get the text.

Yep. Both `get_random_fact()` and `get_today_fact()` let you pass 'de' as the language parameter, so your streaming UI will show facts in German.

The best part of using this MCP Server with Vercel AI SDK is the live data stream. It lets you build engaging user experiences where the trivia appears instantly, not after a slow loading spinner.

Absolutely. By using `get_fact(id)`, you can pull any piece of useless trivia if you know the exact ID. It gives you precise control over the content displayed.

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