TerraVault MCP

Read-only MCP server providing access to U.S. state cannabis license data, licensed store locations, California recall information, and organic grower certifications. It allows agents to look up licenses, find nearby stores, check package validity, and retrieve daily regulatory updates without requiring authentication.

Visit Bonis Systems LLC

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Bonis Systems LLC

MCP endpoint (Streamable HTTP)

https://terravaulthq.com/api/mcp

Vendor documentation

What you can do with it

Look up a cannabis or hemp business license by number or name
Find licensed cannabis stores and delivery services near a location
Check a package against California's cannabis recall list
Retrieve daily regulatory updates on license changes and recalls

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: com.terravaulthq/licenses@1.0.0 Project website

Protocol and capabilities

Server: terravault 1.0.0
MCP protocol: 2025-06-18
Tools: 7 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

TerraVault reads state cannabis license lists and answers from them. Every answer carries the state agency that published the list, the date TerraVault read it and a TerraVault page for the same facts. Read-only; no contact details are ever returned.

Tools

7 advertised

lookup_license — Look up a license

Advertised by the server during the last successful anonymous check.

Advertised read-only

Look up a cannabis or hemp business license by license number or business name on the state lists TerraVault reads (CA, CO, CT, DC, FL, IL, MA, MD, ME, MN, MO, NJ, NV, NY, OH, OR, VT, WA). Returns the license type, status as the state prints it, city and county, the date the list was read, the state's own record link and the TerraVault page. Never returns phone numbers, emails or owner details.

lookup_license input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "minLength": 3,
      "description": "A license number (e.g. C10-0000123-LIC) or part of a business name."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Optional two-letter state code."
    }
  },
  "additionalProperties": false
}

lookup_license annotations

{
  "title": "Look up a license",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

licensed_near — Licensed stores near a place

Advertised by the server during the last successful anonymous check.

Advertised read-only

Find licensed cannabis stores and delivery services near a ZIP code, or near a city in a given state, nearest first, from the state's own license lists. Each result has its distance, how the distance was measured, and its TerraVault page. A result of kind "maker" is a New York microbusiness that sells only what it grows and makes itself. A license is not a promise a store is open or has an item.

licensed_near input schema

{
  "type": "object",
  "properties": {
    "zip": {
      "type": "string",
      "pattern": "^\\d{5}(-\\d{1,4})?$",
      "description": "US ZIP code."
    },
    "city": {
      "type": "string",
      "description": "City name; give state too."
    },
    "kind": {
      "enum": [
        "store",
        "delivery",
        "any"
      ],
      "type": "string",
      "default": "any"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 1
    },
    "miles": {
      "enum": [
        10,
        25,
        50
      ],
      "type": "integer",
      "default": 25
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state code, needed with city."
    }
  },
  "additionalProperties": false
}

licensed_near annotations

{
  "title": "Licensed stores near a place",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

organic_growers — OCal organic-standard growers

Advertised by the server during the last successful anonymous check.

Advertised read-only

List cannabis growers and distributors certified under OCal, California's comparable-to-organic standard, from the state's own list, with links to their TerraVault license pages where the name matches. Optional city or county filter. California only.

organic_growers input schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional California city."
    },
    "county": {
      "type": "string",
      "description": "Optional California county, e.g. Humboldt."
    }
  },
  "additionalProperties": false
}

organic_growers annotations

{
  "title": "OCal organic-standard growers",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

state_license_counts — License counts for a state

Advertised by the server during the last successful anonymous check.

Advertised read-only

Count the active cannabis licenses on one state's list, by license type, with the date the list was last read and the state agency that publishes it.

state_license_counts input schema

{
  "type": "object",
  "required": [
    "state"
  ],
  "properties": {
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state code."
    }
  },
  "additionalProperties": false
}

state_license_counts annotations

{
  "title": "License counts for a state",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

check_recall — Check a California cannabis recall

Advertised by the server during the last successful anonymous check.

Advertised read-only

Check a cannabis package or license against California's own cannabis recall list. Give the package UID, a batch number with its maker, or a license number. Answers RECALLED only on an exact match, SOLD_RECALLED_PRODUCT when the state lists the license only as a store that sold a recalled product, NOT_IN_INDEX with the date the list was read, or NOT_CHECKED when it cannot say. Never answers that a product is safe. California only.

check_recall input schema

{
  "type": "object",
  "properties": {
    "uid": {
      "type": "string",
      "maxLength": 40,
      "minLength": 10,
      "description": "The track-and-trace UID printed on the package."
    },
    "batch": {
      "type": "string",
      "description": "The batch number on the label; give maker or licenseNumber with it."
    },
    "maker": {
      "type": "string",
      "description": "The maker or brand named on the label."
    },
    "licenseNumber": {
      "type": "string",
      "description": "A California cannabis license number."
    }
  },
  "additionalProperties": false
}

check_recall annotations

{
  "title": "Check a California cannabis recall",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

state_license_report — Monthly license report for a state

Advertised by the server during the last successful anonymous check.

Advertised read-only

One state's monthly cannabis license report from its own published list: licenses at the start and end of the month, first seen, left and came back, by license type, county and city. Reports start October 2026. Defaults to the month in progress.

state_license_report input schema

{
  "type": "object",
  "required": [
    "state"
  ],
  "properties": {
    "month": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "YYYY-MM, from 2026-10."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state code."
    }
  },
  "additionalProperties": false
}

state_license_report annotations

{
  "title": "Monthly license report for a state",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

marys_desk — Today's cannabis license and recall update

Advertised by the server during the last successful anonymous check.

Advertised read-only

Mary's Desk: TerraVault's short daily update from its own records. Licenses first seen on or gone from each state's published list since the previous update, new California cannabis recalls, and California's month-to-date license report. Every line names its source and the date it was read. Returns the latest day by default, up to the last 7.

marys_desk input schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "default": 1,
      "maximum": 7,
      "minimum": 1,
      "description": "How many recent daily entries to return."
    }
  },
  "additionalProperties": false
}

marys_desk annotations

{
  "title": "Today's cannabis license and recall update",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 642 ms
95th percentile latency: 642 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 8:59 AM UTC · probe · passed · 642 ms · metadata changed · 7 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http terravault-mcp https://terravaulthq.com/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add terravault-mcp --url https://terravaulthq.com/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable terravault-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "terravault-mcp": {
      "url": "https://terravaulthq.com/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "terravault-mcp": {
      "type": "streamableHttp",
      "url": "https://terravaulthq.com/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start terravault-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "terravault-mcp": {
      "type": "http",
      "url": "https://terravaulthq.com/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http terravault-mcp https://terravaulthq.com/api/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "terravault-mcp": {
      "url": "https://terravaulthq.com/api/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "terravault-mcp": {
      "serverUrl": "https://terravaulthq.com/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like TerraVault MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 4,443

Do you run TerraVault MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

TerraVault MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other data and analytics servers

Do you run TerraVault MCP?