How to Use the FreeAgent MCP in Vercel AI SDK

Q: Can I build a React component that shows live FreeAgent bank transactions?

Yes, that's exactly what this is for. Your agent uses the listbanktransactions tool, and you use the useUIState hook from the Vercel AI SDK to render the transaction data as it streams in. Each transaction can appear in your list the moment the agent finds it.

Q: How is my financial data handled with FreeAgent and the Vercel AI SDK?

Your FreeAgent data, including records from listinvoices and getprofitandloss, is streamed through an ephemeral, sandboxed environment on its way to your client. Vinkius does not store the content of your financial data. The connection is encrypted end-to-end, and your Vercel AI SDK client only holds the data in-memory for rendering.

Build live financial dashboards with FreeAgent data streaming directly into your 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 FreeAgent MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Profit & Loss in Real-Time

This tool lets you build a UI that shows financial data as it arrives. Call `get_profit_and_loss` and stream the results directly into a React component. Your user doesn't watch a loading spinner—they see the numbers for revenue, costs, and profit appear on their screen instantly. Forget about the old fetch-then-render pattern. With the Vercel AI SDK, you connect your agent's work directly to the frontend. It's perfect for building interactive financial summaries or dashboards where live data is the main event, not an afterthought.

Build Interactive Invoice Lookups

Give your users a way to check on their invoices without leaving your app. An agent armed with `get_invoice_details` and `list_invoices` can answer questions like "show me my last three invoices" conversationally. The data streams back, populating your UI one field at a time. This isn't just for displaying data. You can build interfaces where users can query their entire sales history. The Vercel AI SDK makes the connection between your FreeAgent account and your Next.js frontend feel immediate.

Your FreeAgent MCP Server Dashboard

You can pull from multiple FreeAgent endpoints at once. Have your agent fetch recent bank activity with `list_bank_transactions` while also getting a list of client contacts using `list_contacts`. It's all managed through a single MCP Server connection. The AI SDK is built to handle multiple data streams. You can render the transaction list in one part of your UI and the contact list in another, with both updating as the data flows in. It's how you build a truly responsive financial dashboard.

Setup guide

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

You'll use the Vinkius endpoint URL for this FreeAgent MCP server when you initialize `createMCPClient`. Pass that client's `tools()` method to `streamText` or `generateText`. That's it—the SDK handles the connection and makes the tools available to your agent.

Yes, that's exactly what this is for. Your agent uses the `list_bank_transactions` tool, and you use the `useUIState` hook from the Vercel AI SDK to render the transaction data as it streams in. Each transaction can appear in your list the moment the agent finds it.

Absolutely. Your connection uses a single Vinkius token. The MCP server runs in a sandboxed environment, and your FreeAgent credentials are never exposed to the client.

You can build anything from conversational accounting bots to real-time P&L dashboards. Since the tools let you `get_invoice_details` and `list_contacts`, you can create user-facing portals where clients can check their own account status without needing to log into FreeAgent.

Your FreeAgent data, including records from `list_invoices` and `get_profit_and_loss`, is streamed through an ephemeral, sandboxed environment on its way to your client. Vinkius does not store the content of your financial data. The connection is encrypted end-to-end, and your Vercel AI SDK client only holds the data in-memory for rendering.

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