{"data":{"name":"com.commonlands/optics-mcp","title":"Commonlands Optics: M12 Lens and C-Mount Lens Finder + Field-of-View Calculator","description":"M12 lens and C-mount lens finder with image-sensor matching and field-of-view calculator.","version":"0.4.2","websiteUrl":"https://commonlands.com/pages/agentic-mcp-for-m12-lenses-and-optics","repositoryUrl":"https://github.com/CommonlandsAbbe/commonlands-mcp","remotes":[{"url":"https://mcp.commonlands.com/mcp","type":"streamable-http"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-10-20T01:00:22.951Z","updatedAt":"2026-10-20T01:00:22.951Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"Commonlands Optics: M12 Lens and C-Mount Lens Finder + Field-of-View Calculator","source":"official-registry","sourceId":"com.commonlands/optics-mcp","updatedAt":"2026-10-20T01:00:22.951Z","confidence":100,"websiteUrl":"https://commonlands.com/pages/agentic-mcp-for-m12-lenses-and-optics","description":"M12 lens and C-mount lens finder with image-sensor matching and field-of-view calculator.","verification":"official","repositoryUrl":"https://github.com/CommonlandsAbbe/commonlands-mcp"}],"toolIndex":{"tools":[{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"assess_lens_requirements","title":"Check a lens against engineering requirements","description":"Start with the sensor dimensions and a shortlisted optical part number. Check FoV ranges, image-circle coverage, nominal mount and axis-specific calculated distortion using the existing live FoV backend. Explicitly report unknown mass/dimensions without source units and missing engineering evidence. No fixture lens substitution, recalculated optics, product qualification or purchase action.","inputSchema":{"type":"object","properties":{"lens_sku":{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$","description":"Exact optical part number from search/matching, e.g. CIL353; not an inferred Shopify configuration."},"sensor":{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$","description":"Sensor part number. Alternatively provide custom dimensions, not both."},"widthPx":{"type":"integer","minimum":1,"description":"Custom sensor: horizontal pixel count (e.g. 4056). Use with heightPx and pixelSizeUm."},"heightPx":{"type":"integer","minimum":1,"description":"Custom sensor: vertical pixel count (e.g. 3040)."},"pixelSizeUm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: pixel pitch in microns (e.g. 1.55)."},"sensorWidthMm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: active-area width in mm (alternative to pixels x pitch)."},"sensorHeightMm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: active-area height in mm."},"requirements":{"type":"object","minProperties":1,"additionalProperties":false,"properties":{"horizontal_fov_deg":{"type":"object","required":["min","max"],"additionalProperties":false,"properties":{"min":{"type":"number","exclusiveMinimum":0,"maximum":360},"max":{"type":"number","exclusiveMinimum":0,"maximum":360}}},"vertical_fov_deg":{"type":"object","required":["min","max"],"additionalProperties":false,"properties":{"min":{"type":"number","exclusiveMinimum":0,"maximum":360},"max":{"type":"number","exclusiveMinimum":0,"maximum":360}}},"diagonal_fov_deg":{"type":"object","required":["min","max"],"additionalProperties":false,"properties":{"min":{"type":"number","exclusiveMinimum":0,"maximum":360},"max":{"type":"number","exclusiveMinimum":0,"maximum":360}}},"full_sensor_coverage":{"const":true,"description":"Require the image circle to cover the full sensor diagonal. Does not establish edge image quality."},"mount":{"type":"string","description":"M12/S-mount, C-mount/C FA, or CS-mount. Nominal interface only; does not establish mechanical fit."},"distortion":{"type":"object","required":["axis","max_absolute_percent"],"additionalProperties":false,"properties":{"axis":{"enum":["horizontal","vertical","diagonal"]},"max_absolute_percent":{"type":"number","minimum":0,"maximum":100}}},"max_weight_g":{"type":"number","exclusiveMinimum":0,"description":"Unknown unless the source explicitly supplies grams; unitless numbers are not interpreted."},"max_diameter_mm":{"type":"number","exclusiveMinimum":0,"description":"Unknown unless the source explicitly supplies millimetres. Does not establish rear clearance."},"require_evidence":{"type":"array","minItems":1,"maxItems":7,"uniqueItems":true,"items":{"enum":["mtf","cra","relative_illumination","spectral_transmission","mechanical_fit","environmental","depth_of_field"]},"description":"Request engineering confirmation. These structured datasets are not currently supplied by the public backend contract."}}}},"required":["lens_sku","requirements"],"additionalProperties":false,"oneOf":[{"required":["sensor"]},{"required":["widthPx","heightPx","pixelSizeUm"]},{"required":["sensorWidthMm","sensorHeightMm"]}]},"annotations":{"title":"Check a lens against engineering requirements","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b3f56b0602cbdfe78b1cbf1bb9b0adf61985be7b43c4ea35f4058a9f57c236af","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"calculate_field_of_view","title":"Calculate Commonlands field of view","description":"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. No part number? Describe the sensor directly: widthPx + heightPx + pixelSizeUm (active area is derived as pixels x pitch), or sensorWidthMm + sensorHeightMm. Results are labelled CUSTOM-<w>x<h>. If only focal length is supplied, the response is marked as a rectilinear reference and does not claim Commonlands distortion-corrected lens truth.","inputSchema":{"type":"object","properties":{"lens_sku":{"type":"string","description":"Commonlands lens SKU, for example CIL250. Snake-case alias for lensSku."},"lensSku":{"type":"string","description":"Commonlands lens SKU, for example CIL250. Camel-case alias for lens_sku."},"focal_length_mm":{"type":"number","exclusiveMinimum":0,"description":"Fallback rectilinear reference only when no Commonlands lens SKU is available. Snake-case alias for focalLengthMm."},"focalLengthMm":{"type":"number","exclusiveMinimum":0,"description":"Fallback rectilinear reference only when no Commonlands lens SKU is available. Camel-case alias for focal_length_mm."},"sensor":{"anyOf":[{"type":"string","enum":["IMX477","IMX219","AR0234"],"description":"Known catalog sensor part number."},{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$","description":"Safe sensor identifier accepted for live catalog lookup."},{"type":"object","properties":{"part_number":{"type":"string"},"partNumber":{"type":"string"}},"additionalProperties":true}],"description":"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":{"anyOf":[{"type":"string","enum":["IMX477","IMX219","AR0234"]},{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$"}],"description":"Sensor part number. Camel-case alias for sensor."},"sensor_part_number":{"anyOf":[{"type":"string","enum":["IMX477","IMX219","AR0234"]},{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$"}],"description":"Sensor part number. Snake-case alias for sensorPartNumber."},"working_distance_mm":{"type":"number","exclusiveMinimum":0,"description":"Optional working distance in mm. Snake-case alias for workingDistanceMm."},"workingDistanceMm":{"type":"number","exclusiveMinimum":0,"description":"Optional working distance in mm. Camel-case alias for working_distance_mm."},"widthPx":{"type":"integer","minimum":1,"description":"Custom sensor: horizontal pixel count (e.g. 4056). Use with heightPx and pixelSizeUm."},"heightPx":{"type":"integer","minimum":1,"description":"Custom sensor: vertical pixel count (e.g. 3040)."},"horizontalPixels":{"type":"integer","minimum":1,"description":"Alias for widthPx."},"verticalPixels":{"type":"integer","minimum":1,"description":"Alias for heightPx."},"pixelSizeUm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: pixel pitch in microns (e.g. 1.55)."},"pixelPitchUm":{"type":"number","exclusiveMinimum":0,"description":"Alias for pixelSizeUm."},"sensorWidthMm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: active-area width in mm (alternative to pixels x pitch)."},"sensorHeightMm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: active-area height in mm."}},"anyOf":[{"required":["lens_sku"]},{"required":["lensSku"]},{"required":["focal_length_mm"]},{"required":["focalLengthMm"]}],"additionalProperties":false},"annotations":{"title":"Calculate Commonlands field of view","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"bde221f2828fc17e0f13b3b938ec346e7c7167445989fe6c095b961259fe70f4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"cancel_cart","title":"Cancel Shopify cart","description":"Cancel a Shopify-owned cart using its id and cart_access_token. Requires meta[\"idempotency-key\"] UUID for retry safety. This does not cancel an order or refund payment.","inputSchema":{"type":"object","properties":{"meta":{"type":"object"},"id":{"type":"string"},"cart_access_token":{"type":"string","description":"Owner token returned by create_cart."}},"required":["id","meta","cart_access_token"],"additionalProperties":false},"annotations":{"title":"Cancel Shopify cart","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"64a94fdea8782561802b2d4f8aa02cd7cf1f739a0ff49f9d94804c4d66e3c169","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"compare_lenses","title":"Compare Commonlands lenses","description":"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.","inputSchema":{"type":"object","properties":{"lensSkus":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string"}},"sensorPartNumber":{"type":"string","description":"Sensor part number, for example IMX477."},"workingDistanceMm":{"type":"number","exclusiveMinimum":0}},"required":["lensSkus","sensorPartNumber"],"additionalProperties":false},"annotations":{"title":"Compare Commonlands lenses","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"061c9f2dfbb67c0191ac61482772d5a5bed2c8e4fe44b954799c7ff0917624a6","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"create_cart","title":"Create Shopify cart","description":"Create a Shopify-owned cart after buyer confirmation of live variants and quantities. Retain cart_access_token for get_cart/update_cart. For an agent-authorized purchase, use the returned agent_checkout route in the buyer's separate Shop MCP connection; Shop handles sign-in, approval, and payment. Otherwise use Commonlands create_checkout for a customer payment link. This tool places no order.","inputSchema":{"type":"object","properties":{"meta":{"type":"object","description":"Optional UCP metadata. ucp-agent.profile is filled from server config when omitted."},"cart":{"type":"object","properties":{"line_items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":999},"item":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}},"required":["quantity","item"],"additionalProperties":false}},"context":{"type":"object"},"signals":{"type":"object"}},"required":["line_items"],"additionalProperties":false}},"required":["cart"],"additionalProperties":false},"annotations":{"title":"Create Shopify cart","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"9487b3dfec9f0c361a120720a7c44b1da0e2c1df21b8ed403f09f6b25d1d61c4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"create_checkout","title":"Create Shopify Checkout MCP checkout","description":"Prepare a Shopify checkout after the buyer confirms exact live variants and quantities. Pass checkout.cart_id and its cart_access_token to convert a cart, or checkout.line_items. Retain checkout_access_token from the response. Send the buyer to continue_url for review and payment; this does not place an order.","inputSchema":{"type":"object","properties":{"meta":{"type":"object","description":"Optional UCP metadata. ucp-agent.profile is filled from server config when omitted."},"cart_access_token":{"type":"string","description":"Required when checkout.cart_id is supplied; use the owner token from create_cart."},"checkout":{"type":"object","properties":{"cart_id":{"type":"string","description":"Optional Shopify Cart gid to convert/hand off into checkout."},"line_items":{"type":"array","minItems":0,"maxItems":25,"items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":999},"item":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}},"required":["quantity","item"],"additionalProperties":false}},"context":{"type":"object"}},"additionalProperties":false}},"required":["checkout"],"additionalProperties":false},"annotations":{"title":"Create Shopify Checkout MCP checkout","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"885bbb5e3456556c6692c22e8a81aa42b2912a3db706ef4e03d2b9e8cc33b64a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"get_cart","title":"Get Shopify cart","description":"Retrieve a Shopify-owned cart with its cart_access_token from create_cart. Retain the full cart id, owner token, and continue_url. The agent_checkout field describes how the buyer's separate Shop MCP connection can convert this cart and complete an approved purchase; it does not itself place an order.","inputSchema":{"type":"object","properties":{"meta":{"type":"object"},"id":{"type":"string","description":"Shopify Cart gid."},"cart_access_token":{"type":"string","description":"Owner credential returned by create_cart for this cart id."}},"required":["id","cart_access_token"],"additionalProperties":false},"annotations":{"title":"Get Shopify cart","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ac55735980a651ea775da9af646ea45a935e4e8aa8c3a204bc8bbda1b21e2b6f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"get_catalog_snapshot_status","title":"Get joined catalog snapshot status","description":"Return fixture-backed joined catalog counts, validation status, source provenance, live connector readiness, and non-authoritative product-truth warning.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"Get joined catalog snapshot status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"d7f37f6048ab0005c7affd49139bed60db9e556cf3ccd408e2fc5c861f514d48","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"get_checkout","title":"Get Shopify Checkout MCP checkout","description":"Read a Shopify checkout handoff summary using its id and checkout_access_token from create_checkout. Buyer and payment details are withheld. Send the buyer to continue_url to review and pay.","inputSchema":{"type":"object","properties":{"meta":{"type":"object"},"id":{"type":"string","description":"Shopify Checkout gid."},"checkout_access_token":{"type":"string","description":"Owner token returned by create_checkout."}},"required":["id","checkout_access_token"],"additionalProperties":false},"annotations":{"title":"Get Shopify Checkout MCP checkout","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e73aef3c24363442cdcdbb78f51bd4b1fd308105a46e6bf683e5872ae8a79205","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"get_lens_distortion_profile","title":"Get Commonlands lens distortion profile","description":"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.","inputSchema":{"type":"object","properties":{"lens_sku":{"type":"string","description":"Commonlands lens SKU, for example CIL250. Snake-case alias for lensSku."},"lensSku":{"type":"string","description":"Commonlands lens SKU, for example CIL250. Camel-case alias for lens_sku."},"sku":{"type":"string","description":"Legacy SKU alias."}},"anyOf":[{"required":["lens_sku"]},{"required":["lensSku"]},{"required":["sku"]}],"additionalProperties":false},"annotations":{"title":"Get Commonlands lens distortion profile","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"75ebd68cfcc75c667d68871619fb124cd7089efeb0a1e9d4fac0f8917145414b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"get_purchase_options","title":"Check quantity purchase options","description":"Read current Shopify price, currency, online inventory and backorder policy for an exact full SKU and quantity. Base-price arithmetic is not a binding quote; unverified volume terms require an RFQ. Optionally read an existing owner-authorized checkout for shipping/tax estimates. Creates no cart, checkout, order or RFQ.","inputSchema":{"type":"object","properties":{"sku":{"type":"string","description":"Exact full variant SKU from resolve_lens_product."},"quantity":{"type":"integer","minimum":1,"maximum":10000},"variant_id":{"type":"string","description":"Optional Shopify Variant GID; must match the full SKU."},"checkout_id":{"type":"string","description":"Optional existing checkout to read; its single line must match this variant and quantity."},"checkout_access_token":{"type":"string","description":"Matching owner credential from create_checkout; never a Shop OAuth token."}},"required":["sku","quantity"],"additionalProperties":false},"annotations":{"title":"Check quantity purchase options","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"6a810e4f3a7c1e94176986f5b0b39d95c2519e4225c20907c6991a482cffb00f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"get_sensor_specs","title":"Get sensor specs","description":"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.","inputSchema":{"type":"object","properties":{"partNumber":{"type":"string","description":"Sensor part number, for example IMX477."}},"required":["partNumber"],"additionalProperties":false},"annotations":{"title":"Get sensor specs","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e284c2cb24d2257b73d0563e2afa1b9680df0e76cdeb8c1a11d7d8d85a6f4685","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"get_shopify_readonly_config_status","title":"Get Shopify read-only config status","description":"Report sanitized Cloudflare Shopify binding presence, approved read scopes, and read-only safety flags without exposing secrets or calling Shopify.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"Get Shopify read-only config status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"600a1f44e023eb7949b1b0ac235cdcdef09e094fec796ba13b04098c2b880c1d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"get_shopify_ucp_readiness","title":"Get Shopify Storefront/UCP readiness","description":"Report connector-free Shopify Storefront MCP and UCP Catalog compatibility, launch blockers, and Commonlands engineering differentiators.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"Get Shopify Storefront/UCP readiness","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5c986926d510074261da33e0ee79071a8d0c3a81ea4a9f54a198dd45dda1c277","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"match_lens_to_sensor","title":"Match Commonlands lenses to a sensor","description":"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. No part number? Describe the sensor directly: widthPx + heightPx + pixelSizeUm (active area is derived as pixels x pitch), or sensorWidthMm + sensorHeightMm. Results are labelled CUSTOM-<w>x<h>. Use read_shopify_products afterward for live stock, price, availability, Shopify variantId, product URL, and metafields.","inputSchema":{"type":"object","properties":{"widthPx":{"type":"integer","minimum":1,"description":"Custom sensor: horizontal pixel count (e.g. 4056). Use with heightPx and pixelSizeUm."},"heightPx":{"type":"integer","minimum":1,"description":"Custom sensor: vertical pixel count (e.g. 3040)."},"horizontalPixels":{"type":"integer","minimum":1,"description":"Alias for widthPx."},"verticalPixels":{"type":"integer","minimum":1,"description":"Alias for heightPx."},"pixelSizeUm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: pixel pitch in microns (e.g. 1.55)."},"pixelPitchUm":{"type":"number","exclusiveMinimum":0,"description":"Alias for pixelSizeUm."},"sensorWidthMm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: active-area width in mm (alternative to pixels x pitch)."},"sensorHeightMm":{"type":"number","exclusiveMinimum":0,"description":"Custom sensor: active-area height in mm."},"sensor":{"anyOf":[{"type":"string","enum":["IMX477","IMX219","AR0234"],"description":"Known catalog sensor part number."},{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$","description":"Safe sensor identifier accepted for live catalog lookup."}],"description":"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":{"anyOf":[{"type":"string","enum":["IMX477","IMX219","AR0234"]},{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$"}],"description":"Sensor part number. Alias for sensor."},"sensor_part_number":{"anyOf":[{"type":"string","enum":["IMX477","IMX219","AR0234"]},{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$"}],"description":"Sensor part number. Snake-case alias for sensorPartNumber."},"desired_horizontal_fov_deg":{"type":"number","exclusiveMinimum":0},"desiredHorizontalFovDeg":{"type":"number","exclusiveMinimum":0},"working_distance_mm":{"type":"number","exclusiveMinimum":0},"workingDistanceMm":{"type":"number","exclusiveMinimum":0},"mount":{"type":"string","description":"Optional mount filter, for example M12 or C-mount."},"max_results":{"type":"integer","minimum":1,"maximum":10,"default":5},"maxResults":{"type":"integer","minimum":1,"maximum":10,"default":5}},"anyOf":[{"required":["sensor"]},{"required":["sensorPartNumber"]},{"required":["sensor_part_number"]},{"required":["widthPx","heightPx","pixelSizeUm"]},{"required":["horizontalPixels","verticalPixels","pixelSizeUm"]},{"required":["widthPx","heightPx","pixelPitchUm"]},{"required":["sensorWidthMm","sensorHeightMm"]}],"additionalProperties":false},"annotations":{"title":"Match Commonlands lenses to a sensor","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"cf66e5df33e693956caf53677b89b4f534cac5e359de7c0becda95cfcd8dc509","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"read_shopify_products","title":"Read Shopify products","description":"Use this for live purchasable product truth: product and variant IDs, full SKUs, prices, availability, product URLs, and public product-page metafields. Each variant includes websiteStockQuantity (tracked inventory count used by website stock labels), availableQuantity (online sellable stock), inventoryTracked, availableForSale, and continueSellingWhenOutOfStock. Null quantities mean unknown or untracked, not zero. Match the full selected SKU and variantId; never sum different variants. Each call reads current Shopify backend data. Use generatedAt for read freshness. Typed metafield value is authoritative; valuePreview is display-only. Check pageInfo and metafieldsComplete. Counts reserve no inventory and do not guarantee delivery to a customer location; verify checkout warnings. Only active Online Store products are returned. Private inventory IDs and locations remain excluded. Read-only; does not create carts, checkouts, orders, customers, inventory mutations, or Shopify writes. Fixture catalog tools are scaffold data only.","inputSchema":{"type":"object","properties":{"after":{"type":"string","description":"Shopify endCursor from the previous page; keep the same search."},"sku":{"type":"string","description":"Optional variant SKU, for example CIL250."},"handle":{"type":"string","description":"Optional Shopify product handle."},"query":{"type":"string","description":"Optional safe Shopify product/variant search text."},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10},"includeMetafields":{"type":"boolean","default":false,"description":"When true, include the allowlisted public product-page metafields (custom.* display specs). Non-public namespaces and keys are never returned."}},"additionalProperties":false},"annotations":{"title":"Read Shopify products","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"43dbd2c1da2f0bb877307970309cc22d3fb818d52c0b9b002e556b33ce21c916","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"recommend_lenses_for_application","title":"Recommend lenses for an application","description":"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.","inputSchema":{"type":"object","properties":{"sensorPartNumber":{"type":"string","description":"Sensor part number, for example IMX477."},"application":{"type":"string"},"desiredHorizontalFovDeg":{"type":"number","exclusiveMinimum":0},"workingDistanceMm":{"type":"number","exclusiveMinimum":0},"mount":{"type":"string"},"preferLowDistortion":{"type":"boolean","default":false},"requireInStock":{"type":"boolean","default":false},"maxResults":{"type":"integer","minimum":1,"maximum":10,"default":5}},"required":["sensorPartNumber"],"additionalProperties":false},"annotations":{"title":"Recommend lenses for an application","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"7e15d86608289ae2c48aff8f2e3bceba2f207eeb3f5a1f170f9319462f6c773c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"resolve_lens_product","title":"Resolve a live lens product","description":"Resolve a lens family or exact full SKU to current published Shopify variants. A family requires explicit variant selection; no fixture specifications or inferred configuration. Use the optical part number with calculate_field_of_view for sensor-specific optics.","inputSchema":{"type":"object","properties":{"sku":{"type":"string"}},"required":["sku"],"additionalProperties":false},"annotations":{"title":"Resolve a live lens product","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"cb6de9526faf040ad109c4574f019b3c02e74f109eb5075721f5bfbfef9d8764","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"search_lens_catalog","title":"Search Commonlands lens catalog","description":"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.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"SKU, title, mount, lens type, application, sensor, or field-of-view search text."},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10}},"additionalProperties":false},"annotations":{"title":"Search Commonlands lens catalog","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e36d53c324c7db693bc2f754ec7c7502e0e1c73291101564e876f9a06914b54e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"submit_rfq","title":"Submit an RFQ or question to Commonlands","description":"Forward a buyer request-for-quote or engineering question to the Commonlands engineering team. Two-step, buyer-confirmed: the first call returns a preview and sends nothing; show the buyer the preview (including their reply-to email) and, only after they explicitly approve, call again with confirm: true to send. 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.","inputSchema":{"type":"object","properties":{"message":{"type":"string","description":"The buyer's question or RFQ details.","maxLength":4000},"email":{"type":"string","description":"The buyer's reply-to email so Commonlands can respond."},"name":{"type":"string","description":"Optional buyer name."},"company":{"type":"string","description":"Optional company name."},"kind":{"type":"string","enum":["rfq","question"],"description":"Whether this is a quote request or a general question. Defaults to question."},"partNumbers":{"description":"Optional Commonlands SKUs of interest (string or array).","anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":25}]},"sensor":{"type":"string","description":"Optional sensor part number for context."},"quantity":{"type":"integer","minimum":1,"description":"Optional quantity for the quote."},"application":{"type":"string","description":"Optional application note."},"confirm":{"type":"boolean","default":false,"description":"Explicit buyer approval. Omit or false to get a no-send preview; set true only after the buyer has seen the preview and approved sending."}},"required":["message","email"],"additionalProperties":false},"annotations":{"title":"Submit an RFQ or question to Commonlands","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"2e2b12e2f57738e0c42cd0ce057322965a7ddea897b9948fc65cd6512e67b44e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"},{"serverName":"com.commonlands/optics-mcp","endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","name":"update_cart","title":"Update Shopify cart","description":"Replace the complete Shopify cart after buyer confirmation. Requires id and cart_access_token. Read the cart first, then send cart.line_items containing every item to retain with item.id (ProductVariant GID), quantity, and optional existing line id. Omitted lines are removed; [] empties the cart. This does not place an order.","inputSchema":{"type":"object","properties":{"meta":{"type":"object"},"id":{"type":"string"},"cart_access_token":{"type":"string","description":"Owner credential returned by create_cart for this cart id."},"cart":{"type":"object","required":["line_items"],"additionalProperties":false,"properties":{"line_items":{"type":"array","minItems":0,"maxItems":25,"items":{"type":"object","required":["item","quantity"],"additionalProperties":false,"properties":{"id":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":999},"item":{"type":"object","required":["id"],"additionalProperties":false,"properties":{"id":{"type":"string"}}}}}},"context":{"type":"object"}}}},"required":["id","cart","cart_access_token"],"additionalProperties":false},"annotations":{"title":"Update Shopify cart","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"definitionHash":"574b7f26df78a8736fddc0c9b1a4e37b83d926a472e06a2650b4a8db07d6ed5d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T07:46:06.632Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"a722c97c1b5e98a5e4602029600cba3566321d895b67f46393a8326b7e537049","protocol":"streamable-http","status":"indexed","toolCount":21,"observedAt":"2026-11-15T07:46:06.632Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.commonlands/optics-mcp":{"url":"https://mcp.commonlands.com/mcp"}}},"Cursor":{"mcpServers":{"com.commonlands/optics-mcp":{"url":"https://mcp.commonlands.com/mcp"}}},"VS Code":{"servers":{"com.commonlands/optics-mcp":{"type":"http","url":"https://mcp.commonlands.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.commonlands.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.commonlands%2Foptics-mcp","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.commonlands%2Foptics-mcp","name":"com.commonlands/optics-mcp","description":"M12 lens and C-mount lens finder with image-sensor matching and field-of-view calculator.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.commonlands.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://commonlands.com/pages/agentic-mcp-for-m12-lenses-and-optics","repositoryUrl":"https://github.com/CommonlandsAbbe/commonlands-mcp","version":"0.4.2"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.commonlands/optics-mcp","status":"online","lastCheckedAt":"2026-11-20T06:16:37.340Z","lastSuccessfulCheck":"2026-11-20T06:16:37.340Z","latencyMs":37,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T06:16:37.340Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T06:16:37.340Z"},"security":null,"timestamps":{"createdAt":"2026-10-20T01:00:22.951Z","updatedAt":"2026-10-20T01:00:22.951Z","observedAt":"2026-11-20T06:16:37.340Z"},"compatibility":{"serverVersion":"0.4.2","protocolVersions":[{"protocol":"mcp","version":null}]}}}}