Namespace System - Azyrom Help

The Namespace System organizes Azyrom's 74 MCP tools into 18 logical categories with lazy loading for optimal performance. Only the tools you need are loaded.

How It Works

Instead of loading all 74 tools at startup:

5 Default Namespaces load immediately (~40 tools)
13 Additional Namespaces load on-demand
Automatic Activation when you use a tool from inactive namespace
Faster Connections - smaller initial handshake

Active by Default (5 Namespaces)

These namespaces load immediately for instant access:

1. document (5 tools)

Purpose: Document-level operations

get_document_info - Get document metadata
get_all_elements - List all elements
clear_canvas - Remove all elements
undo - Undo last action
redo - Redo last undone action

2. create (7 tools)

Purpose: Basic element creation

create_rectangle - Create rectangle
create_circle - Create circle/ellipse
create_text - Create text element
create_line - Create line
create_image - Create image element
create_frame - Create frame (container)
create_group - Create group from elements

3. modify (8 tools)

Purpose: Element modification

update_element - Update properties
delete_element - Delete element
duplicate_element - Duplicate element
get_element - Get element details
move_element - Move by offset
resize_element - Resize dimensions
rotate_element - Rotate by angle
set_element_name - Set name/label

4. select (7 tools)

Purpose: Selection and visibility

select_element - Select element(s)
get_selection - Get selected elements
clear_selection - Clear selection
select_all - Select all elements
show_element - Make visible
hide_element - Make invisible
toggle_element_visibility - Toggle visibility

5. transform (4 tools)

Purpose: Transformations

move_element - Move by offset
resize_element - Resize dimensions
rotate_element - Rotate by angle
scale_element - Scale uniformly

Available on Demand (13 Namespaces)

These namespaces activate automatically when you use their tools:

6. zorder (6 tools)

Purpose: Z-order and hierarchy

bring_to_front, send_to_back
bring_forward, send_backward
set_parent, unparent_element

7. style (5 tools)

Purpose: Basic styling

set_fill_color, set_stroke_color
set_stroke_width, set_opacity
set_corner_radius

8. gradient (6 tools)

Purpose: Gradient fills

set_linear_gradient, set_radial_gradient
set_angular_gradient
add_gradient_stop, update_gradient_stop
remove_gradient_stop

9. effect (6 tools)

Purpose: Visual effects

add_drop_shadow, add_inner_shadow
add_layer_blur, add_background_blur
update_effect_property, remove_effect

10. text (5 tools)

Purpose: Text formatting

set_text_content, set_font_family
set_font_size, set_font_weight
set_text_align

11. image (6 tools)

Purpose: Image adjustments

set_image_brightness, set_image_contrast
set_image_saturation, set_image_hue
set_image_exposure
reset_image_adjustments

12. layout (6 tools)

Purpose: Layout and alignment

align_elements, distribute_elements
set_constraints
lock_element, unlock_element
set_blend_mode

13. boolean (5 tools)

Purpose: Boolean operations

union_elements, subtract_elements
intersect_elements, exclude_elements
flatten_element

14. component (3 tools)

Purpose: Component system

create_component
create_instance
detach_instance

15. variable (6 tools)

Purpose: Design variables

create_variable, update_variable
delete_variable, get_variables
get_collections
bind_variable

16. prototype (5 tools)

Purpose: Prototyping flows

create_flow, update_flow
delete_flow, get_flows
set_default_flow

17. composite (8 tools)

Purpose: Composite UI components

create_ui_status_bar, create_ui_navbar
create_ui_button, create_ui_tab_bar
create_ui_input, create_ui_card
create_ui_list_item
create_ui_home_indicator

18. template (1 tool)

Purpose: Screen templates

create_screen_from_template (login, settings, profile, dashboard, list)

How Lazy Loading Works

Initial Connection

Claude Desktop connects to Azyrom MCP server
Initialization handshake occurs
5 default namespaces load (~40 tools)
Connection ready in ~2 seconds

On-Demand Activation

You ask: "Add a gradient to this rectangle"
Claude attempts to use set_linear_gradient
gradient namespace activates automatically
Tool executes successfully
Gradient tools now available for rest of session

No Manual Activation

You don't need to manually activate namespaces. Claude handles this automatically when you request features from inactive namespaces.

Performance Benefits

Faster Initial Connection

Before: Load all 74 tools (~5-7 seconds)
After: Load 40 default tools (~2 seconds)
Improvement: 60% faster startup

Reduced Network Payload

Initial tools/list: 40 tools instead of 74
Smaller JSON: 45% smaller initial handshake
Faster Parsing: Less data to process

Memory Efficiency

Only active namespaces consume memory
Typical session uses 6-8 namespaces (not all 18)
Lower baseline memory usage

Usage Examples

Example 1: Basic Design (Default Namespaces)

"Create 3 rectangles and select them all"

Namespaces Used: create, select (both default)

Activation: None needed, instant execution

Example 2: Styled Design (Mixed Namespaces)

"Create a rectangle with a blue-to-purple gradient and drop shadow"

Namespaces Used: create (default), gradient (on-demand), effect (on-demand)

Activation: gradient and effect namespaces activate automatically

Example 3: Complete UI (Composite Namespace)

"Create a primary button with label 'Submit' and an arrow icon"

Namespaces Used: composite (on-demand)

Activation: composite namespace activates, returns styled button

Checking Active Namespaces

To see which namespaces are currently loaded:

"What MCP tools are available right now?"

Claude will list all tools from active namespaces. Initially you'll see ~40 tools from the 5 default namespaces.

Best Practices

Don't Pre-activate - Let namespaces load as needed
Trust Automation - Claude handles namespace activation
Start Simple - Use default namespaces first to verify connection
Session Persistence - Once activated, namespaces stay active for the session