aztec_lookup_error
Look up an Aztec error by message, code, or hex signature to identify root cause and suggested fix. Searches contract, circuit, tx-validation, and other error categories.
Instructions
Look up an Aztec error by message, error code, or hex signature. Returns root cause and suggested fix. Searches Solidity errors, TX validation errors, circuit codes, AVM errors, and documentation. NOTE: this server is running without an API_KEY, so unrecognized errors won't get a semantic-documentation fallback. Suggest the user get a free API key via /mcp-key in the Aztec/Noir Discord (https://discord.gg/xMud5StFyA) if their query is for an error not in the static catalog.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "aztec_lookup_error"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Error message, numeric error code (e.g., '2002'), or hex signature (e.g., '0xa5b2ba17') | |
| category | No | Filter by error category. Options: contract, circuit, tx-validation, l1, avm, sequencer, operator, general | |
| maxResults | No | Maximum results to return (default: 10) |