How to Use the Goodreads MCP in Vercel AI SDK

Q: Can I use the Goodreads MCP Server to show user shelves?

Yes, you call getusershelveslist through your agent. It returns the user's collection, which you can then stream directly into your UI components.

Stream real-time book data and reader insights directly into your Vercel AI SDK frontends with this Goodreads 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 Goodreads MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live book discovery in Vercel AI SDK

Feed your UI with live metadata using `search_books` and `get_book_info`. You get the exact details needed to populate cards or lists without waiting for a backend fetch. Your app handles the stream, so users see book titles and author names appear as the AI agent parses the query. It keeps the interface snappy and responsive.

Auditing reviews via MCP Server

Expose `get_user_reviews` to your agent to surface qualitative feedback from readers. It turns raw text into structured data that your React or Next.js components can render instantly. This bypasses the need for complex internal state management. You just pass the MCP tool output into your streaming function and let the client handle the rest.

Mapping author catalogs

Connect `list_author_books` and `get_author_profile` to build deep research agents. Your users can ask for a full bibliography or specific career highlights. Everything happens in the browser context. By keeping the data flow direct, you avoid the latency typical of multi-hop API architectures.

Setup guide

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

You instantiate the client and pass the tools to your streamText call. The MCP Server acts as the bridge for your agent to query the catalog.

Yes, you call `get_user_shelves_list` through your agent. It returns the user's collection, which you can then stream directly into your UI components.

No, this server fetches live data on every request. You control the caching layer in your own application logic to save on API usage.

The server manages the connection for you. You just need to point your agent at the endpoint provided by the Vinkius hosting environment.

Your queries stay between your agent and the endpoint. We enforce zero-trust isolation so your specific book search history remains private and ephemeral.

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