Onggi docs
Pools, vaults and lending on GIWA in one account, an agent that prepares actions for your signature, and an MCP gateway for AI clients.
Your account
Everything runs from one account. Cash is USDC. Liquidity positions, vault deposits and supplied capital count as positions. Borrowed USDC counts as debt. Your net value is cash plus positions and supplied capital, less debt.
Demo and onchain are separate. The Onchain page uses your real wallet and real transactions. It never mixes with the demo balance, and it only accepts deposits into vaults whose chain, token and deployed bytecode are verified in the registry.
Liquidity pools
A position holds two tokens inside a price range you choose. While the price is inside the range, your liquidity is used for trades and earns that share of the pool fee.
- Both tokens are needed for a range that contains the current price. Onggi does not swap for you to balance them.
- Out of range the deposit is single sided and earns nothing until the price comes back inside.
- A range is fixed. To move it, remove the liquidity and open a new position.
- Returns come from trading fees and depend on price movement and impermanent loss.
How new pools are listed
Pools are read from the creation events of the supported DEX factories, not from token lists. A pool appears once the block that created it is final and both tokens have contract code and metadata. Pools from unknown factories never appear.
Vaults
A vault runs a strategy for you: a managed liquidity range or a lending reserve. Each vault page shows where the yield comes from and the withdrawal terms before you deposit.
The custody vault is the exception: it runs no strategy and promises no yield. Tokens stay in the contract until you withdraw them.
Lending
Onggi runs its own credit module. Suppliers earn the interest borrowers pay. Borrowers take USDC against what the account already holds, without selling it. Rates move with demand and available liquidity.
Collateral weights
Not every asset counts in full. The weight is the share of its value that can back a loan.
Health
Health is weighted collateral divided by debt. Above 1.50 is comfortable. At 1.10 the position can be liquidated.
To raise health, repay USDC or add collateral. The position agent can prepare a repayment when health drops below a level you set.
Position agent
You write a scenario before the market moves: what to watch, when it counts as triggered, and the largest action allowed. The agent watches health, ranges, liquidity and rates, and prepares that action when the scenario is confirmed.
- One signal per episode. A trigger fires once and waits until the condition recovers.
- Cooldown. A repeating rule runs again only after its cooldown and a confirmed result.
- Partial actions are labelled. If your limits allow only part of the target, you see that before signing.
- Imported rules start paused. Scenarios loaded from JSON do nothing until you review and enable them.
Rewards and Season 0
Rewards are paid from ONGGI creator fees, so the budget comes from fees the token actually earned rather than new emissions.
Signing and checks
Onggi never holds a key. Anything that changes the chain ends in your wallet. The signing page simulates every step again, explains it in plain words and refuses to continue if a step would fail or grants an unlimited approval. The transaction travels in the link fragment, so it never reaches a server.
The full list of checks is on What gets checked.
Risks
MCP gateway
Onggi is also a remote MCP server. An AI client connects to one endpoint and gets tools to read the chain, check transactions before they are signed and prepare transactions for your wallet.
| Endpoint | https://mcp.onggi.xyz/giwa |
| Network now | GIWA Sepolia (chain 91342). On the day GIWA mainnet opens, the same endpoint switches network. |
| Transport | MCP over streamable HTTP, JSON responses |
Connect a client
Then check it with claude mcp list.
Customize, then Connectors, Add custom connector. Name it Onggi and paste the endpoint.
Add this to ~/.cursor/mcp.json.
Run MCP: Add Server, choose HTTP and paste the endpoint.
Settings, Apps, Advanced settings, turn on Developer mode, then Create app and paste the endpoint.
First requests to try
- “Give me a portfolio report for 0x…, including WETH and its allowance for this spender.”
- “Simulate these three transactions and stop if any would revert.”
- “Prepare a transfer of 0.001 WETH to 0x… for my signature.”
More in the prompt library.
Keys and limits
Make keys on the keys page by signing a message, and send one as Authorization: Bearer nacre_…. Revoked keys stop working at once.
Agent guardrails
An access key can carry a transaction policy. Every prepare tool checks it again before returning a signing link.
| Field | Effect |
|---|---|
transactions_enabled | False turns preparation off for this key. |
max_value_wei | Largest native value a prepared transaction may send. |
allowed_contracts | Only these contracts. An empty list allows any contract. |
allow_deploy | Whether prepare_deploy may be used. |
Set it with set_agent_policy, read it with get_agent_policy, remove it with delete_agent_policy. get_agent_usage returns call counts by tool. Anyone holding the same key can change the policy, so your wallet stays the final check.
Tool reference
Every tool with its inputs. Open one to see the details, or download the whole list.
Loading tools…
Errors
Tool errors come back as a normal result with isError: true and a message the AI can pass on, such as “Rate limit reached” or “The simulation reverted, so nothing was prepared”.
| Code | Meaning |
|---|---|
-32601 | Unknown method |
-32602 | Unknown tool or invalid arguments |
-32700 | The request could not be read |
Run your own
The gateway is a Cloudflare Worker in gateway/. Install and start it there, then point a client at http://localhost:8799/zero.
The network is four settings in wrangler.toml: CHAIN_ID, CHAIN_NAME, RPC_URL and EXPLORER.
FAQ
Is Onggi live?
Not yet. The app is a preview with a demo account and sample prices. Contracts are tested and not deployed. The MCP gateway is live on Sepolia.
Does Onggi ever hold my keys?
No. Every transaction is signed in your own wallet, and the position agent only prepares actions.
Can I always leave a vault?
Yes. Deposits can be capped, withdrawals are never paused. Your share is limited only by what the strategy holds at that moment.
Why can't I deposit into an onchain vault?
Deposits open only after the chain, the vault, its token and the deployed bytecode are verified in the registry.
What happens at health 1.10?
The loan can be liquidated: part of the collateral is sold to repay debt. Repay or add collateral before that, or let the agent prepare a repayment at a level you choose.
Which network does Onggi use?
GIWA. Until GIWA mainnet opens, the gateway runs on GIWA Sepolia so every tool can be tried with test ETH.
Onggi
Open app