How to Use the Cloverly MCP in Mastra AI

Q: How do I register the Cloverly MCP Server in Mastra AI?

Install @mastra/mcp and instantiate new MCPClient with the Vinkius server URL. Call mcpClient.listTools() and spread them directly into your Mastra agent's tool array.

Q: Can I run Cloverly operations inside Mastra AI workflows?

Yes. You can wrap tools like createestimate inside Mastra workflow steps to handle conditional branching and automatic retries.

Q: How do I handle transaction approvals with Cloverly in Mastra AI?

Use Mastra's requireToolApproval configuration on this MCP Server. This halts the agent workflow until a human approves the offset cost.

Q: How does the agent select specific offset projects?

The agent calls listprojects to fetch active environmental initiatives. It can then filter these projects by type or location before calling createpurchase.

Automate multi-step carbon offset workflows with Mastra AI and Cloverly.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cloverly MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Offset Purchasing Workflows in Mastra AI

`create_purchase` acts as the final step in your automated Mastra agent workflows when executing corporate carbon mitigation strategies. You register this MCP Server using `new MCPClient` and spread the tools into your agent definition. If a purchase fails due to network issues, Mastra's built-in workflow engine retries the call with exponential backoff. The agent relies on `check_cloverly_status` to check if the endpoint is online before attempting the transaction again.

Human-in-the-Loop Carbon Approvals

`create_estimate` generates the carbon footprint calculation, which you can hold for manual review before buying. By using Mastra's `requireToolApproval` setting with this MCP Server, you prevent your agent from spending real money on offsets without a green light. Mastra's pipeline logs the approved `create_purchase` payload so your environmental ledger remains fully audited.

Conditional Environmental Audits

`get_impact_summary` gets your historical offset data to feed Mastra's conditional branching logic. If your monthly emissions exceed a specific threshold, the workflow automatically branches to buy more credits from specific projects. The agent uses `list_projects` to find local carbon offset programs that match your corporate sustainability criteria. This lets you build self-correcting environmental compliance loops that run entirely on autopilot.

Setup guide

Set up Cloverly 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 Cloverly 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: "cloverly-mcp-client",
  servers: {
    "cloverly-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Cloverly 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 Cloverly. 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 Cloverly 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 Cloverly MCP in Mastra AI

Install `@mastra/mcp` and instantiate `new MCPClient` with the Vinkius server URL. Call `mcpClient.listTools()` and spread them directly into your Mastra agent's tool array.

Yes. You can wrap tools like `create_estimate` inside Mastra workflow steps to handle conditional branching and automatic retries.

Use Mastra's `requireToolApproval` configuration on this MCP Server. This halts the agent workflow until a human approves the offset cost.

The agent calls `list_projects` to fetch active environmental initiatives. It can then filter these projects by type or location before calling `create_purchase`.

Vinkius runs each query inside isolated V8 sandboxes. Your carbon calculations and financial transaction records are never logged, 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