How to Use the Donately MCP in Vercel AI SDK

Q: How do I stream Donately transaction records using the Vercel AI SDK?

You register the listalldonations tool inside the MCP Server setup. The Vercel AI SDK then lets your model query transaction histories and stream the formatted results directly into your React frontend.

Q: Can the Vercel AI SDK filter Donately campaigns dynamically?

Yes. Your agent uses listfundraisingcampaigns to fetch the raw campaign data, then the Vercel AI SDK streams the filtered list directly to your UI to prevent loading lag.

Q: How does Vercel AI SDK handle Donately donor searches?

The agent calls searchdonationsbyemail when a user enters an email address. The Vercel AI SDK processes this tool call on the edge and streams the matching donation records directly to the screen.

Q: Do I need to manage state when listing highest lifetime donors?

No, the listhighestlifetimedonors tool returns the sorted list directly to the model. The SDK handles the streaming state automatically, so the raw data maps straight to your UI without extra state management code.

Feed real-time donor records and campaign stats straight into your Next.js UI using the 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 Donately MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Donor Lookup via MCP Server

Your application retrieves real-time donor profiles using `get_donor_profile` to render giving history instantly. As your user types an email, the Vercel AI SDK streams the donor's lifetime contributions and contact details directly into the React component without forcing page reloads. This setup avoids the typical lag of waiting for a backend API to resolve before updating the view. Instead, the raw JSON payload from `list_active_donors` feeds straight into the LLM context, which immediately formats the donor's history for the user.

Real-Time Campaign Progress Widgets

The `get_campaign_performance_summary` tool pulls current fundraising numbers directly into your streaming UI components. Your AI client reads the campaign goals and current progress to generate dynamic, live-updating progress summaries on the fly. By coupling this tool with the Vercel AI SDK, you can build interactive dashboards that update as the model reasons. The agent queries `list_fundraising_campaigns` to find active initiatives and updates the user interface step-by-step as the data streams in.

Instant Contribution Feeds

Checking recent transactions happens instantly when your frontend agent invokes `list_latest_contributions`. The Vercel AI SDK handles the streaming output, allowing the agent to render a live ledger of recent support as it receives the raw database records. If a user asks about a specific transaction, the agent uses `get_donation_details` to pull the exact dollar amount and processing status. You don't have to build custom API endpoints for every query type since the SDK maps these tools directly to your UI components.

Setup guide

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

You register the `list_all_donations` tool inside the MCP Server setup. The Vercel AI SDK then lets your model query transaction histories and stream the formatted results directly into your React frontend.

Yes. Your agent uses `list_fundraising_campaigns` to fetch the raw campaign data, then the Vercel AI SDK streams the filtered list directly to your UI to prevent loading lag.

The agent calls `search_donations_by_email` when a user enters an email address. The Vercel AI SDK processes this tool call on the edge and streams the matching donation records directly to the screen.

No, the `list_highest_lifetime_donors` tool returns the sorted list directly to the model. The SDK handles the streaming state automatically, so the raw data maps straight to your UI without extra state management code.

All requests for donor profiles and giving history go through an ephemeral V8 sandbox on Vinkius. Your Vercel AI SDK client connects using a single secure token, meaning sensitive emails and transaction data are never cached or exposed to third parties.

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