{
 "synced": "2026-11-19",
 "count": 36,
 "tools": [
  {
   "name": "network_info",
   "description": "Which network Onggi serves right now: chain id, latest block, base fee, native coin and explorer. Call this first if unsure.",
   "inputSchema": {
    "type": "object",
    "properties": {}
   },
   "group": "inspect"
  },
  {
   "name": "get_balance",
   "description": "Native coin balance of an address, plus ERC-20 balances for any token contracts you list.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "tokens": {
      "type": "array",
      "items": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "EVM address, 0x followed by 40 hex characters"
      },
      "maxItems": 25,
      "description": "ERC-20 contracts to check"
     }
    },
    "required": [
     "address"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "get_block",
   "description": "A block by number, or the latest one: time, transaction count, gas used and base fee.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "block": {
      "type": [
       "integer",
       "string"
      ],
      "description": "block number, or \"latest\""
     }
    }
   },
   "group": "inspect"
  },
  {
   "name": "get_transaction",
   "description": "A transaction by hash with its receipt, explained in plain words, including token transfers and approvals it emitted.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
     }
    },
    "required": [
     "hash"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "read_contract",
   "description": "Call a view function. Give the signature with return types, for example \"balanceOf(address) returns (uint256)\".",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "signature": {
      "type": "string",
      "description": "e.g. \"totalSupply() returns (uint256)\""
     },
     "args": {
      "type": "array",
      "items": {}
     }
    },
    "required": [
     "address",
     "signature"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "get_logs",
   "description": "Events emitted by one contract over a block range of up to 5,000 blocks, optionally filtered by event signature.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "event": {
      "type": "string",
      "description": "e.g. \"Transfer(address,address,uint256)\""
     },
     "from_block": {
      "type": "integer"
     },
     "to_block": {
      "type": "integer"
     }
    },
    "required": [
     "address"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "token_info",
   "description": "Name, symbol, decimals and total supply of an ERC-20 token, plus whether the address has contract code.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     }
    },
    "required": [
     "address"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "gas_price",
   "description": "Current base fee and a suggested priority fee, in gwei.",
   "inputSchema": {
    "type": "object",
    "properties": {}
   },
   "group": "inspect"
  },
  {
   "name": "explain_transaction",
   "description": "Explain calldata or a raw signed transaction in plain words, with risk flags such as unlimited approvals. Does not touch the chain.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "data": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]*$"
     },
     "to": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "value": {
      "type": "string"
     },
     "raw": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]*$",
      "description": "a raw signed transaction instead of data"
     }
    }
   },
   "group": "check"
  },
  {
   "name": "simulate",
   "description": "Run a transaction against current state without sending it: would it succeed, why it would revert, gas estimate, and what it does.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "to": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "data": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]*$"
     },
     "signature": {
      "type": "string"
     },
     "args": {
      "type": "array",
      "items": {}
     },
     "value": {
      "type": "string",
      "description": "in wei"
     }
    },
    "required": [
     "from"
    ]
   },
   "group": "check"
  },
  {
   "name": "estimate_gas",
   "description": "Gas a transaction would use and what it would cost at the current fee, in native coin.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "to": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "data": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]*$"
     },
     "value": {
      "type": "string"
     }
    },
    "required": [
     "from"
    ]
   },
   "group": "check"
  },
  {
   "name": "prepare_transaction",
   "description": "Build a transaction for the user to sign. It is simulated first; the result includes a signing link to open in the browser, where the wallet asks for the signature. Onggi never signs.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "to": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "data": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]*$"
     },
     "signature": {
      "type": "string",
      "description": "function signature instead of data, e.g. \"transfer(address,uint256)\""
     },
     "args": {
      "type": "array",
      "items": {}
     },
     "value": {
      "type": "string",
      "description": "in wei"
     },
     "summary": {
      "type": "string",
      "description": "one line shown to the user on the signing page"
     }
    },
    "required": [
     "from"
    ]
   },
   "group": "prepare"
  },
  {
   "name": "prepare_deploy",
   "description": "Prepare a contract deployment from compiled bytecode (and ABI-encoded constructor arguments, if any). Simulated first, returns a signing link.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "bytecode": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]*$"
     },
     "constructor": {
      "type": "string",
      "description": "e.g. \"constructor(string,uint256)\""
     },
     "args": {
      "type": "array",
      "items": {}
     }
    },
    "required": [
     "from",
     "bytecode"
    ]
   },
   "group": "prepare"
  },
  {
   "name": "wait_for_receipt",
   "description": "Wait up to 60 seconds for a transaction to be mined and return its outcome.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
     },
     "timeout_seconds": {
      "type": "integer",
      "maximum": 60
     }
    },
    "required": [
     "hash"
    ]
   },
   "group": "prepare"
  },
  {
   "name": "encode_call",
   "description": "ABI-encode a function call, for example to pass as data to simulate or prepare_transaction.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "signature": {
      "type": "string"
     },
     "args": {
      "type": "array",
      "items": {}
     }
    },
    "required": [
     "signature"
    ]
   },
   "group": "prepare"
  },
  {
   "name": "check_allowance",
   "description": "How much of a token a spender may still take from an owner, and whether it is unlimited. Use it before and after revoking.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "owner": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "spender": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     }
    },
    "required": [
     "token",
     "owner",
     "spender"
    ]
   },
   "group": "check"
  },
  {
   "name": "wallet_overview",
   "description": "A practical wallet snapshot: native balance, pending nonce and any ERC-20 balances with token metadata. Use this before planning account actions.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "tokens": {
      "type": "array",
      "items": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "EVM address, 0x followed by 40 hex characters"
      },
      "maxItems": 25,
      "description": "ERC-20 contract addresses"
     }
    },
    "required": [
     "address"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "token_metadata_batch",
   "description": "Resolve name, symbol, decimals and total supply for up to 25 ERC-20 contracts in one call.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "tokens": {
      "type": "array",
      "items": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "EVM address, 0x followed by 40 hex characters"
      },
      "maxItems": 25,
      "description": "ERC-20 contract addresses",
      "minItems": 1
     }
    },
    "required": [
     "tokens"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "get_token_transfers",
   "description": "Incoming and outgoing ERC-20 transfers for a wallet over a block range, with direction and decoded amounts. Useful for recent account activity.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "from_block": {
      "type": "integer"
     },
     "to_block": {
      "type": "integer"
     },
     "limit": {
      "type": "integer",
      "maximum": 50
     }
    },
    "required": [
     "token",
     "address"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "transaction_status",
   "description": "A lightweight transaction status check: pending, success or failed, block number and confirmations.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
     }
    },
    "required": [
     "hash"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "contract_info",
   "description": "Check whether an address is a contract, its code size and hash, native balance and current nonce.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     }
    },
    "required": [
     "address"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "storage_at",
   "description": "Read one contract storage slot at a specified block. Useful for inspecting proxy and protocol state.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "slot": {
      "type": [
       "string",
       "integer"
      ],
      "description": "storage slot as decimal or hex"
     },
     "block": {
      "type": [
       "string",
       "integer"
      ],
      "description": "block number or latest"
     }
    },
    "required": [
     "address",
     "slot"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "get_nonce",
   "description": "Current account nonce, using the pending pool by default. Use this when building or replacing transactions.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "pending": {
      "type": "boolean"
     }
    },
    "required": [
     "address"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "fee_history",
   "description": "Recent base fees, block utilization and priority-fee percentiles for better gas decisions.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "block_count": {
      "type": "integer",
      "maximum": 100
     },
     "percentiles": {
      "type": "array",
      "items": {
       "type": "number"
      },
      "maxItems": 10
     }
    },
    "required": []
   },
   "group": "inspect"
  },
  {
   "name": "get_block_transactions",
   "description": "List transactions in a block with sender, recipient and native value. Returns up to 50 transactions.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "block": {
      "type": [
       "integer",
       "string"
      ],
      "description": "block number or latest"
     }
    },
    "required": []
   },
   "group": "inspect"
  },
  {
   "name": "batch_simulate",
   "description": "Dry-run up to ten transactions in one call and return each outcome, gas estimate and plain-words explanation.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "transactions": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "items": {
       "type": "object",
       "properties": {
        "from": {
         "type": "string",
         "pattern": "^0x[0-9a-fA-F]{40}$",
         "description": "EVM address, 0x followed by 40 hex characters"
        },
        "to": {
         "type": "string",
         "pattern": "^0x[0-9a-fA-F]{40}$",
         "description": "EVM address, 0x followed by 40 hex characters"
        },
        "data": {
         "type": "string",
         "pattern": "^0x[0-9a-fA-F]*$"
        },
        "value": {
         "type": "string",
         "description": "in wei"
        }
       },
       "required": [
        "from"
       ]
      }
     }
    },
    "required": [
     "transactions"
    ]
   },
   "group": "check"
  },
  {
   "name": "audit_approvals",
   "description": "Audit ERC-20 allowances for a wallet across up to 25 spenders. Flags unlimited access without preparing any transaction.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "owner": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "spenders": {
      "type": "array",
      "items": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "EVM address, 0x followed by 40 hex characters"
      },
      "minItems": 1,
      "maxItems": 25
     }
    },
    "required": [
     "token",
     "owner",
     "spenders"
    ]
   },
   "group": "check"
  },
  {
   "name": "portfolio_report",
   "description": "A combined account report with native and token balances, pending nonce and optional allowance review for one spender.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "tokens": {
      "type": "array",
      "items": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "EVM address, 0x followed by 40 hex characters"
      },
      "maxItems": 25,
      "description": "ERC-20 contract addresses"
     },
     "spender": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     }
    },
    "required": [
     "address"
    ]
   },
   "group": "inspect"
  },
  {
   "name": "prepare_native_transfer",
   "description": "Prepare a native-coin transfer from a user-friendly recipient and wei amount. Simulated first and restricted by the key policy.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "to": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "amount_wei": {
      "type": "string",
      "description": "native amount in wei"
     }
    },
    "required": [
     "from",
     "to",
     "amount_wei"
    ]
   },
   "group": "prepare"
  },
  {
   "name": "prepare_token_transfer",
   "description": "Prepare an ERC-20 transfer using a decimal token amount. Handles decimals, simulation, fees, policy and signing link.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "to": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "amount": {
      "type": "string",
      "description": "decimal token amount"
     }
    },
    "required": [
     "token",
     "from",
     "to",
     "amount"
    ]
   },
   "group": "prepare"
  },
  {
   "name": "prepare_approve",
   "description": "Prepare a finite ERC-20 approval. Unlimited approvals are deliberately not supported by this tool.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "spender": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "amount": {
      "type": "string",
      "description": "finite decimal token allowance"
     }
    },
    "required": [
     "token",
     "from",
     "spender",
     "amount"
    ]
   },
   "group": "prepare"
  },
  {
   "name": "prepare_revoke",
   "description": "Prepare an approve(spender, 0) transaction that removes an existing ERC-20 allowance.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "from": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     },
     "spender": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x followed by 40 hex characters"
     }
    },
    "required": [
     "token",
     "from",
     "spender"
    ]
   },
   "group": "prepare"
  },
  {
   "name": "set_agent_policy",
   "description": "Set guardrails for the current access key: enable preparation, max native value per transaction, allowed contracts and deployment permission.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "transactions_enabled": {
      "type": "boolean"
     },
     "max_value_wei": {
      "type": "string",
      "description": "maximum native value per transaction"
     },
     "allowed_contracts": {
      "type": "array",
      "items": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "EVM address, 0x followed by 40 hex characters"
      },
      "maxItems": 25,
      "description": "ERC-20 contract addresses"
     },
     "allow_deploy": {
      "type": "boolean"
     }
    },
    "required": []
   },
   "group": "agent"
  },
  {
   "name": "get_agent_policy",
   "description": "Read transaction guardrails attached to the current access key.",
   "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
   },
   "group": "agent"
  },
  {
   "name": "delete_agent_policy",
   "description": "Remove transaction guardrails from the current access key and restore its default behavior.",
   "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
   },
   "group": "agent"
  },
  {
   "name": "get_agent_usage",
   "description": "Inspect call volume, tool usage and transaction policy for the current access key.",
   "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
   },
   "group": "agent"
  }
 ]
}