How to Use the Vinsight MCP in Windsurf

Q: Can I use Vinsight and Windsurf to find contact info?

Absolutely. The searchcontacts tool lets your agent pull a profile, including payment terms and order history, for any partner. It's useful whether you're dealing with raw material suppliers or distribution clients.

Q: What data does Vinsight expose to Windsurf?

Vinsight exposes core ERP data like sales orders (listsalesorders), current inventory (liststocklevels), and production details. Your agent can access everything from searchstockitems to specific cellar capacity using listvessels.

Q: Can Vinsight help with multi-site tracking in Windsurf?

Yes. The server includes the listwarehouses tool, which manages inventory across multiple physical locations. This lets you know exactly where stock is sitting when you need to plan fulfillment or reorder.

Automate your whole operation. Use Windsurf to manage wine, beer, and spirits inventory without writing code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Vinsight MCP to Windsurf

Create your Vinkius account to connect Vinsight to Windsurf 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 Vinsight with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check Fulfillment Status

The `get_sales_order` tool retrieves complete order details for any client. Cascade can automatically check if the required items are in stock by calling `list_stock_levels` and cross-referencing product specifics using `search_stock_items`. This sequence tells you exactly what needs to be shipped or if you need more inventory.

Manage Production Flow

Need to track a whole batch? Start with the `list_production_orders` tool. Cascade then chains this by looking up the raw inputs via `list_purchase_orders` and tracking individual lots using `list_batches`. You'll get a full lifecycle view, from purchasing grapes or hops right through to bottling.

Audit Quality Control

Compliance checks are straightforward. Use `list_lab_results` to pull all quality control reports sorted by date. If you need historical data on a specific product, Cascade can also check the original product definition using `get_stock_item`. This gives your agent everything it needs to generate an audit report instantly.

Setup guide

Set up Vinsight MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Vinsight MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Vinsight payment history." If connected, Cascade will call the Vinsight tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "vinsight-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 Vinsight. 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 Vinsight 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 Vinsight MCP in Windsurf

Vinsight's MCP Server keeps track of everything. You can run a query that calls `list_stock_levels` across all locations, then cross-reference those numbers with specific product details from `search_stock_items`. It gives you real-time fulfillment data.

Absolutely. The `search_contacts` tool lets your agent pull a profile, including payment terms and order history, for any partner. It's useful whether you're dealing with raw material suppliers or distribution clients.

Vinsight exposes core ERP data like sales orders (`list_sales_orders`), current inventory (`list_stock_levels`), and production details. Your agent can access everything from `search_stock_items` to specific cellar capacity using `list_vessels`.

Yes. The server includes the `list_warehouses` tool, which manages inventory across multiple physical locations. This lets you know exactly where stock is sitting when you need to plan fulfillment or reorder.

This server touches product inventory data (SKU, description, unit of measure) and sales order records. The agent handles this structured operational data through the MCP Server.

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