Oak Agent Kit

What your agent can do

Docs

A preview of what ships at launch.

A top-down diorama map of a carved oak root hub. Glowing lime root channels cross green moss to a ring of small carved wooden workshops, mills, vaults and bridges.

Conventions

The tool reference publishes with the release. At launch, these rules will hold for every tool.

  • Project tools are named <module>_<verb>: the project, then the action.
  • Amounts are decimal strings in the asset's smallest unit, never floating-point numbers.
  • Every result names the asset address, symbol, chain ID and decimals.
  • Before signing, the add-on will simulate (test-run) the transaction sequence (eth_simulateV1), reuse a matching same-block preview within 12 seconds, and build exact approvals only.
  • Errors come back as plain sentences that say what to fix.
  • A set of basic tools covers the common jobs across every project: look up a verified asset by name, symbol or address, read all balances in one call, get a quote across KyberSwap, Velora and Pons launch curves (using verified symbols or addresses), preview, swap, read the wallet's history, and list its open positions across every module in one call.

25 project modules

Each group below lists what the agent will be able to do at launch, with a prompt you could try. USDG (US dollar stablecoin) appears in several of them.

Swap and Trade

8 projects

KyberSwap, Velora, Pons, pools.trade, Clanker, Hookr, TickerSpring, Uniswap liquidity

Example prompt

Swap 50 dollars of ETH to USDG with the best route, and show me the preview before anything is signed.

  • Compare routes from KyberSwap and Velora by net output, and refuse any swap that would pay out less than the quoted minimum.
  • Launch a coin on a Pons bonding curve (a formula that sets the cost as people buy and sell), buy and sell it, and graduate it to a liquidity pool.
  • Launch and trade coins through pools.trade and Clanker.
  • Create, cancel and claim limit orders through Hookr and TickerSpring.
  • Add, collect and remove liquidity positions with Uniswap liquidity.

Vaults and Rewards

7 projects

Steakhouse, Spark, NetNet, Longbow, Grove, Beefy, Merkl

Example prompt

List the vaults I can deposit into and tell me what I hold in each.

  • Deposit into and withdraw from Steakhouse, Spark, NetNet, Longbow, Grove and Beefy, including USDG and ETH vaults.
  • See what the wallet holds in each vault.
  • Find reward campaigns and claim what the wallet has earned through Merkl.

Borrow and Lend

2 projects

Morpho Blue, Priors

Example prompt

Show my lending position: what I have supplied and what I have borrowed.

  • Supply and withdraw collateral, borrow, repay, and check the position on Morpho Blue.
  • Lend into and withdraw from Priors credit pools, and borrow and repay on funded credit lines for agents that have an on-chain identity.

Move Money

2 projects

Relay, Orbio

Example prompt

Bring 0.05 ETH over from another chain and tell me when it arrives.

  • Bridge into and out of Robinhood Chain with Relay, with live status tracking.
  • Buy AI credits and check the balance with Orbio.

Markets and Data

3 projects

Meridian, Lighter, HeyResearch

Example prompt

Browse open prediction markets and show me the perpetual funding rates.

  • Browse Meridian prediction markets, check positions, buy and sell, then settle and redeem.
  • Read perpetual funding rates (regular payments between traders betting up or down) from Lighter. This module is read-only.
  • Read project research and chain activity from HeyResearch. This module is read-only.

Identity and Tools

3 projects

ERC-8004, hood.ag, HoodLock

Example prompt

Register a .hood name for my agent and set it as the name shown for its address.

  • Register an on-chain identity for the agent with ERC-8004 and update its details.
  • Register a .hood name with hood.ag, set it as the name shown for the address, and look names up.
  • Lock coins and liquidity positions, create airdrops and claim them with HoodLock.

Command line

The main commands, all run on your computer:

CommandWhat it does
oak initCreates the wallet. Run it in your own terminal only.
oak setupSets up the agent's ERC-8004 identity: oak setup link <agentId> links an existing ID with an owner signature (no ETH needed), or oak setup register mints a new ID on-chain.
oak identity unlinkRemoves a linked identity without gas (or --owner <linkId> with the owner's signature). Reads stay open; actions pause.
oak addressShows the agent's wallet address.
oak exportExports the private key. Run it in your own terminal only.
oak mcpStarts the MCP (AI tool connector) server that your agent connects to.
oak call <tool> <json>Calls one tool directly from the command line.
oak registerRegisters or updates the agent's on-chain identity.
oak recipes add <package-or-path>Imports a project recipe. Also: remove and list.
oak config set <key> <value>Sets the network (mainnet 4663 by default, or testnet 46630 opt-in), an endpoint or an address.

Project recipes

A project team can publish an opt-in recipe that adds its own read and action definitions. A recipe is data only, so no third-party code runs. Each is limited to 64 KiB per file, 4 MiB per archive and 100 entries, and labelled as-is, not reviewed by Oak. You import one yourself with oak recipes add.

For AI agents

Works with: Claude Code Codex Gemini Cursor Grok and any other MCP client that can run a tool server on your computer.

An operating guide for agents, AGENTS.md, and a plain-text summary, llms.txt, ship with the kit. Their custody rules are short:

  • Never run oak init or oak export inside an agent tool call. The human owner runs both in their own terminal.
  • Never ask the user for a private key, seed phrase or passphrase. Oak will reject any tool argument that contains one.
  • All signing happens locally in the add-on.
  • Always read the preview before signing.