How to Use the Metrc MCP in Windsurf

Q: Can I automate Metrc compliance checks in Windsurf?

Yes. Cascade can run periodic checks using listactivepackages and compare the results against your local database. It alerts you if the data drifts.

Q: Does this Metrc MCP Server handle unit conversions in Windsurf?

It does. You can invoke getunitofmeasures to ensure your local calculations match the official state definitions. This prevents unit mismatch errors during data entry.

Connect the Metrc MCP Server to Windsurf and let Cascade pull live inventory data directly into your coding workflow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Metrc MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous inventory analysis in Windsurf

Cascade reads your local codebase and connects to the `list_active_packages` endpoint to reconcile physical stock with digital records. It identifies discrepancies without you manually running individual queries. Once the agent maps your inventory, it uses `get_package_details` to verify specific batch status. This lets you debug compliance issues by watching the agent pull state data in real-time.

Rapid facility data mapping

Windsurf uses `list_facilities` to scope your environment before executing complex operations. You set the goal, and the agent determines which facility licenses apply to your current task. It handles the heavy lifting of parsing plant data via `list_tracked_plants`. You get a clean summary of growth stages without navigating the Metrc interface.

Streamlined sales and transfer tracking

Cascade chains `list_active_sales` and `list_incoming_transfers` to build a complete picture of your supply chain velocity. It tracks incoming shipments against current sales receipts autonomously. This sequence ensures your local logs match the state records. If a transfer is missing, the agent flags it immediately for your review.

Setup guide

Set up Metrc 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 Metrc 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 Metrc payment history." If connected, Cascade will call the Metrc tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

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

Add the server to your configuration file, then let Cascade discover the tools. Once connected, you can ask the agent to pull specific package details directly from the sidebar.

Yes. Cascade can run periodic checks using `list_active_packages` and compare the results against your local database. It alerts you if the data drifts.

It does. You can invoke `get_unit_of_measures` to ensure your local calculations match the official state definitions. This prevents unit mismatch errors during data entry.

Credentials reside in your local environment variables or the MCP config file. Vinkius never touches your keys; they remain strictly on your machine.

Your package and plant data stays local to your machine. The server facilitates the connection, but your sensitive inventory information never leaves your secure environment.

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