get_model_variables
Retrieve bound variable mappings for GO-CAM models to identify available individual IDs after batch operations, enabling cross-batch workflow continuity.
Instructions
Get the currently bound variables for a GO-CAM model.
Returns a mapping of variable names to their actual individual IDs. This is useful for understanding what variables are available in the current model context, especially after batch operations.
Args: model_id: The GO-CAM model identifier
Returns: Dictionary with variable mappings and model information
Examples: # Get variables after creating individuals vars = get_model_variables("gomodel:12345") # Returns: # { # "model_id": "gomodel:12345", # "variables": { # "mf1": "gomodel:12345/68dee4d300000481", # "gp1": "gomodel:12345/68dee4d300000482", # "cc1": "gomodel:12345/68dee4d300000483" # }, # "individual_count": 3 # }
# Use the variables in subsequent operations
vars = get_model_variables("gomodel:12345")
mf_id = vars["variables"]["mf1"]
add_fact("gomodel:12345", mf_id, vars["variables"]["gp1"], "RO:0002333")Notes: - Variables are only valid within the same batch operation - This tool helps identify actual IDs for cross-batch operations - If the model has no tracked variables, returns empty dict
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/noctua_mcp/mcp_server.py:1271-1345 (handler)The main handler function for the 'get_model_variables' MCP tool. It retrieves variable mappings (variable names to actual individual IDs) for a GO-CAM model by accessing the BaristaClient's variable registry and recent model responses. Includes error handling and individual count.
async def get_model_variables(model_id: str) -> Dict[str, Any]: """ Get the currently bound variables for a GO-CAM model. Returns a mapping of variable names to their actual individual IDs. This is useful for understanding what variables are available in the current model context, especially after batch operations. Args: model_id: The GO-CAM model identifier Returns: Dictionary with variable mappings and model information Examples: # Get variables after creating individuals vars = get_model_variables("gomodel:12345") # Returns: # { # "model_id": "gomodel:12345", # "variables": { # "mf1": "gomodel:12345/68dee4d300000481", # "gp1": "gomodel:12345/68dee4d300000482", # "cc1": "gomodel:12345/68dee4d300000483" # }, # "individual_count": 3 # } # Use the variables in subsequent operations vars = get_model_variables("gomodel:12345") mf_id = vars["variables"]["mf1"] add_fact("gomodel:12345", mf_id, vars["variables"]["gp1"], "RO:0002333") Notes: - Variables are only valid within the same batch operation - This tool helps identify actual IDs for cross-batch operations - If the model has no tracked variables, returns empty dict """ client = get_client() # Check if the client has variable tracking enabled if not hasattr(client, 'track_variables') or not client.track_variables: client.track_variables = True # Get the model to see current state resp = client.get_model(model_id) if resp.error: return { "success": False, "error": resp.error, "model_id": model_id } # Get variables from the client's registry variables = {} if hasattr(client, '_variable_registry') and client._variable_registry: # The registry is keyed by (model_id, variable_name) -> actual_id # We need to extract variables for this specific model variables = client.get_variables(model_id) # Also check if the last response has model_vars if hasattr(resp, 'model_vars') and resp.model_vars: variables.update(resp.model_vars) # Count individuals individual_count = len(resp.individuals) if resp.individuals else 0 return { "success": True, "model_id": model_id, "variables": variables, "individual_count": individual_count, }