How to Use the Trefle MCP in Vercel AI SDK

Q: How do I search for species with Trefle and Vercel AI SDK?

Just call searchspecies. You give your agent the name, and it searches through every known species and sub-taxa. It's a straightforward lookup that returns all matching records immediately.

Q: Can I list all genera using Trefle and Vercel AI SDK?

Yeah, you can call listgenera. This tool gives you a complete catalog of every genus in the database. It's useful for mapping out broad taxonomic groups when you don't know the specific species name yet.

Q: Does Vercel AI SDK support bulk plant data retrieval?

It does. You can use the listspecies tool to get a complete list of all species and their associated sub-taxa in one go. This is perfect for building large reference lists.

Q: What if I need to find out about taxonomy structure using Trefle and Vercel AI SDK?

You can use listdistributions first to see all available zones, then pair that with getdistributionplants. This lets your agent map the relationship between a zone and what grows there.

Access the world's largest botanical database 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 Trefle MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Plant Distribution Data

The `get_distribution_plants` tool lets you filter plants by a specific zone. You pass query parameters, like targeting only 'native' establishments, and get a list of what grows there. This means your AI client can pinpoint exactly which species are native to a region without needing manual database queries or complex API calls.

Search for Specific Plants

Need details on one plant? The `get_plant` tool fetches specific information using the plant name. This is fast and direct, giving you data about a known species. Alternatively, if you only know the genus or want to list everything, use `list_plants`. It keeps things clean by excluding varieties and subspecies.

Manage Species Data Corrections

If the botanical records are wrong, you don't have to call a database admin. The system offers tools like `report_species_error` or `submit_species_correction`. You just pass the necessary data points through your agent. This workflow handles quality control right in the chat flow—the user tells the AI client what's wrong, and it submits the correction using these specific endpoints.

Setup guide

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

Just call `search_species`. You give your agent the name, and it searches through every known species and sub-taxa. It's a straightforward lookup that returns all matching records immediately.

Yeah, you can call `list_genera`. This tool gives you a complete catalog of every genus in the database. It's useful for mapping out broad taxonomic groups when you don't know the specific species name yet.

The primary data type this MCP Server handles is botanical classification data, including plant names, genera, and geographical distribution zones. It doesn't deal with personal user identifiers.

It does. You can use the `list_species` tool to get a complete list of all species and their associated sub-taxa in one go. This is perfect for building large reference lists.

You can use `list_distributions` first to see all available zones, then pair that with `get_distribution_plants`. This lets your agent map the relationship between a zone and what grows there.

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