3DOptix MCP server

3DOptix for AI coding agents

Design, simulate and analyse optical systems from your coding agent, using the 3DOptix cloud platform.

This repository is a plugin — it bundles the 3DOptix MCP server together with a skill that teaches the agent how to use it well. Install it once and your agent can build optical setups, place lenses and detectors, run GPU ray-trace simulations and advanced optical analysis.

Skills here follow the Agent Skills open standard, so they work in Claude Code, Codex, Cursor and other compliant clients.

Install

Claude Code

claude plugin marketplace add 3doptix/skills
claude plugin install 3doptix@3doptix

Codex

codex plugin marketplace add 3doptix/skills
codex plugin add 3doptix@3doptix

Just the MCP server

If you only want the tools and not the workflow guidance, the server is listed in the MCP Registry as com.3doptix/optical-design, or add it directly:

claude mcp add --transport http 3doptix https://mcp.3doptix.com

Connect your account

You need a 3DOptix account. New sign-ups at 3doptix.com get a fully functional trial; continued use needs a subscription.

Authentication is OAuth 2.0 with dynamic client registration. There is no API key to paste.

• Claude Code — run /mcp, select 3doptix, sign in via the browser.
• Codex — run codex mcp login 3doptix.

Then confirm it worked by asking your agent to list your setups. Your agent can also walk you through this itself — the bundled 3doptix-setup skill activates on connection errors. Full troubleshooting: skills/3doptix-setup/SKILL.md.

What's included

The 3doptix MCP server provides tools for setups, parts, the optics and optomechanics catalogs, simulation, analysis and rendering. Tool reference: 3doptix.com.

Try it

Build a 2-lens beam expander for a 5 mm 632 nm beam, 3× magnification,
then run a spot diagram on the output.

Import my Zemax file into 3DOptix and tell me where the aberrations are worst.

Repository layout

.claude-plugin/     Claude Code plugin + marketplace manifests
.codex-plugin/      Codex plugin manifest
.agents/plugins/    Codex marketplace manifest
.mcp.json           The 3DOptix remote MCP server
server.json         MCP Registry entry
skills/             Agent Skills — shared by every store
assets/             Store icons (the spectral sphere from the 3DOptix mark)
scripts/            validate.js, set-version.js — plain Node, no dependencies

Skill content lives in exactly one place. Each store gets a small manifest pointing at the same skills/ tree — nothing is duplicated per client.

There is no build step. Skills are Markdown and manifests are JSON, so what you see here is exactly what gets installed.

Contributing

Adding a skill

Create skills//SKILL.md with the required frontmatter:

---
name: your-skill-name
description: "When this skill should and should not trigger."
---

name must match the directory name — every store enforces this. Put anything lazily loaded in skills//references/ and point at it from SKILL.md. Skills are discovered by directory, so there is no manifest to register a new one in.

Shortened. The full README is on GitHub.