Tools Overview

GR-MCP exposes tools in three groups: platform tools (always available) for flowgraph design, block development tools (loaded on demand) for code generation and protocol analysis, and runtime tools (loaded on demand) for container control.

Tool Organization

34 Platform Tools

Always available for flowgraph building, validation, and code generation. No Docker required.

~18 Block Dev Tools

Loaded via enable_block_dev_mode(). Generate blocks, analyze protocols, export to OOT.

~40 Runtime Tools

Loaded via enable_runtime_mode(). Requires Docker for container features.

Platform Tools (Always Available)

Flowgraph Management

Tool	Description
`get_blocks`	List all blocks in the flowgraph
`make_block`	Create a new block
`remove_block`	Remove a block
`save_flowgraph`	Save to `.grc` file
`load_flowgraph`	Load from `.grc` file
`get_flowgraph_options`	Get flowgraph metadata
`set_flowgraph_options`	Set flowgraph metadata
`export_flowgraph_data`	Export as dict
`import_flowgraph_data`	Import from dict

Block Management

Tool	Description
`get_block_params`	List block parameters
`set_block_params`	Set block parameters
`get_block_sources`	List output ports
`get_block_sinks`	List input ports
`bypass_block`	Bypass a block
`unbypass_block`	Unbypass a block

Connection Management

Tool	Description
`get_connections`	List all connections
`connect_blocks`	Connect two blocks
`disconnect_blocks`	Disconnect two blocks

Validation

Tool	Description
`validate_block`	Validate a single block
`validate_flowgraph`	Validate entire flowgraph
`get_all_errors`	Get all validation errors

Platform

Tool	Description
`get_all_available_blocks`	List all block types
`search_blocks`	Search blocks by keyword
`get_block_categories`	List block categories
`load_oot_blocks`	Load OOT block paths
`add_block_path`	Add a block path
`get_block_paths`	List block paths

Code Generation

Tool	Description
`generate_code`	Generate Python code
`evaluate_expression`	Evaluate Python expression
`create_embedded_python_block`	Create embedded Python block

Block Development Tools (Enable with `enable_block_dev_mode()`)

Block Dev Mode Control

Tool	Description
`get_block_dev_mode`	Check block dev mode status
`enable_block_dev_mode`	Enable block dev tools
`disable_block_dev_mode`	Disable block dev tools

Block Generation

Tool	Description
`generate_sync_block`	Generate `gr.sync_block` from description
`generate_basic_block`	Generate `gr.basic_block` with custom forecast
`generate_interp_block`	Generate interpolation block
`generate_decim_block`	Generate decimation block
`validate_block_code`	Validate syntax, imports, signatures
`parse_block_prompt`	Parse natural language into block spec

Block Testing

Tool	Description
`test_block_in_docker`	Test block in isolated Docker container

Protocol Analysis

Tool	Description
`parse_protocol_spec`	Parse protocol description into structured model
`generate_decoder_chain`	Generate multi-block decoder pipeline
`get_missing_oot_modules`	Identify OOT modules needed for a protocol

Signal Analysis

Tool	Description
`analyze_iq_file`	Analyze IQ capture characteristics

OOT Export

Tool	Description
`generate_grc_yaml`	Generate `.block.yml` for GRC integration
`generate_oot_skeleton`	Generate gr_modtool-compatible OOT scaffold
`export_block_to_oot`	Export block to full OOT module structure
`export_from_flowgraph`	Export embedded block from flowgraph to OOT

Runtime Tools (Enable with `enable_runtime_mode()`)

Runtime Mode Control

Tool	Description
`get_runtime_mode`	Check runtime mode status
`enable_runtime_mode`	Enable runtime tools
`disable_runtime_mode`	Disable runtime tools
`get_client_capabilities`	Get MCP client capabilities
`list_client_roots`	List client root directories

Docker Container Management

Tool	Description
`launch_flowgraph`	Launch in Docker container
`list_containers`	List running containers
`stop_flowgraph`	Stop a container
`remove_flowgraph`	Remove a container
`capture_screenshot`	Capture GUI screenshot
`get_container_logs`	Get container logs

XML-RPC Control

Tool	Description
`connect`	Connect to XML-RPC URL
`connect_to_container`	Connect by container name
`disconnect`	Disconnect
`get_status`	Get connection status
`list_variables`	List exposed variables
`get_variable`	Get variable value
`set_variable`	Set variable value
`start`	Start flowgraph
`stop`	Stop flowgraph
`lock`	Lock for updates
`unlock`	Unlock after updates

ControlPort/Thrift

Tool	Description
`connect_controlport`	Connect to ControlPort
`connect_to_container_controlport`	Connect by container
`disconnect_controlport`	Disconnect ControlPort
`get_knobs`	Get knob values
`set_knobs`	Set knob values
`get_knob_properties`	Get knob metadata
`get_performance_counters`	Get perf metrics
`post_message`	Send PMT message

Code Coverage

Tool	Description
`collect_coverage`	Collect coverage data
`generate_coverage_report`	Generate report
`combine_coverage`	Combine multiple runs
`delete_coverage`	Delete coverage data

OOT Module Installation

Tool	Description
`detect_oot_modules`	Detect OOT dependencies
`install_oot_module`	Install OOT module
`list_oot_images`	List installed images
`remove_oot_image`	Remove OOT image
`build_multi_oot_image`	Build combo image
`list_combo_images`	List combo images
`remove_combo_image`	Remove combo image

MCP Resources

In addition to tools, GR-MCP exposes resources for OOT module discovery and block development prompts:

URI	Description
`oot://directory`	Index of all OOT modules in the catalog
`oot://directory/{name}`	Detailed info for a specific module

Block Development Prompts (available when block dev mode is enabled)

URI	Description
`prompts://block-generation/sync-block`	Patterns for `gr.sync_block` generation
`prompts://block-generation/basic-block`	Patterns for `gr.basic_block` generation
`prompts://block-generation/common-patterns`	Reusable block patterns and idioms
`prompts://block-generation/grc-yaml`	GRC YAML `.block.yml` format guide
`prompts://protocol-analysis/decoder-chain`	Decoder pipeline generation patterns