How to Use the Basis Calculator MCP in Mastra AI

Build resilient, auto-retrying commodity trading workflows using Mastra AI and this agricultural basis engine.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Basis Calculator MCP to Mastra AI

Create your Vinkius account to connect Basis Calculator to Mastra AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Basis Calculator with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Execute reliable basis calculations with Mastra AI

The `calculate_current_basis` tool determines the spread between local cash prices and active futures contracts. It returns a clear classification of whether the market is Above Parity or Below Parity to guide your automated trading rules. Using Mastra AI, you don't have to write complex error handlers. If the basis is positive, the agent triggers a sale; if negative, it waits and retries the calculation later.

Compare current spreads against historical baselines

The `get_historical_averages` tool pulls localized historical basis data for specific commodities. Your workflow engine uses this data to verify if a high local price is actually a seasonal anomaly or a genuine buying opportunity. Mastra AI handles these heavy data lookups during workflow execution. The engine automatically retries the request with exponential backoff if a network hiccup occurs, ensuring your agent never makes decisions on stale data.

Map seasonal crop cycles into your agent workflows

The `get_seasonality_trend` tool identifies the expected basis movement pattern for any given period in the agricultural cycle. Your autonomous agents use this pattern to forecast whether local cash prices will strengthen or weaken in the coming weeks. This MCP integrates directly with Mastra AI workflows. You can deploy the entire setup to any cloud provider with a single command, giving your systems continuous access to agricultural trends.

Setup guide

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

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

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

Install @mastra/mcp and instantiate a new MCPClient pointing to the hosted URL. You can then list the tools and spread them directly into your agent definition.

Yes, Mastra AI has a built-in workflow engine that automatically retries failed tool calls. If a network issue interrupts your cash-to-futures calculation, the system uses exponential backoff to try again.

You can use the requireToolApproval setting in Mastra AI to pause the workflow before any trade is executed based on the basis calculation.

You can deploy your entire agent configuration, including the connection to this MCP, using Mastra's single-command deployment tool. It runs on any major cloud provider out of the box.

Yes. The system only processes the raw physical prices and futures figures you send to it. No local transaction history, private spreadsheet data, or farm-specific identifiers are written to disk or shared with outside 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