Usable by AI assistants

shine-mcp is a Model Context Protocol server. Assistants can list the building blocks, simulate circuits and sweep spectra, program MZI meshes for a matrix, read the displays and outputs of a saved project, and save a circuit as a project you open and refine in the editor.

Connect it

Download shine-mcp with a release, then point your client at it:

{
  "mcpServers": {
    "shine": { "command": "shine-mcp" }
  }
}

Tools

`list_blocks`

Lists the building blocks, their ports, parameters, defaults and units.

`simulate_circuit`

Solves a circuit exactly at every laser wavelength: detector readings, output powers, fields.

`sweep_wavelength`

Spectra of filters, rings and interferometers over a wavelength range.

`decompose_matrix`

MZI phase settings that implement a matrix on a chip (Reck or SVD meshes).

`simulate_project`

Opens a saved project and reports detectors, displays and outputs of every document.

`save_project`

Writes a circuit as a project a person can open and edit in the editor.

For language models

The whole documentation is available as plain text: llms.txt (an index) andllms-full.txt (everything in one file).

Read the AI guide →