Codex plugin and MCP tools

Give Codex a typed editing workflow and stable inspect, validate, export, generate, and import operations.

When to use

Install the plugin when using Codex to create, review, migrate, validate, or generate a Service Architect project.

Behavior

The plugin runs sa-dsl-mcp over local stdio through uvx and caches the package after first startup.
Skills instruct Codex to edit typed Python rather than hand-edit generated canonical YAML.
Every MCP result includes schemaVersion, operation, status, diagnostics, and artifact metadata where applicable.
Stable diagnostic codes and model paths let an agent repair the owning declaration deterministically.

MCP tools properties

Operations exposed by the local server.

PropertyTypeDescription

inspect_projectread-only

Read manifest metadata without executing Python.

validate_projectexecute

Run trusted Python and return graph diagnostics.

export_projectwrite YAML

Produce canonical interchange at the manifest path.

generate_projectAPI + ZIP

Generate and save target-runtime project code.

import_yaml_projectcreate project

Migrate canonical YAML into modular typed Python and a manifest.

Install and verify

codex plugin marketplace add gorundebug/sa-python-dsl
codex plugin add service-architect@service-architect

codex plugin marketplace list
codex plugin list