How to Use the Metrc MCP in Claude

Pull live Metrc cannabis track-and-trace data directly into your Claude Desktop conversations to audit compliance on the fly.

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 Claude Desktop

Create your Vinkius account to connect Metrc to Claude Desktop 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 Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live plant tracking in Claude Desktop

`list_tracked_plants` pulls your current plant inventory directly into your chat window. You can ask your agent to cross-reference this list with live growth cycles or flag plants that are overdue for transition. It queries your active facility database to give you a clear look at what is sitting in your rooms right now. To see what is ready for processing, the `list_active_harvests` tool pulls wet weights and harvest dates. This lets you spot drying bottlenecks or drying-room overages without logging into the state portal. Your agent can run these checks locally using stdio or via a secure remote connection.

Verify package details and inventory items

`get_package_details` fetches the exact status, quantity, and lab testing results for any active package ID. Instead of copy-pasting long tag strings, you paste the tag into Claude Desktop and let the MCP Server retrieve the registration details from the state registry. You can also run `list_active_items` to check your product catalog against physical inventory. Your agent maps these items against `get_unit_of_measures` to verify that packaging labels show the correct weight formats before they go out the door.

Audit sales and incoming transfers in real time

`list_active_sales` pulls your current day's receipts directly into your workspace. Your agent can scan these records to verify that transaction limits match state regulations. It keeps your compliance officer happy because you can catch mistakes before they get logged permanently. Use `list_incoming_transfers` to see what shipments are heading to your facility. This lets your team plan intake schedules and verify manifest numbers before the delivery truck arrives at your loading dock.

Setup guide

Set up Metrc MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Metrc MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Metrc MCP configuration

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

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under metrc-mcp.

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 Claude Desktop

Open your local config file and add the server settings under the mcpServers key. Once you save and restart the app, the tools will show up under the hammer icon in your chat window.

Yes, you can add it as a custom connector in your browser settings. Paste the remote URL, run through the authentication step, and your agent can call the track-and-trace tools directly.

The server handles rate limit headers directly. If your agent calls `list_active_packages` too quickly, the server pauses the requests to keep your license key from getting temporarily blocked.

Your agent will receive an authentication error from the API. You will need to update your user API key in your configuration file or web connector settings to restore access.

Your track-and-trace data, including facility details and plant counts, stays local to your machine. It only travels directly between your client and the state endpoint, with no third-party databases sitting in the middle.

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