How to Use the TurfHop MCP in Mastra AI

Q: How does TurfHop integrate with Mastra AI?

You use mcpClient.listTools() and spread those tools into your agent's tool set. Mastra AI handles the connection, allowing complex workflows that run across multiple servers.

Q: What data can I retrieve using TurfHop with Mastra AI?

You can get comprehensive lists of service jobs via listjobs, or check out all available products and services by calling listproducts. The agent manages these multiple calls.

Q: Can I update records using TurfHop with Mastra AI?

Yes. You'll use tools like updatejob or updatecustomer. Because it supports conditional branching, you can write logic that only updates a record if certain criteria are met.

Q: What if I need billing info using TurfHop with Mastra AI?

You'll use the invoicing tools. Call listinvoices to see everything, or get the specifics of one bill using getinvoice. The framework ensures reliable data access.

Build complex, reliable workflows for lawn care operations using your AI client in 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 TurfHop MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate customer onboarding with TurfHop's profile tools.

Your agent can build a multi-step process: first, it runs `create_customer` to add the new account. Then, if needed, it calls `update_customer` later in the flow to tweak details. Mastra AI handles these steps with automatic retries. This means even if an API call fails temporarily, your workflow won't crash; it'll automatically try again until it gets the data.

Manage job creation and status updates via MCP Server calls.

Need to schedule a service? The agent uses `create_job` with all the required data. It can then check the resulting status using `get_job`. Mastra AI ensures that if one part fails, it notifies an admin instead of just stopping. It's built for complex, multi-step operations where failure handling is everything.

Handle billing cycles with controlled data retrieval.

To process payments, the agent first calls `list_quotes` to get pricing options. Next, it retrieves specific records using `get_invoice`. If payment fails, Mastra AI can trigger a conditional branch—like sending an alert or retrying later. This reliability makes it perfect for mission-critical finance flows.

Setup guide

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

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

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

You use `mcpClient.listTools()` and spread those tools into your agent's tool set. Mastra AI handles the connection, allowing complex workflows that run across multiple servers.

You can get comprehensive lists of service jobs via `list_jobs`, or check out all available products and services by calling `list_products`. The agent manages these multiple calls.

Yes. You'll use tools like `update_job` or `update_customer`. Because it supports conditional branching, you can write logic that only updates a record if certain criteria are met.

You'll use the invoicing tools. Call `list_invoices` to see everything, or get the specifics of one bill using `get_invoice`. The framework ensures reliable data access.

The server manages billing information, specifically invoice details and quote records. It also tracks operational job status updates.

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