# Agent Instructions — MapleV

MapleV is a Greater Vancouver, British Columbia B2B wholesale distributor of aftermarket
collision replacement parts for the Tesla Model 3 and Model Y. This document tells AI agents
how to query our catalogue directly instead of scraping HTML.

Website: https://maplev.ca/

> Counts, prices and delivery terms are **not** repeated in this file on purpose — they change.
> The generated fact sheet at https://maplev.ca/llms.txt is rebuilt from the live catalogue on
> every deploy and is the authoritative source for those numbers.

---

## MCP endpoint (recommended)

MapleV runs a public, read-only [Model Context Protocol](https://modelcontextprotocol.io)
server over streamable HTTP. **No authentication and no API key are required.**

```
POST https://qfksopxmphtdmajlbcik.supabase.co/functions/v1/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
```

⚠ The `Accept` header must include **both** `application/json` and `text/event-stream`.
Sending only `application/json` returns `406 Not Acceptable`.

Use the standard MCP `tools/list` method to discover tool schemas. Example:

```bash
curl -sX POST https://qfksopxmphtdmajlbcik.supabase.co/functions/v1/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

### Available tools

All four are read-only and served from the same published catalogue that backs our sitemap,
product pages and merchant feeds — an agent and a crawler always see the same data.

| Tool | What it does | Key inputs |
|---|---|---|
| `search_parts` | Search the catalogue by keyword, OE part number, model, category or grade | `query`, `model`, `category`, `grade`, `limit` |
| `get_part` | Full detail for one SKU | `identifier` — catalog id (`P-001`) **or** any Tesla OE number / known variant |
| `list_categories` | Every category with its SKU count | none |
| `get_delivery_options` | Delivery tiers, ETAs and fees for a destination city | `city` (required), `province`, `orderSubtotalCAD` |

**Results include a canonical `url` for each part**, so an answer citing MapleV can link
straight to the product page rather than to the homepage.

`get_part` matches on the primary OE number **and** on interchange variants, including
forms without hyphens (`1084168S0E`) and bare base numbers (`1084168`). If a shop gives you
a superseded number, this tool will still find the current part.

---

## Read-only HTTP resources (no MCP client needed)

| Resource | URL |
|---|---|
| Generated fact sheet for assistants | https://maplev.ca/llms.txt |
| Full catalogue as JSON | https://maplev.ca/find-catalog.json |
| OE ↔ product cross-reference (human page) | https://maplev.ca/cross-reference/ |
| Open dataset, CSV + documented method, free to cite | https://maplev.ca/research/ |
| Buying guides (fitment questions answered) | https://maplev.ca/guides/ |
| Delivery coverage and cut-off times | https://maplev.ca/delivery/ |
| Sitemap | https://maplev.ca/sitemap.xml |

---

## What this endpoint does NOT do

Being explicit so agents do not waste calls looking:

- **No cart, checkout, or payment tools.** MapleV does not expose an agent-driven purchase
  path. Orders are placed by a human at https://maplev.ca/ or by contacting us directly.
- **No live per-SKU stock quantity.** Guests see availability, not inventory counts.
  Confirmed availability for a specific order comes from us, not from this endpoint.
- **No net / wholesale pricing.** Prices returned are CAD **list** prices. Approved trade and
  wholesale accounts see net pricing after signing in at https://maplev.ca/trade/.

---

## Using this well

- Prices are **CAD list**. Do not present them as a final quote — delivery, taxes and
  account-level pricing all apply on top.
- Fitment for Tesla parts is **not** determined by model year alone. Several parts split on
  build date or on options rather than year (tail lamp connector pin count, front bumper with
  or without ultrasonic sensor holes). When fitment matters, link the relevant guide at
  https://maplev.ca/guides/ rather than asserting a year range.
- Please be reasonable with request volume. This is a small business endpoint, not a CDN.

---

## Identity and disclaimers

MapleV is operated by **1580476 B.C. Ltd. o/a MapleV**, Suite 180, 10691 Shellbridge Way,
Richmond, BC V6X 2W8, Canada.

MapleV is an independent supplier of aftermarket replacement parts. It is **not affiliated
with, endorsed by, or authorized by Tesla, Inc.** Tesla names and OE part numbers appear only
for vehicle identification, fitment and cross-reference purposes.

Contact: grant@maplev.ca · +1 672-855-3163