Tools

Grouped by what you would do with them. Each tool returns JSON. A failure comes back as an error object with a code, so an agent can react to it instead of guessing. Tools marked write only exist in a session where a key is set, and even then they dry-run until you confirm.

Parameter tables, worked examples with real chain values, and the full error list are in docs/TOOLS.md in the repo.

Check a token

pons_get_token: Everything about one launched token: the factory record, ERC-20 metadata, curve reserves, graduation progress, snipe tax, fees, balances. Returns NOT_A_LAUNCH if the factory has never heard of it.
pons_snipe_tax: The decaying launch-window tax as it applies to one address right now, whether that address is exempt, and how long the window has left.
pons_token_supply: Total supply and how much has been burned. Defaults to the PONS token.
pons_pending_fee_change: Whether the owner has queued a change to a token's creator fee recipient, and when it becomes executable and expires. Creator self-service transfers never show up here because they are immediate.

Quote

pons_quote_buy: What a given amount of ETH buys on a curve, with the curve fee, creator tax, snipe tax, price impact and clamping worked out. Computed locally, then re-run on chain to confirm.
pons_quote_sell: What selling a given amount of tokens returns after fees. Same local-then-on-chain cross-check as the buy quote.

Watch the field

pons_recent_launches: TokenLaunched events, newest first. Filter by deployer or pair token.
pons_scan_interesting: Scores recent launches by unique buyers, ETH in, and age, so you can tell a launch with real buyers from one wallet buying itself. On-chain data only, no LLM.
pons_propose_clone: Asks an LLM to remix one token's name and metadata, then dry-runs a launch of the result so you can see what it would cost. Never broadcasts.
pons_recent_graduations: PoolGraduated events: which token, the position id, and how much was seeded into the pool.
pons_creator_launches: Every token one creator has launched, and which of them graduated.
pons_curve_trades: Buys and sells on one curve, merged newest first. Buy amounts are shown after refund, and the buy fee includes any snipe tax paid.

Launch

pons_preview_launch: What a launch with a given config and pair token would look like: the config, its economics digest, and the pair token's economics.
pons_can_launch: Whether an address is allowed to launch right now, from the whitelist and the global flag.
pons_launch_costs: Measured gas for each write, with the live gas price applied, so you know what a launch or trade will cost before you dry-run it.
pons_launch_token write: Launch through the factory, or launch and make an opening buy in one transaction through the forwarder. Enforces metadata limits, economics pinning, the opening-buy cap, and the daily launch cap.

Trade the curve

pons_buy write: Buy on a live bonding curve. Only the curve the factory registered for the token is accepted.
pons_sell write: Sell on a live bonding curve. If an ERC-20 approval is needed it is bundled, for the exact amount.

After graduation

pons_quote_swap: A price from the on-chain V4 quoter for a graduated token's pool, hook fee included. Works for native and ERC-20 quoted pools.
pons_graduate write: Graduate a curve that has met its threshold: drain it, then seed the V4 pool. Anyone can call it. It knows which phase it is in and does only the step that is left.
pons_swap write: Swap on the V4 pool through the Universal Router. Buying with ETH is a plain swap; selling any token goes through a Permit2 permit that is signed only at broadcast.

Creator fees

pons_fee_balances: What a token has waiting in the shared fee escrow, in ETH and per token, and how much of its five-year buyback lock has vested.
pons_claim_fees write: Claim what is waiting in the fee escrow, in ETH or any ERC-20, in full or in part.
pons_release_buyback write: Move the vested slice of a launch's buyback lock into the escrow. Only the creator or protocol recipient can call it.
pons_set_creator_fee_recipient write: Hand the creator fee recipient to another address. Takes effect as soon as it is mined, with no timelock. The caller must be the current recipient.
pons_set_buyback write: Turn buyback on or off for a token. Creator or owner only, through the factory.
pons_sweep_curve_fees write: Sweep every accrued curve fee. The argument is the minimum output the buyback must achieve.

Legacy V1

pons_v1_get_token: A token from the older Uniswap V3 generation of the launchpad: its record, graduation status, and metadata.
pons_v1_launches: Launch history from the V1 factory. Accepts absolute block ranges for scanning further back.

Protocol

pons_protocol_overview: Chain id, latest block, launch fee, whether launching is enabled, tax caps, snipe-tax settings, every launch config decoded, governance timelocks, and all contract addresses.
pons_pair_token_economics: Whether a pair token is approved, plus its phantom quote, threshold, and decimals.

Admin

pons_execute_fee_recipient_change write: Execute a fee-recipient change the owner queued, once the 72 hour timelock has passed and the window is open. Anyone can call it.
pons_cancel_fee_recipient_change write: Cancel a queued owner-initiated fee-recipient change. Owner only on chain.
pons_rescue_curve_fees write: Recover fees stuck on a curve. Owner only.
pons_exempt_snipe_tax write: Always returns an error explaining that exemptions cannot be added after launch. Set them in the launch call instead.
pons_admin_call write: The factory owner's surface: fees, launch configs, whitelist, executors, ownership. renounceOwnership needs an explicit acknowledgement and reverts on chain anyway.

When it fails, it says why

INVALID_ADDRESS: Malformed 0x address parameter.
INVALID_PARAMS: Bad input, or a state precondition the contract would revert on.
NOT_A_LAUNCH: Address is not a Pons-launched token or curve.
CAP_EXCEEDED: The opening-buy cap or the daily launch cap would be exceeded.
CHAIN_MISMATCH: The RPC is not serving chainId 4663. Every tool checks this first, so it can appear on any call.
REVERTED: The contract reverted, in simulation or in a mined transaction.
RPC_FAILURE: Transport or node failure after retries, with the node's message preserved.