Use an AI assistant to find Commonlands lenses

Check service health

curl -s \
  https://mcp.commonlands.com/healthz

Read discovery profile

curl -s \
  https://mcp.commonlands.com/.well-known/ucp

List available tools

curl -s -X POST \
  https://mcp.commonlands.com/mcp \
  -H 'content-type: application/json' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Search the fixture catalog

{
  "jsonrpc": "2.0",
  "id": "search-m12",
  "method": "tools/call",
  "params": {
    "name": "search_catalog",
    "arguments": {
      "catalog": {
        "query": "m12 lens",
        "limit": 5
      }
    }
  }
}

Match lenses to a sensor

{
  "jsonrpc": "2.0",
  "id": "imx477-match",
  "method": "tools/call",
  "params": {
    "name": "match_lens_to_sensor",
    "arguments": {
      "sensorPartNumber": "IMX477",
      "desiredHorizontalFovDeg": 70,
      "mount": "M12",
      "maxResults": 3
    }
  }
}

Wide-angle golden query

{
  "jsonrpc": "2.0",
  "id": "imx477-wide-match",
  "method": "tools/call",
  "params": {
    "name": "match_lens_to_sensor",
    "arguments": {
      "sensorPartNumber": "IMX477",
      "desiredHorizontalFovDeg": 150,
      "maxResults": 3
    }
  }
}

At 150° the projection is non-rectilinear: the response returns a clipped fisheye candidate with a poor-fit flag. Read the distortion, clipping, and warning fields instead of estimating with a thin-lens formula.

Get sensor pixel count and pitch

{
  "jsonrpc": "2.0",
  "id": "imx477-sensor",
  "method": "tools/call",
  "params": {
    "name": "get_sensor_specs",
    "arguments": { "partNumber": "IMX477" }
  }
}

Returns sensor dimensions, resolution (pixel count), and pixel pitch — e.g. 4056 × 3040 px at 1.55 µm. Use these as inputs to the field-of-view tools, not to hand-calculate FoV.

Field of view for one lens and sensor

{
  "jsonrpc": "2.0",
  "id": "cil250-imx477-fov",
  "method": "tools/call",
  "params": {
    "name": "calculate_field_of_view",
    "arguments": {
      "lensSku": "CIL250",
      "sensorPartNumber": "IMX477"
    }
  }
}

Returns live HFOV, VFOV, and DFOV with an explicit rectilinear comparison and distortion status. Supply focalLengthMm instead of a SKU only for a clearly labeled rectilinear reference.

Read live product truth

{
  "jsonrpc": "2.0",
  "id": "cil250-live-read",
  "method": "tools/call",
  "params": {
    "name": "read_shopify_products",
    "arguments": {
      "sku": "CIL250",
      "limit": 1,
      "includeMetafields": true
    }
  }
}

Read by product handle

{
  "jsonrpc": "2.0",
  "id": "cil250-handle",
  "method": "tools/call",
  "params": {
    "name": "read_shopify_products",
    "arguments": {
      "handle": "telephoto-25mm-m12-lens-cil250",
      "limit": 1
    }
  }
}

Create a cart handoff

{
  "jsonrpc": "2.0",
  "id": "create-cart",
  "method": "tools/call",
  "params": {
    "name": "create_cart",
    "arguments": {
      "cart": {
        "line_items": [
          {
            "quantity": 2,
            "item": { "id": "gid://shopify/ProductVariant/12345678901" }
          }
        ],
        "context": {
          "address_country": "US",
          "address_region": "CA"
        }
      }
    }
  }
}

Prepare a safe handoff

{
  "jsonrpc": "2.0",
  "id": "cil078-route",
  "method": "tools/call",
  "params": {
    "name": "get_purchase_route_options",
    "arguments": {
      "sku": "CIL078",
      "quantity": 2,
      "buyerIntent": "prototype evaluation",
      "agentType": "engineering assistant"
    }
  }
}