How to Use the Trefle MCP in Mastra AI

Q: How do I find all available plant genera using Trefle and Mastra AI?

Use listgenera. The tool provides a definitive list of every genus in the botanical records. This is useful for initializing a workflow that needs to iterate over major groups.

Q: Can I check if a plant species exists using Trefle and Mastra AI?

Yes, call getspecies with the name you suspect. If data returns, the species is listed. It's simple verification that keeps your automated process moving.

Q: If I want to list all main plants for a report using Trefle and Mastra AI?

The listplants tool handles this by giving you a clean roster of species, while filtering out varieties or subspecies. This keeps your final output very focused.

Q: How do I submit corrections for taxonomy data using Trefle and Mastra AI?

You use submitspeciescorrection. Your agent sends the specific erroneous details to this endpoint, letting you build a workflow that handles continuous data quality checks.

Build complex botanical workflows with Trefle on Mastra AI.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Specific Plant Details

The `get_plant` tool retrieves full details for a single, specific plant. You pass the name, and your agent returns all associated data points. This is ideal when your workflow needs to pull concrete facts about one item. It's designed for multi-step processes: find out what you need, then use that fact in the next step of your automated routine.

Search and Correct Taxonomy Records

If a species entry is wrong, don't stop the workflow. You can automatically route data through `report_species_error` or `submit_species_correction`. These tools allow your Mastra AI agent to handle necessary database upkeep. Or, if you just need information, use `search_plants` or `search_species` to quickly find records across the entire database.

Map Global Plant Distribution

Need to know what grows where? The `get_distribution_plants` tool filters the world's data by a zone. You specify criteria, like filtering for 'native' life forms, and get the results. This capability is perfect for complex conditional branching: IF the user specifies Zone X, THEN check which native plants are found there.

Setup guide

Set up Trefle MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Trefle tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "trefle-mcp-client",
  servers: {
    "trefle-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Trefle Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Trefle tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Trefle transactions"
);
console.log(result.text);

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 Mastra AI

Use `list_genera`. The tool provides a definitive list of every genus in the botanical records. This is useful for initializing a workflow that needs to iterate over major groups.

Yes, call `get_species` with the name you suspect. If data returns, the species is listed. It's simple verification that keeps your automated process moving.

The server primarily accesses botanical records: plant names, species details, and geographical distribution zones. There are no personal user identifiers involved in the tool calls.

The `list_plants` tool handles this by giving you a clean roster of species, while filtering out varieties or subspecies. This keeps your final output very focused.

You use `submit_species_correction`. Your agent sends the specific erroneous details to this endpoint, letting you build a workflow that handles continuous data quality checks.

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