ExplorationMaps

Official3 toolsLive

by coltongriffith · JavaScript

Mining claim search and professional mineral exploration maps from public registries.

The Model Context Protocol (MCP) server io.github.coltongriffith/explorationmaps supports mining-claim search and the retrieval of professional mineral exploration maps from public registries. Its purpose is to help locate relevant mining and exploration information based on data available in those public sources.

🛠️ Key Features

Mining claim search
Professional mineral exploration map retrieval
Data sourced from public registries

🚀 Use Cases

Searching for mining claims using public registry information
Finding professional mineral exploration maps for reference or review

⚡ Developer Benefits

Provides MCP access to claim search and exploration map data
Integrates public-registry–backed mining and exploration resources into developer workflows

⚠️ Limitations

Limited to information available in public registries
Scope is centered on mining claims and mineral exploration maps

Captured live from the server via tools/list.

preview_exploration_map

Create a branded mineral exploration map from public registry claims and return a shareable URL. Provide at least one of search, location or claim_numbers. For a specific project, search its claims first and pass exact claim_numbers. Supply published facts and branding when known; never invent ownership, targets, grades or coordinates. Supports separate neighbouring claims, a project callout, locator inset, and map basemap selection. Drill and NI 43-101 layouts require user-supplied data or qualified review; this tool does not generate drill results. Free use allows 10 previews per hour; allowance in the result reports how many remain.

Parameters18

map_type	string	optional	The mining-specific map format to create.
title	string	optional	Optional finished-map title.
subtitle	string	optional	Optional subtitle shown in the map frame.
jurisdiction	string	optional	Mineral-registry jurisdiction.
search	object	optional
location	object	optional
claim_numbers	array	optional	Exact claim identifiers to map. Overrides search selection; all requested claims must be found.
include	any	optional	Reference overlays. "all" enables those that suit the basemap: labels and rail always, roads/settlements only on white or light_grey, geology except on satellite. Pass a list to choose exactly.
style	string	optional	ExplorationMaps visual theme.
company	object	optional
basemap	string	optional	Main map basemap. Defaults by map type; geology uses the published bedrock overlay.
basemap_opacity	number	optional
inset	object	optional
neighbours	object	optional
branding	object	optional
facts_panel	object	optional	Verified, published project facts, drawn in the project callout. claims must equal the number of mapped claims.
claims_callout	object	optional
annotations	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "map_type": {
      "type": "string",
      "enum": [
        "claims",
        "investor",
        "infrastructure"
      ],
      "default": "investor",
      "description": "The mining-specific map format to create."
    },
    "title": {
      "type": "string",
      "maxLength": 160,
      "description": "Optional finished-map title."
    },
    "subtitle": {
      "type": "string",
      "maxLength": 160,
      "description": "Optional subtitle shown in the map frame."
    },
    "jurisdiction": {
      "type": "string",
      "enum": [
        "bc",
        "on",
        "qc",
        "sk",
        "mb",
        "nl",
        "yt",
        "us-nv",
        "us-az",
        "us-ut",
        "us-id",
        "us-mt",
        "us-wy",
        "us-co",
        "us-nm",
        "us-ca",
        "us-or",
        "us-wa"
      ],
      "default": "bc",
      "description": "Mineral-registry jurisdiction."
    },
    "search": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "query"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "company",
            "number",
            "name"
          ],
          "default": "company",
          "description": "Search by claim holder/company, claim number, or claim name."
        },
        "query": {
          "type": "string",
          "minLength": 2,
          "maxLength": 120,
          "description": "Company/holder name, claim number, or claim name."
        }
      }
    },
    "location": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "bbox"
      ],
      "properties": {
        "bbox": {
          "type": "array",
          "minItems": 4,
          "maxItems": 4,
          "items": {
            "type": "number"
          },
          "description": "Optional [minLng,minLat,maxLng,maxLat] bounding box instead of a text search."
        }
      }
    },
    "claim_numbers": {
      "type": "array",
      "minItems": 1,
      "maxItems": 40,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9.-]{1,40}$"
      },
      "description": "Exact claim identifiers to map. Overrides search selection; all requested claims must be found."
    },
    "include": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "all"
          ]
        },
        {
          "type": "array",
          "uniqueItems": true,
          "maxItems": 8,
          "items": {
            "type": "string",
            "enum": [
              "claims",
              "roads",
              "settlements",
              "labels",
              "rail",
              "geology"
            ]
          }
        }
      ],
      "default": "all",
      "description": "Reference overlays. \"all\" enables those that suit the basemap: labels and rail always, roads/settlements only on white or light_grey, geology except on satellite. Pass a list to choose exactly."
    },
    "style": {
      "type": "string",
      "enum": [
        "investor_clean",
        "technical_sharp",
        "modern_dark",
        "warm_terrain"
      ],
      "default": "investor_clean",
      "description": "ExplorationMaps visual theme."
    },
    "company": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 160
        }
      }
    },
    "basemap": {
      "type": "string",
      "enum": [
        "white",
        "light_grey",
        "dark",
        "terrain",
        "topo",
        "satellite",
        "satellite_hybrid",
        "hillshade",
        "geology"
      ],
      "description": "Main map basemap. Defaults by map type; geology uses the published bedrock overlay."
    },
    "basemap_opacity": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 1
    },
    "inset": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "show": {
          "type": "boolean",
          "default": true
        },
        "basemap": {
          "type": "string",
          "enum": [
            "white",
            "light_grey",
            "dark",
            "terrain",
            "topo",
            "satellite",
            "satellite_hybrid",
            "hillshade",
            "geology"
          ]
        }
      }
    },
    "neighbours": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "show": {
          "type": "boolean",
          "default": true
        },
        "label_holders": {
          "type": "boolean",
          "default": true
        },
        "max_holders": {
          "type": "integer",
          "minimum": 0,
          "maximum": 8
        }
      }
    },
    "branding": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "website": {
          "type": "string",
          "format": "uri"
        },
        "logo_url": {
          "type": "string",
          "format": "uri"
        },
        "logo_url_dark": {
          "type": "string",
          "format": "uri"
        },
        "primary_color": {
          "type": "string",
          "pattern": "^#[0-9a-fA-F]{6}$"
        },
        "accent_color": {
          "type": "string",
          "pattern": "^#[0-9a-fA-F]{6}$"
        },
        "font": {
          "type": "string",
          "maxLength": 80
        }
      }
    },
    "facts_panel": {
      "type": "object",
      "additionalProperties": false,
      "description": "Verified, published project facts, drawn in the project callout. claims must equal the number of mapped claims.",
      "properties": {
        "project": {
          "type": "string"
        },
        "claims": {
          "type": "integer"
        },
        "hectares": {
          "type": "number"
        },
        "commodity": {
          "type": "string"
        },
        "ownership": {
          "type": "string"
        },
        "access": {
          "type": "string"
        },
        "tickers": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "claims_callout": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "show": {
          "type": "boolean",
          "default": true
        },
        "anchor": {
          "type": "string",
          "enum": [
            "auto"
          ]
        },
        "fields": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        "source_note": {
          "type": "string"
        },
        "style": {
          "type": "string",
          "enum": [
            "brand",
            "technical",
            "minimal"
          ]
        }
      }
    },
    "annotations": {
      "type": "array",
      "maxItems": 30,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "type",
          "label",
          "lat",
          "lng"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "target",
              "airstrip",
              "camp",
              "mine",
              "deposit",
              "other"
            ]
          },
          "label": {
            "type": "string"
          },
          "lat": {
            "type": "number"
          },
          "lng": {
            "type": "number"
          }
        }
      }
    }
  },
  "additionalProperties": false
}

search_mineral_claims

Search public mineral-claim registries by holder, exact claim number, claim name, or geographic bounding box; provide query, bbox, or both. Claim-name search is available for British Columbia and US BLM jurisdictions. Returns claim number as a string, name, holder, status, expiry, area and centroid when the registry supplies them. Cluster results geographically before selecting a specific project. Results are informational, not a legal title opinion or survey.

Parameters5

jurisdiction	string	required	Mineral-registry jurisdiction.
search_type	string	optional	Search by holder/company, claim number, or claim name.
query	string	optional	Company/holder name, claim number, or claim name.
bbox	array	optional	Optional [minLng,minLat,maxLng,maxLat] spatial query.
limit	integer	optional	Maximum claim summaries returned to the model.

Raw schema

{
  "type": "object",
  "properties": {
    "jurisdiction": {
      "type": "string",
      "enum": [
        "bc",
        "on",
        "qc",
        "sk",
        "mb",
        "nl",
        "yt",
        "us-nv",
        "us-az",
        "us-ut",
        "us-id",
        "us-mt",
        "us-wy",
        "us-co",
        "us-nm",
        "us-ca",
        "us-or",
        "us-wa"
      ],
      "description": "Mineral-registry jurisdiction."
    },
    "search_type": {
      "type": "string",
      "enum": [
        "company",
        "number",
        "name"
      ],
      "default": "company",
      "description": "Search by holder/company, claim number, or claim name."
    },
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Company/holder name, claim number, or claim name."
    },
    "bbox": {
      "type": "array",
      "minItems": 4,
      "maxItems": 4,
      "items": {
        "type": "number"
      },
      "description": "Optional [minLng,minLat,maxLng,maxLat] spatial query."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25,
      "description": "Maximum claim summaries returned to the model."
    }
  },
  "required": [
    "jurisdiction"
  ],
  "additionalProperties": false
}

get_mapping_capabilities

Return the map types, mineral-registry jurisdictions, context overlays, search modes, and styles supported by ExplorationMaps. Use this when deciding whether ExplorationMaps can fulfill a mapping request or when a jurisdiction is unclear.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

README.md10 KBView on GitHub

Exploration Maps

Browser-based map builder for mineral exploration: search provincial claim registries, import drill/geology data, style investor-ready maps, and export them as PNG/SVG/PDF. Live at explorationmaps.com.

Stack

Frontend: React 18 + Vite 5 single-page app (src/), Leaflet map engine
Backend: Supabase (auth, Postgres, RLS) + Vercel serverless functions (api/)
Static marketing content: generated blog + company pages under public/ (see scripts/generate-blog.js and scripts/pseo/)

Requirements

Node 20+ (Vite 5 requirement; dev/CI verified on Node 20/22)
npm (a package-lock.json is committed — use npm ci for reproducible installs)

Development

bash

npm ci                 # install exactly the locked dependencies
cp .env.example .env   # fill in the VITE_ variables (see below)
npm run dev            # Vite dev server on http://localhost:5173

The serverless functions under api/ run on Vercel. For full-stack local work use vercel dev; with plain npm run dev the claims search and analytics endpoints are absent (the UI degrades gracefully).

Commands

Command	What it does
`npm run dev`	Vite dev server
`npm run build`	Generates the blog, builds to `dist/`, copies the admin shell
`npm test`	Vitest run (CI mode)
`npm run test:watch`	Vitest watch mode
`npm run pseo:fixture`	pSEO company-pages pipeline against fixture data

Environment variables

Documented in .env.example. Summary:

Public (VITE_ — compiled into the client bundle, never secret):

VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY — Supabase project + anon key (production-required; without them auth/cloud features disable themselves)
VITE_ADMIN_EMAIL — controls admin dashboard visibility only; real authorization is server-side (admin_users table + is_admin())

Server-only secrets (set in Vercel, never referenced by client code):

SUPABASE_SERVICE_ROLE_KEY — used by /api/track for analytics ingestion. Production-required once migration 20260710000004 is applied.
ADMIN_API_SECRET — optional; unlocks the claims-API diagnostic modes in production via the x-admin-secret header.
SUPABASE_URL / SUPABASE_ANON_KEY — optional server-side aliases; the VITE_-prefixed values are used as fallbacks by api/claims.js (Quebec) and api/track.js.
STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, STRIPE_PRICE_MONTHLY_ID, STRIPE_PRICE_YEARLY_ID — Pro-subscription billing (see docs/billing.md). Until set, billing endpoints return 503 and all plan checks fail open — safe to deploy the code before configuring Stripe.

Architecture notes

Tenure Monitor (`/tenure-monitor`)

Watches a saved portfolio of B.C. mineral tenures: days remaining against each claim's good-to-date, email reminders, change detection, and one-click hand-off into the map editor. Read-only with respect to government transactions — it never touches MTO on a user's behalf.

Data: a mirror of DataBC's MTA_ACQUIRED_TENURE_SVW layer, loaded by scripts/tenure-sync/ from GitHub Actions (nightly full + twice-daily targeted). A partial or failed government response aborts without writing, so a bad day at the province cannot damage stored portfolios.
Reminders: scripts/tenure-alerts/, daily. De-duplication is a unique database constraint rather than application logic.
Deadlines are computed in America/Vancouver throughout (src/utils/tenureDates.js), never in the browser's timezone.
Developer docs: docs/tenure-monitor.md. User help: docs/tenure-monitor-help.md.

Serverless APIs (`api/`)

api/claims.js — multi-province claims search proxy (BC WFS, ArcGIS provinces ON/SK/MB/NL/YT, Quebec via a self-hosted Supabase table). Full pagination with honest meta: { totalKnown, returned, truncated, pagesFetched, provider }; rate-limited; CORS-restricted; sanitized errors.
api/bc-claims.js — BC-only WFS proxy (nearby-claims bbox + legacy search).
api/tenure-search.js — Tenure Monitor search over the Exploration Maps mirror of the B.C. mineral tenure registry (tenure number, pasted list, owner name, client number, map extent, geometry). Anonymous-safe, rate-limited, and every response states when the mirror was last synchronized. Reads with the ANON key under the public-read policy, never the service role.
api/track.js — all analytics ingestion (page views, live-presence pings, product/search events, landing clicks, leads). Enforces an event-name allowlist, payload size/depth limits, and session-id shape; derives geo from edge headers (never the body); resolves user identity from a verified Supabase access token; writes with the service role; rate-limits per IP. Without SUPABASE_SERVICE_ROLE_KEY it accepts-and-drops so analytics can never break the app. Identified automated browsers are dropped before any write. Admin reports also exclude admin accounts and browsers marked internal; opening the admin dashboard marks that browser, while ?em_internal=1 and ?em_internal=0 provide an explicit set/clear control.
api/stripe-checkout.js / api/stripe-portal.js / api/stripe-webhook.js — Pro-subscription billing (Stripe Checkout + customer portal + the signature-verified webhook that syncs public.user_plans). Grandfathered accounts (pre-launch) are never downgraded. See docs/billing.md.
api/_lib/ — shared helpers (pagination, request guards, esri→GeoJSON); the underscore path means Vercel does not expose them as endpoints.

Shared maps

Share links are /map/<id> where <id> is a client-generated crypto.randomUUID() (a 122-bit random token). Reads go through the get_shared_map(share_id) RPC — table-level SELECT is revoked, so shared_maps cannot be enumerated from the public client. Old links keep working: the id remains the lookup key.

Authentication & admin

Supabase auth (magic-link default, password fallback). Admin access is a row in public.admin_users checked by is_admin() inside SECURITY DEFINER reporting functions; all definer functions have a pinned search_path and explicit execute grants. To add an admin:

sql

insert into public.admin_users (user_id, note)
select id, 'added by <you>' from auth.users where email = '<email>';

Local project storage

src/utils/projectStorage.js: projects + the working draft live in localStorage, deflate-compressed (gz1: prefix), with a schema version and deterministic migrations. Corrupted records are preserved under a .recovery key (never auto-deleted) and surfaced with manual export/discard helpers. Writes return structured results — the UI never claims success on a failed write. On sign-in, local projects migrate to the cloud with per-project status + retry (src/utils/cloudMigration.js).

Import formats

CSV (RFC 4180 via Papa Parse; auto-detected lat/long columns, plus azimuth, dip and length for drill traces), GeoJSON (validated), zipped shapefiles, loose .shp/.dbf/.prj/.shx sets (the .prj is honored — projected files are reprojected to WGS84 via proj4), KML, KMZ (bounded: entry count, uncompressed size, path traversal), and georeferenced images (.png/.jpg/.gif/.webp with a world file or typed-in edges, lat/long or UTM; resampled to 2048 px and stored in the project). Published tile ({z}/{x}/{y}) and WMS services can be added as layers under Reference Overlays.

Claim registries

Canada: BC (WFS), Ontario/Saskatchewan/Manitoba/Newfoundland & Labrador/Yukon (official ArcGIS services), Quebec (weekly-synced Supabase mirror). United States: federal BLM MLRS claims for 11 western states, behind VITE_ENABLE_US_CLAIMS — federal claims only, no state-managed tenure (Alaska state claims not included); boundaries are generalized BLM representations, not legal surveys. See docs/us-claims.md for the data source, field mapping, and the post-deploy verification checklist.

Database migrations

Timestamped, additive migrations live in supabase/migrations/. The legacy supabase-*.sql files in the repo root are the historical hand-run setup scripts — they document existing production state; new changes go in supabase/migrations/ only.

Apply order matters — two migrations are deploy-coupled:

Step	Action	When
1	`20260710000001_shared_map_lookup_rpc.sql`	Any time (additive)
2	`20260710000003_live_pings_read_lockdown.sql`	Any time (the deployed app never reads live_pings)
3	`20260710000005_admin_authorization.sql`	Any time (additive; seeds the current admin)
4	Deploy the frontend (uses `get_shared_map` + `/api/track`) and set `SUPABASE_SERVICE_ROLE_KEY` in Vercel	—
5	`20260710000002_shared_maps_lockdown.sql`	Only after step 4
6	`20260710000004_analytics_ingest_lockdown.sql`	Only after step 4

Each migration header includes rollback instructions. After applying, verify RLS as an anonymous client, a normal authenticated user, and the admin — verification queries are embedded in ...000005.

20260901000001_shared_rate_limit.sql is additive and can be applied any time, but until it is, the cross-instance rate limiter in api/_lib/guard.js has nothing to call and fails open (only the per-instance limiter applies). The send-welcome edge function must also be redeployed (supabase functions deploy send-welcome) to pick up its lead-row check.

Deployment & rollback

Pushes to main deploy via Vercel (npm run build → dist/, plus api/ functions). Rollback = redeploy the previous Vercel deployment (instant); if a deploy-coupled migration was applied after the deploy being rolled back, also run the rollback SQL from that migration's header.

Testing

Vitest + React Testing Library (tests/, config in vitest.config.js). Coverage focuses on regression protection: save/autosave race conditions, claims request ordering/cancellation, provider pagination, shapefile projection + CSV/GeoJSON parsing, storage failure/corruption handling, local→cloud migration retries, API hardening, ArcGIS geometry conversion, and shared-map access.

Install

Tools (3)

preview_exploration_mapsearch_mineral_claimsget_mapping_capabilities

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.explorationmaps.com/mcp/server

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "explorationmaps": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.explorationmaps.com/mcp/server"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

preview_exploration_map

search_mineral_claims

get_mapping_capabilities

Exploration Maps

Stack

Requirements

Development

Commands

Environment variables

Architecture notes

Tenure Monitor (/tenure-monitor)

Serverless APIs (api/)

Shared maps

Authentication & admin

Local project storage

Import formats

Claim registries

Database migrations

Deployment & rollback

Testing

Install

Remote endpoint

Related servers

Tenure Monitor (`/tenure-monitor`)

Serverless APIs (`api/`)