Developer Tools
commonlands.com
Provides an API to search and retrieve specifications for lenses and sensors, and compute field of view for machine vision applications.
ENDPOINT 1
https://mcp.commonlands.com/mcp
MCP server metadata
- Name
- commonlands-mcp
- Version
- 0.4.1
Commonlands MCP public endpoint is https://mcp.commonlands.com/mcp. Use this endpoint in client configuration, metadata, and agent-facing descriptions. Commonlands MCP helps agents select precision optics for machine vision, robotics, and embedded vision: M12 lenses, C-mount lenses, and lens field of view calculations. Usage flow: discover lenses with search_lens_catalog/search_catalog, inspect distortion with get_lens_distortion_profile, compute lens field of view with calculate_field_of_view, rank options with match_lens_to_sensor/compare_lenses/recommend_lenses_for_application, then use read_shopify_products for live purchasable truth before quoting price, availability, Shopify variantId, product URL, or cart payloads. FoV rule: catalog EFL, image circle, max FoV/FOV@image-circle, and distortion display fields are insufficient to compute field of view on a specific sensor; do not interpolate or estimate interior sensor FoV from those fields. Always call calculate_field_of_view for one lens/sensor pair or match_lens_to_sensor for catalog-wide per-sensor HFOV/VFOV/DFOV selection. Do not run DIY optics math, interpolate catalog FoV, infer coverage, or assemble sensor-specific optical numbers outside Commonlands MCP computed responses. Source-labeling policy: label every optical or commerce claim with its source; preserve returned provenance.method, provenance.rev, coverage class, distortion-at-field-edge status, and Shopify live-read versus fixture/source-warning distinctions. For sensor-specific lens finding, prefer match_lens_to_sensor when the user gives a sensor or target FoV, then call calculate_field_of_view for each final lens/sensor FoV claim. Use search_lens_catalog only for broad SKU/title/mount discovery. Safety boundaries: fixture-backed tools are scaffold/context only; Shopify product/cart truth is read-only unless approved cart tools are explicitly listed in tools/list; cancel, checkout, payment, customer, order, inventory, and product writes remain hidden/gated unless separately approved. Do not pass arbitrary URLs or client-supplied downstream tokens; Commonlands uses fixed allowlisted endpoints and server-side secrets only, and does not accept client-supplied downstream tokens.
Known tools 21
calculate_field_of_viewCalculate Commonlands lens field of view for a lens/sensor pair and return HFOV, VFOV, DFOV, coverage, distortion status, and an explicit rectilinear comparison.
Inferred read-onlymatch_lens_to_sensorFind and rank Commonlands lenses for a sensor, target field of view, working distance, mount, or "lens for" request.
Inferred read-onlysearch_lens_catalogSearch the Commonlands lens catalog by SKU, mount, lens type, M12, C-mount, or application text.
Inferred read-onlyget_lens_distortion_profileReturn the Commonlands distortion model/status for one lens SKU, including whether the data is source-display-only or backend-calculated.
Inferred read-onlyget_sensor_specsReturn sensor dimensions, pixel pitch, and resolution for lens field of view, M12 lens, and C-mount lens matching inputs.
Inferred read-onlycompare_lensesCompare selected Commonlands M12 lens and C-mount lens SKUs on the same sensor with the same deterministic scoring model.
Inferred read-onlyget_product_page_detailsReturn fixture-backed product-page handoff details for one lens, including DynamoDB-sourced optical specs and gated datasheet policy.
Inferred read-onlyget_catalog_snapshot_statusReturn fixture-backed joined catalog counts, validation status, source provenance, live connector readiness, and non-authoritative product-truth warning.
Inferred read-onlyget_shopify_ucp_readinessReport connector-free Shopify Storefront MCP and UCP Catalog compatibility, launch blockers, and Commonlands engineering differentiators.
Inferred read-onlyget_shopify_readonly_config_statusReport sanitized Cloudflare Shopify binding presence, approved read scopes, and read-only safety flags without exposing secrets or calling Shopify.
Inferred read-onlyread_shopify_productsUse this for live purchasable product truth: product and variant IDs, SKUs, prices, coarse availability, product URLs, and public product-page metafields.
Inferred read-onlycreate_cartCreate a Shopify-owned cart for selected variant line items through the configured Shopify Cart/Storefront MCP endpoint.
Potential side effectsupdate_cartUpdate a Shopify-owned cart through the configured Cart/Storefront MCP endpoint.
Potential side effectssearch_catalogFixture-backed UCP Catalog search alias for Shopify-native product discovery; no live Shopify calls or cart behavior.
Inferred read-onlylookup_catalogFixture-backed UCP Catalog lookup alias for product, variant, SKU, handle, or URL identifiers; returns not-found messages instead of writes.
Inferred read-onlyget_productFixture-backed UCP Catalog product detail alias with Commonlands optical metadata and Shopify-native handoff fields.
Inferred read-onlyprepare_shopify_purchase_handoffBuild a read-only Shopify-native purchase handoff seam for a selected lens without creating carts, checkout, orders, inventory mutations, or writes.
Potential side effectsget_purchase_route_optionsReturn safe dual-channel purchase route options for AI agents and robotics engineers across Commonlands MCP and Shopify-native channels without mutating commerce state.
Potential side effectsrecommend_lenses_for_applicationRank 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.
Inferred read-onlysubmit_rfqForward a buyer request-for-quote or engineering question to the Commonlands engineering team.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.commonlands-mcp]
url = "https://mcp.commonlands.com/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"commonlands-mcp": {
"type": "http",
"url": "https://mcp.commonlands.com/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: commonlands-mcp
Remote MCP URL: https://mcp.commonlands.com/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"commonlands-mcp": {
"url": "https://mcp.commonlands.com/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"commonlands-mcp": {
"type": "http",
"url": "https://mcp.commonlands.com/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "commonlands-mcp",
"transport": "streamable-http",
"url": "https://mcp.commonlands.com/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Trust Data Available
BuiltWith Trust API v2 evidence for commonlands.com was fetched 2026-07-26T06:44:35.079Z and is being refreshed.
commonlands.com is assessed as Trusted: Domain has an established technology history spanning over a year.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.