How to Use the Basis Calculator MCP in Cursor

Q: How do I set up the Basis Calculator for my Cursor project?

Add the Basis Calculator MCP to your .cursor/mcp.json file in your project's root directory. Once configured, your AI agent in Cursor can immediately start using its tools to analyze commodity basis.

Inject real-time basis analysis directly into your code with Cursor. Stop mocking data and start building with live market context.

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 Cursor

Create your Vinkius account to connect Basis Calculator to Cursor — 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Code with Live Basis Data

This MCP gives your Cursor agent the ability to calculate commodity basis on the fly. The `calculate_current_basis` tool takes a local cash price and a futures price and returns the exact basis value. Your agent can then inject this number directly into your code. It's perfect for building trading models, backtesting strategies, or creating analytics dashboards without ever leaving your editor.

Your Cursor Agent Now Knows History

Need to see how a strategy would have performed in the past? The `get_historical_averages` tool lets your agent fetch historical basis data for specific commodities and regions from this MCP server. The agent can use this data to generate test cases, populate data frames, or even write functions that compare current conditions to past performance. No more hardcoding stale data into your test files.

Factor Seasonality into Your Models

Basis isn't random; it follows predictable seasonal patterns. With the `get_seasonality_trend` tool, your agent can retrieve the expected basis movement for any time of year. This lets you build more sophisticated models that account for things like harvest pressure or post-harvest rallies. Your AI agent can generate code that graphs these trends or flags when current market behavior deviates from the norm.

Setup guide

Set up Basis Calculator MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Basis Calculator MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Basis Calculator transactions." If the MCP tools are loaded correctly, Cursor will call the Basis Calculator tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "basis-calculator-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Cursor

Add the Basis Calculator MCP to your `.cursor/mcp.json` file in your project's root directory. Once configured, your AI agent in Cursor can immediately start using its tools to analyze commodity basis.

It can generate Python scripts for data analysis with pandas, create JavaScript functions for a web dashboard, or build SQL queries to insert basis data into a database. The agent uses the live tool output to write working code.

It provides the data to make that decision. You can ask your agent to use the Basis Calculator to compare the current basis to historical averages and seasonal trends, giving you a data-driven reason to sell or hold.

Not at all. It's also great for one-off analysis. You can just open a chat, ask the agent to run a basis calculation, and get the answer without writing a single line of permanent code.

The physical and futures prices you provide are sent to the MCP for calculation and then discarded. The connection is secured, and Vinkius doesn't log or retain your specific price inputs. Your data's privacy is based on this stateless processing.

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