MCP API Reference

Get the architecture graph at a specific path. Returns components, connections, and subgraph information at the current level. Inside subgraphs, external nodes (marked external: true) are auto-generated from parent-level connections — do not create them manually.

List all components in the architecture diagram, including their names, types, layers, and positions.

No parameters.

List all available component types from the Component Library. Returns types formatted as Category/Item (e.g. Database/Redis). Must be called before add_component or update_component to get valid types.

No parameters.

Add a new component to the diagram. The type must be an exact match from list_types output.

Modify an existing component. Use get_graph to find component IDs or names first.

Remove a component and all its connections from the diagram.

Create a connection between two components.

Modify an existing connection's properties.

Remove a connection from the diagram.

Add a note or annotation to a component (constraints, TODOs, considerations).

Update the project title and/or description. These are displayed in the breadcrumb bar, used as suggested filenames when saving, and included in Mermaid export metadata.

Select a component or enter its subgraph to bring it to the user's attention.

Get the current user context: which path they are viewing and what is selected. Useful before making changes.

No parameters. Returns current path, selected component (id, name, type), and selected connection (id, from, to, protocol).

Temporarily highlight a data flow path through the architecture. Components are matched by name in order — connections between successive pairs are highlighted.

Remove temporary path highlights. Call with no arguments to clear all, or pass a specific ID.

Save the current active highlights as a named, persistent flow. Use highlight_path first to create highlights, then save_flow to persist them.

List all saved flows. Returns IDs, labels, and path counts.

No parameters.

Re-display a saved flow by highlighting its paths on the canvas. Clears existing highlights first.

Modify an existing flow: rename, add or remove paths, or append segments. At least one optional parameter must be provided. All segments within a single path must be at the same graph level (same parentPath). Use separate paths for different levels.

Permanently remove a saved flow. Does not affect current highlights.

Take a screenshot of the current architecture view. Returns a PNG image. Supports two capture modes and optional file export.

Export the architecture as a Mermaid flowchart diagram. Returns plain text with layer subgraphs, component nodes, and protocol-labeled edges. Handles nested subgraphs recursively. The output includes metadata comments (@layer, @component, @connection) that preserve component types, technologies, positions, and descriptions for lossless roundtrip with import_mermaid.

No parameters.

Import a Mermaid flowchart and replace the current architecture with it. Supports enriched Mermaid with @component, @connection, and @layer metadata comments for full roundtrip fidelity. Plain Mermaid without metadata is also supported with sensible defaults.

Run the force-directed layout algorithm on the architecture. Pinned components stay fixed while unpinned ones are repositioned to minimize overlaps and edge crossings.

Pin every unpinned component so Auto Layout won't move them. Returns the list of newly pinned component IDs (use them with unpin_components to restore later).

Unpin specific components so Auto Layout can move them again. Use the IDs returned by pin_all to restore components to their original unpinned state.

List all layers in the architecture with their names and colors. Layers define the vertical organization (frontend at top, data at bottom).

No parameters.

Add one or more layers to the architecture. Accepts an array for batch creation.

Update one or more layers' name or color. When a name is changed, all components on that layer are automatically reassigned to the new name.

Remove one or more layers. Components on removed layers are reassigned to the first remaining layer. Cannot remove the last layer.

Reorder layers in the architecture. Provide all layer names in the desired order, from top to bottom.

Generate a temporary URL and token for downloading the current architecture as JSON. Call confirm_download after a successful download to mark the graph as saved.

No parameters.

Confirm that a download was successful, marking the graph as saved.

Generate a temporary URL and token for uploading a new architecture JSON file. Fails if there are unsaved changes unless force is set.