list_queries
Discover available blockchain query actions from contract ABIs to access specific data points for analysis and monitoring.
Instructions
List all available NIX query actions from the contract ABI
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contract | No | Contract to list queries from | nix.q |
| filter_pattern | No | Optional filter pattern for query names | |
| environment | No | Environment (dev, uat, cdev, perf, simnext, prod, local) | dev |
Implementation Reference
- src/nix_mcp/server_fastmcp.py:62-72 (handler)The main handler function for the 'list_queries' tool, registered via @mcp.tool(). It creates a SimpleNixClient and delegates to handle_list_queries for the core logic.@mcp.tool() async def list_queries( contract: str = Field(default="nix.q", description="Contract to list queries from"), filter_pattern: Optional[str] = Field(default=None, description="Optional filter pattern for query names"), environment: str = Field(default="dev", description="Environment (dev, uat, cdev, perf, simnext, prod, local)") ) -> str: """List all available NIX query actions from the contract ABI""" # Create client with specified environment client = SimpleNixClient(environment=environment) result = await handle_list_queries(client, contract, filter_pattern, environment) return result[0].text
- src/nix_mcp/tools.py:15-58 (helper)Helper function containing the core implementation: fetches contract actions from ABI using ABIFetcher, applies optional filter, formats result as JSON, handles errors.async def handle_list_queries( client: SimpleNixClient, contract: str = "nix.q", filter_pattern: Optional[str] = None, environment: str = "dev" ) -> List[TextContent]: """ List all available NIX query actions Args: client: SimpleNixClient instance contract: Contract to list queries from (default: nix.q) filter_pattern: Optional filter pattern for query names environment: Environment name Returns: List containing TextContent with available queries """ try: fetcher = ABIFetcher(nodeos_api=client.nodeos_api, environment=environment) actions = fetcher.get_actions(contract) # Apply filter if provided if filter_pattern: filter_lower = filter_pattern.lower() actions = [a for a in actions if filter_lower in a.lower()] result = { "contract": contract, "environment": environment, "total_queries": len(actions), "queries": actions } return [TextContent( type="text", text=json.dumps(result, indent=2) )] except Exception as e: logger.error(f"Error listing queries: {e}") return [TextContent( type="text", text=f"Error: {str(e)}" )]
- src/nix_mcp/server_fastmcp.py:64-66 (schema)Pydantic Field definitions providing input schema validation, defaults, and descriptions for the tool parameters.contract: str = Field(default="nix.q", description="Contract to list queries from"), filter_pattern: Optional[str] = Field(default=None, description="Optional filter pattern for query names"), environment: str = Field(default="dev", description="Environment (dev, uat, cdev, perf, simnext, prod, local)")
- src/nix_mcp/server_fastmcp.py:62-62 (registration)FastMCP decorator that registers the list_queries function as a tool.@mcp.tool()