How to Use the OpenTHC MCP in Windsurf

Q: How do I install the OpenTHC MCP Server in Windsurf?

Open your MCP Servers UI under Settings, or edit the mcpconfig.json file directly. Cascade auto-discovers the compliance tools the second you hit refresh.

Q: Can Windsurf and OpenTHC automatically fix state API sync errors?

Yes. Cascade can query listinventory to find stock mismatches and write the exact JSON payload you need to patch the state database. You review the code and hit approve.

Connect OpenTHC to Windsurf and let Cascade autonomously audit your cannabis supply chain without writing a single script.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect OpenTHC MCP to Windsurf

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

GDPR Included with Plan

Setup OpenTHC with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Autopilot your state compliance audits

The `list_plants` tool pulls active cultivation data including POP/PIP tags, growth stages, and room locations. Windsurf takes this data and immediately checks it against your stock using `list_inventory` to find missing tags before state regulators do. Cascade doesn't wait for you to prompt the next step. It reads the discrepancy, queries `list_sections` to pinpoint the exact physical room where the count dropped, and generates a reconciliation report. You just watch the output terminal.

Validate B2B transfers in Windsurf

The `list_b2b_transactions` tool grabs every incoming and outgoing transfer manifest, including counterparty details and expected fulfillment dates. Cascade chains this with `list_companies` to verify the receiving entity holds an active registration. If a transfer looks suspicious, the agent automatically runs `list_lab_results` against the attached line items. It checks THC/CBD potency and contaminant levels, blocking the transfer script if it finds a failed Certificate of Analysis.

OpenTHC MCP Server sales reconciliation

The `list_b2c_transactions` tool fetches daily retail sales, breaking down line items, tax calculations, and dispensary locations. Windsurf uses this to map out daily revenue against physical stock deductions. When a product count drifts, Cascade automatically calls `list_products` and `list_varieties` to cross-reference SKUs and genetic types. It builds a complete audit trail of where a specific strain went, from the retail floor back to the seed.

Setup guide

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

mcp_config.json

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

Open your MCP Servers UI under Settings, or edit the mcp_config.json file directly. Cascade auto-discovers the compliance tools the second you hit refresh.

Yes. Cascade can query list_inventory to find stock mismatches and write the exact JSON payload you need to patch the state database. You review the code and hit approve.

Cascade handles the 429 responses natively. It pauses execution, waits for the penalty window to clear, and resumes pulling list_lab_samples right where it left off.

No. You tell Cascade to run a full facility audit. It autonomously chains list_licenses, list_plants, and list_sections without asking for permission between calls.

Windsurf routes your Certificate of Analysis documents and THC potency metrics strictly through local memory. The MCP connection runs inside a V8 Isolate Sandbox, meaning your lab data never touches third-party training servers.

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