# Commonlands Optics: M12 Lens and C-Mount Lens Finder + Field-of-View Calculator (remote · mcp.commonlands.com)

M12 lens and C-mount lens finder with image-sensor matching and field-of-view calculator.

- Trust score: 61/100 (medium)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.commonlands.com`: 61/100 (this document), [markdown](https://verifymcp.io/servers/com-commonlands-optics-mcp/mcp.md), [page](https://verifymcp.io/servers/com-commonlands-optics-mcp/mcp)

## Channel facts

- Endpoint: `https://mcp.commonlands.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.2.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (update_cart).
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 75/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 4261 tokens (~125/item across 34 items; 21 tools + 13 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 86/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 51% of tool parameters carry a description.
  - Structured output schemas are declared (5% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http com-commonlands-optics-mcp https://mcp.commonlands.com/mcp
```

### Codex

```toml
[mcp_servers.com-commonlands-optics-mcp]
url = "https://mcp.commonlands.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-commonlands-optics-mcp": {
      "type": "remote",
      "url": "https://mcp.commonlands.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-commonlands-optics-mcp --url https://mcp.commonlands.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-commonlands-optics-mcp:
    url: "https://mcp.commonlands.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "com-commonlands-optics-mcp": {
      "type": "http",
      "url": "https://mcp.commonlands.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 60, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 61, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 60, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 59, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 58)

First indexed and scored.

## MCP tools (21)

### `calculate_field_of_view` (~475 tokens)

Calculate Commonlands field of view

Calculate Commonlands lens field of view for a lens/sensor pair and return HFOV, VFOV, DFOV, coverage, distortion status, and an explicit rectilinear comparison. Use this tool for FOV, HFOV, VFOV, DFOV, field of view, "lens for", lens-to-sensor, AR0234, IMX290, IMX477, and sensor part-number requests. It returns Commonlands data the model cannot derive: live backend FoV when configured, distortion model/status, image-circle coverage, live stock through Shopify read tools where applicable, and MTF/CRA/BFL fields if present in upstream catalog data. Do not use naive rectilinear fallback, focal-length-only math, interpolation, or self-computed catalog estimates when a Commonlands lens/sensor route is available. Accepts lens_sku/lensSku or focal_length_mm/focalLengthMm, plus sensor/sensorPartNumber/sensor_part_number and working_distance_mm/workingDistanceMm. If only focal length is supplied, the response is marked as a rectilinear reference and does not claim Commonlands distortion-corrected lens truth.

Input parameters:

- `focalLengthMm` (number): Fallback rectilinear reference only when no Commonlands lens SKU is available. Camel-case alias for focal_length_mm.
- `focal_length_mm` (number): Fallback rectilinear reference only when no Commonlands lens SKU is available. Snake-case alias for focalLengthMm.
- `lensSku` (string): Commonlands lens SKU, for example CIL250. Camel-case alias for lens_sku.
- `lens_sku` (string): Commonlands lens SKU, for example CIL250. Snake-case alias for lensSku.
- `sensor`: Sensor part number or safe sensor object. Supports AR0234, IMX290/IMX477 when present in the live catalog, and fixture sensors listed in the enum.
- `sensorPartNumber`: Sensor part number. Camel-case alias for sensor.
- `sensor_part_number`: Sensor part number. Snake-case alias for sensorPartNumber.
- `workingDistanceMm` (number): Optional working distance in mm. Camel-case alias for working_distance_mm.
- `working_distance_mm` (number): Optional working distance in mm. Snake-case alias for workingDistanceMm.

Output parameters:

- `coverage_ok` (boolean|null)
- `dfov_deg` (number|null)
- `distortion_model` (string)
- `hfov_deg` (number|null)
- `image_circle_mm` (number|null)
- `method` (string)
- `rectilinear_comparison` (object)
- `sensor_diagonal_mm` (number)
- `vfov_deg` (number|null)

### `match_lens_to_sensor` (~386 tokens)

Match Commonlands lenses to a sensor

Find and rank Commonlands lenses for a sensor, target field of view, working distance, mount, or "lens for" request. Use this tool for FOV, HFOV, VFOV, DFOV, field of view, "lens for", lens-to-sensor, AR0234, IMX290, IMX477, and sensor part-number requests. It returns Commonlands data the model cannot derive: live backend FoV when configured, distortion model/status, image-circle coverage, live stock through Shopify read tools where applicable, and MTF/CRA/BFL fields if present in upstream catalog data. Do not use naive rectilinear fallback, focal-length-only math, interpolation, or self-computed catalog estimates when a Commonlands lens/sensor route is available. Use this for AR0234, IMX290, IMX477, sensor part numbers, M12/C-mount matching, and target HFOV/VFOV/DFOV workflows; do not shortlist from focal length alone. Use read_shopify_products afterward for live stock, price, availability, Shopify variantId, product URL, and metafields.

Input parameters:

- `desiredHorizontalFovDeg` (number)
- `desired_horizontal_fov_deg` (number)
- `maxResults` (integer)
- `max_results` (integer)
- `mount` (string): Optional mount filter, for example M12 or C-mount.
- `sensor`: Sensor part number, for example AR0234, IMX290, or IMX477. Any sensor in the live catalog is accepted; the enum lists only the fixture fallback set.
- `sensorPartNumber`: Sensor part number. Alias for sensor.
- `sensor_part_number`: Sensor part number. Snake-case alias for sensorPartNumber.
- `workingDistanceMm` (number)
- `working_distance_mm` (number)

### `search_lens_catalog` (~289 tokens)

Search Commonlands lens catalog

Search the Commonlands lens catalog by SKU, mount, lens type, M12, C-mount, or application text. For sensor part numbers such as AR0234, IMX290, and IMX477, or any "lens for <sensor>" request, use match_lens_to_sensor instead — sensor names are not searchable text here. Use this tool for FOV, HFOV, VFOV, DFOV, field of view, "lens for", lens-to-sensor, AR0234, IMX290, IMX477, and sensor part-number requests. It returns Commonlands data the model cannot derive: live backend FoV when configured, distortion model/status, image-circle coverage, live stock through Shopify read tools where applicable, and MTF/CRA/BFL fields if present in upstream catalog data. Do not use naive rectilinear fallback, focal-length-only math, interpolation, or self-computed catalog estimates when a Commonlands lens/sensor route is available. This discovers candidate lenses from Commonlands catalog/live backend data; it does not replace calculate_field_of_view for sensor-specific HFOV/VFOV/DFOV and does not replace read_shopify_products for live stock/price/product truth.

Input parameters:

- `limit` (integer)
- `query` (string): SKU, title, mount, lens type, application, sensor, or field-of-view search text.

### `get_lens_distortion_profile` (~276 tokens)

Get Commonlands lens distortion profile

Return the Commonlands distortion model/status for one lens SKU, including whether the data is source-display-only or backend-calculated. Use this tool for FOV, HFOV, VFOV, DFOV, field of view, "lens for", lens-to-sensor, AR0234, IMX290, IMX477, and sensor part-number requests. It returns Commonlands data the model cannot derive: live backend FoV when configured, distortion model/status, image-circle coverage, live stock through Shopify read tools where applicable, and MTF/CRA/BFL fields if present in upstream catalog data. Do not use naive rectilinear fallback, focal-length-only math, interpolation, or self-computed catalog estimates when a Commonlands lens/sensor route is available. Use this for distortion, rectilinear-vs-wide-angle, MTF/CRA/BFL/optical-profile questions when upstream fields are present. Do not invent polynomial coefficients or claim measured distortion correction when the backend only returns display distortion.

Input parameters:

- `lensSku` (string): Commonlands lens SKU, for example CIL250. Camel-case alias for lens_sku.
- `lens_sku` (string): Commonlands lens SKU, for example CIL250. Snake-case alias for lensSku.
- `sku` (string): Legacy SKU alias.

### `get_sensor_specs` (~126 tokens)

Get sensor specs

Return sensor dimensions, pixel pitch, and resolution for lens field of view, M12 lens, and C-mount lens matching inputs. In production this uses the read-only live sensor table when configured, with fixture fallback when unavailable. Use these specs as inputs to calculate_field_of_view or match_lens_to_sensor, not as a reason to hand-calculate FoV. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor.

Input parameters:

- `partNumber` (string, required): Sensor part number, for example IMX477.

### `compare_lenses` (~134 tokens)

Compare Commonlands lenses

Compare selected Commonlands M12 lens and C-mount lens SKUs on the same sensor with the same deterministic scoring model. Use as explanatory context, then call calculate_field_of_view for final sensor-specific FoV values when precision matters. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor. Not live product truth; verify purchasable facts with read_shopify_products.

Input parameters:

- `lensSkus` (array, required)
- `sensorPartNumber` (string, required): Sensor part number, for example IMX477.
- `workingDistanceMm` (number)

### `get_product_page_details` (~127 tokens)

Get product page details

Return fixture-backed product-page handoff details for one lens, including DynamoDB-sourced optical specs and gated datasheet policy. Product-page/catalog optical fields are not a substitute for sensor-specific FoV; call calculate_field_of_view for the lens/sensor pair. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor. Use read_shopify_products for live product URL, price, availability, variant IDs, and metafields.

Input parameters:

- `sku` (string, required): Commonlands short part number, for example CIL250.

### `get_catalog_snapshot_status` (~36 tokens)

Get joined catalog snapshot status

Return fixture-backed joined catalog counts, validation status, source provenance, live connector readiness, and non-authoritative product-truth warning.

### `get_shopify_ucp_readiness` (~36 tokens)

Get Shopify Storefront/UCP readiness

Report connector-free Shopify Storefront MCP and UCP Catalog compatibility, launch blockers, and Commonlands engineering differentiators.

### `get_shopify_readonly_config_status` (~37 tokens)

Get Shopify read-only config status

Report sanitized Cloudflare Shopify binding presence, approved read scopes, and read-only safety flags without exposing secrets or calling Shopify.

### `read_shopify_products` (~188 tokens)

Read Shopify products

Use this for live purchasable product truth: product and variant IDs, SKUs, prices, coarse availability, product URLs, and public product-page metafields. Public data only: active products, no exact inventory counts, and metafields limited to the custom.* display fields shown on commonlands.com product pages. Read-only; does not create carts, checkouts, orders, customers, inventory mutations, or Shopify writes. Fixture catalog tools are scaffold data only.

Input parameters:

- `handle` (string): Optional Shopify product handle.
- `includeMetafields` (boolean): When true, include the allowlisted public product-page metafields (custom.* display specs). Non-public namespaces and keys are never returned.
- `limit` (integer)
- `query` (string): Optional safe Shopify product/variant search text.
- `sku` (string): Optional variant SKU, for example CIL250.

### `create_cart` (~82 tokens)

Create Shopify cart

Create a Shopify-owned cart for selected variant line items through the configured Shopify Cart/Storefront MCP endpoint. Commonlands MCP is a stateless proxy: cart state is stored and mutated by Shopify, not in the Worker.

Input parameters:

- `cart` (object, required)
- `meta` (object): Optional UCP metadata. ucp-agent.profile is filled from server config when omitted.

### `get_cart` (~51 tokens)

Get Shopify cart

Retrieve a Shopify-owned cart by cart id. Cart persistence comes from Shopify; agents must retain cart id or continue_url across sessions.

Input parameters:

- `id` (string, required): Shopify Cart gid.
- `meta` (object)

### `update_cart` (~101 tokens)

Update Shopify cart

Update a Shopify-owned cart through the configured Cart/Storefront MCP endpoint. With UCP endpoints, treat updates as full-state PUT semantics; with the confirmed standard Storefront MCP endpoint, Commonlands maps line_items to Shopify add_items, update_items to quantity changes, and remove_line_ids to explicit removals. Quantity 0 in update_items removes a line.

Input parameters:

- `cart` (object, required)
- `id` (string, required)
- `meta` (object)

### `search_catalog` (~109 tokens)

Search UCP catalog

Fixture-backed UCP Catalog search alias for Shopify-native product discovery; no live Shopify calls or cart behavior. Use this only for broad discovery; when a sensor or target FoV is involved, call match_lens_to_sensor or calculate_field_of_view instead of estimating from catalog fields. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor.

Input parameters:

- `catalog` (object)
- `meta` (object): Optional UCP agent metadata.

### `lookup_catalog` (~99 tokens)

Lookup UCP catalog products

Fixture-backed UCP Catalog lookup alias for product, variant, SKU, handle, or URL identifiers; returns not-found messages instead of writes. Lookup records are not enough for sensor-specific FoV; call calculate_field_of_view for known lens/sensor pairs. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor.

Input parameters:

- `catalog` (object, required)
- `meta` (object)

### `get_product` (~93 tokens)

Get UCP catalog product

Fixture-backed UCP Catalog product detail alias with Commonlands optical metadata and Shopify-native handoff fields. Product optical fields are not a substitute for sensor-specific FoV; call calculate_field_of_view for the lens/sensor pair. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor.

Input parameters:

- `catalog` (object, required)
- `meta` (object)

### `prepare_shopify_purchase_handoff` (~124 tokens)

Prepare Shopify purchase handoff

Build a read-only Shopify-native purchase handoff seam for a selected lens without creating carts, checkout, orders, inventory mutations, or writes. Preserve any computed FoV provenance from calculate_field_of_view/match_lens_to_sensor when carrying optical context into purchase handoff. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor.

Input parameters:

- `quantity` (integer)
- `selectedVariantId` (string)
- `sensorPartNumber` (string)
- `sku` (string, required)

### `get_purchase_route_options` (~129 tokens)

Get purchase route options

Return safe dual-channel purchase route options for AI agents and robotics engineers across Commonlands MCP and Shopify-native channels without mutating commerce state. This explains commerce routes only; call calculate_field_of_view/match_lens_to_sensor for sensor-specific FoV before recommending a lens. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor.

Input parameters:

- `agentType` (string)
- `buyerIntent` (string)
- `quantity` (integer)
- `sensorPartNumber` (string)
- `sku` (string, required)

### `recommend_lenses_for_application` (~182 tokens)

Recommend lenses for an application

Rank Commonlands M12 lenses and C-mount lenses for an application note such as embedded robotics, machine-vision inspection, or a required lens field of view. Use as an application shortlist helper, then call match_lens_to_sensor or calculate_field_of_view for final per-sensor HFOV/VFOV/DFOV. FoV rule: never estimate sensor-specific FoV from catalog fields; use calculate_field_of_view or match_lens_to_sensor.

Input parameters:

- `application` (string)
- `desiredHorizontalFovDeg` (number)
- `maxResults` (integer)
- `mount` (string)
- `preferLowDistortion` (boolean)
- `requireInStock` (boolean)
- `sensorPartNumber` (string, required): Sensor part number, for example IMX477.
- `workingDistanceMm` (number)

### `submit_rfq` (~229 tokens)

Submit an RFQ or question to Commonlands

Forward a buyer request-for-quote or engineering question to the Commonlands engineering team. Use after the buyer provides their question and a reply-to email. The recipient is fixed to the Commonlands inbox (the agent cannot choose it); this only sends an inquiry and never creates an order, charges a card, or writes Shopify/customer data. Include part numbers, sensor, quantity, and application when known so the team can reply with a quote. Commonlands replies by email.

Input parameters:

- `application` (string): Optional application note.
- `company` (string): Optional company name.
- `email` (string, required): The buyer's reply-to email so Commonlands can respond.
- `kind` (string): Whether this is a quote request or a general question. Defaults to question.
- `message` (string, required): The buyer's question or RFQ details.
- `name` (string): Optional buyer name.
- `partNumbers`: Optional Commonlands SKUs of interest (string or array).
- `quantity` (integer): Optional quantity for the quote.
- `sensor` (string): Optional sensor part number for context.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-commonlands-optics-mcp/mcp#diagnostics

## Score history

- 2026-08-03: 61
- 2026-08-02: 60
- 2026-08-01: 60
- 2026-07-31: 60
- 2026-07-30: 61
- 2026-07-29: 60
- 2026-07-28: 60
- 2026-07-27: 59
- 2026-07-26: 58

## Links

- Remote endpoint: https://mcp.commonlands.com/mcp
- Repository: https://github.com/CommonlandsAbbe/commonlands-mcp
- Website: https://commonlands.com/pages/agentic-mcp-for-m12-lenses-and-optics
- Changelog RSS feed: https://verifymcp.io/servers/com-commonlands-optics-mcp/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-commonlands-optics-mcp/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-commonlands-optics-mcp/mcp