Deploy a new DAO
dexe_dao_createDeploys a new DeXe DAO in one call from a token symbol and supply or a full params struct, returning a config preview and governance safety checks before any BNB is spent.
Instructions
Broadcasts when a signer is configured. Deploys a new DeXe DAO in ONE call. SIMPLE mode (recommended): pass symbol + totalSupply and the tool synthesizes a coherent, frontend-equivalent config (LINEAR power, treasury as an implicit remainder, a quorum that passes on realistic turnout). ADVANCED mode: pass a full params struct. Returns a preview of the resolved config + a safety proof and broadcasts only with confirm: true. Runs the frontend's governance coherence guards over ALL FIVE settings slots (default / internal / validators / distribution / tokenSale) — one un-passable slot bricks that whole proposal class forever — plus a calldata round-trip self-check and a pre-sign eth_call: a provable revert is refused with a classified cause + fix BEFORE any gas is spent, while an RPC outage only downgrades to a warning. Mainnet (56) always needs confirm: true (real BNB); validate on testnet (97) first. deployer defaults to the signer. Unsure of the journey or params? Call dexe_guide (flow:'create_dao').
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": {
"daoName": "<daoName>"
},
"name": "dexe_dao_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dryRun | No | Preview: no broadcast, no IPFS pin, no Pinata key needed. CIDs are right but unpinned — do NOT broadcast this calldata. | |
| params | No | ADVANCED mode: the full deployGovPool params struct. Prefer SIMPLE mode. Field-by-field schema: dexe_dao_build_deploy (needs DEXE_TOOLSETS=core,dev). | |
| symbol | No | SIMPLE mode: gov token symbol (e.g. 'GENA'). Required when `params` is omitted. | |
| chainId | No | Target chain id. Defaults to the MCP's default chain. Use 97 (BSC testnet) to validate; 56 = BSC mainnet (real funds). | |
| confirm | No | True to actually broadcast; without it SIMPLE mode and any mainnet deploy return a review-only preview. Pass it on the FIRST call when the user has already approved the deploy. | |
| daoName | Yes | DAO name (also the deployGovPool pool name) | |
| deployer | No | tx.origin that sends the deploy (needed for address prediction). Defaults to the signer address. | |
| avatarCID | No | IPFS CID of an already-pinned JPEG avatar (dexe_ipfs_upload_avatar) | |
| documents | No | External documents shown on the DAO profile, e.g. [{ name: "Whitepaper", url: "https://..." }] | |
| signerKey | No | Keyring signer: omit = primary key; 'agent<n>' or address = a DEXE_AGENT_PK_* key. | |
| voteModel | No | SIMPLE mode: vote-power model. LINEAR = 1 token = 1 vote (default). POLYNOMIAL = meritocratic curve. | LINEAR |
| avatarPath | No | Local avatar image path (JPEG/PNG/WebP/GIF ≤10 MB) — server validates + pins it. Preferred over avatarCID. | |
| recipients | No | SIMPLE mode: split the votable share across wallets (default: deployer only). Percents are of TOTAL supply and must sum to 100 − treasuryPercent. | |
| websiteUrl | No | DAO website URL shown on its profile. | |
| flowContext | No | Guided-flow position from dexe_guide's step templates. Adds flowProgress + next to the result and persists it. | |
| poolFactory | No | PoolFactory override; defaults to ContractsRegistry lookup | |
| socialLinks | No | [[network, url], ...] | |
| totalSupply | No | SIMPLE mode: total token supply in WHOLE tokens (e.g. '1000000'). Required when `params` is omitted. | |
| confirmRisky | No | Proceed despite a governance-safety refusal. Read the returned `risks` to the user FIRST — such a config cannot be repaired after deploy, because repairing it needs a proposal passed under it. Ignored when DEXE_TREASURY_GUARD=block. | |
| quorumPercent | No | SIMPLE mode: quorum, percent 0-100. Omit and the tool picks (default 51). Must be >=50 and clearable by at most 80% turnout — a quorum equal to the votable share freezes the DAO forever. | |
| avatarFileName | No | File name stored alongside avatarCID. | avatar.jpeg |
| daoDescription | No | DAO description (markdown; uploaded to IPFS as slate) | |
| minVotesTokens | No | SIMPLE mode: min tokens to vote AND create proposals, WHOLE tokens. Default '1'. Must be ≤ the largest holder's allocation. | 1 |
| durationSeconds | No | SIMPLE mode: voting duration. Default 86400 (1 day). | |
| earlyCompletion | No | SIMPLE mode: end voting as soon as the quorum is reached. Default true. | |
| treasuryPercent | No | SIMPLE mode: treasury share, percent 0-100 (implicit remainder; it cannot vote). Omit and the tool picks one that leaves a real voting margin (default 30). | |
| executionDelaySeconds | No | SIMPLE mode: delay before execution. Default 0. |