Launch tokens, NFTs and tokenized funds on Robinhood Chain. Non-custodial — you sign everything.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
One fund: status, raise progress, price per share, fees, assets, template rules, and whether public minting is open.
Fund name, symbol, or address.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http polypad https://polypad.family/api/mcp
One fund: status, raise progress, price per share, fees, assets, template rules, and whether public minting is open.
| Argument | Type | Description |
|---|---|---|
| fund* | string | Fund name, symbol, or address. |
{
"type": "object",
"required": [
"fund"
],
"properties": {
"fund": {
"type": "string",
"description": "Fund name, symbol, or address."
}
},
"additionalProperties": false
}One token: price reading, bonding-curve progress, creator, fees, and links. Accepts a symbol, name, token address, or launch address.
| Argument | Type | Description |
|---|---|---|
| token* | string | Symbol, name, token address, or launch address. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "Symbol, name, token address, or launch address."
}
},
"additionalProperties": false
}Follow up on a transaction: pending, confirmed, or failed, with a plain result (tokens bought, fund created, and so on) and an explorer link.
| Argument | Type | Description |
|---|---|---|
| hash* | string | Transaction hash (0x, 32 bytes). |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "Transaction hash (0x, 32 bytes)."
}
},
"additionalProperties": false
}Turns a plain-language request ("buy 0.01 ETH of POLYCAT", "launch a fund with POLYDASH") into the right tool call. Runs read-only requests directly. For actions that move funds it needs the wallet address in `from`; if details are missing it returns the questions to ask.
| Argument | Type | Description |
|---|---|---|
| ref | string | Attribution tag for traffic measurement. Default "grok". |
| from | string | The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead. |
| text* | string | What the user said, as written. |
| walletToken | string | A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet. |
{
"type": "object",
"required": [
"text"
],
"properties": {
"ref": {
"type": "string",
"description": "Attribution tag for traffic measurement. Default \"grok\"."
},
"from": {
"type": "string",
"description": "The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead."
},
"text": {
"type": "string",
"description": "What the user said, as written."
},
"walletToken": {
"type": "string",
"description": "A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet."
}
},
"additionalProperties": false
}The published strategy templates a fund can be created from: allowed assets, position and trade caps, performance fee, drawdown brake, and manager lock.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}Polypad Funds with filters: open for minting, status, template, asset held, manager, factory, search, and sort by newest, raise progress, deadline, or shares.
| Argument | Type | Description |
|---|---|---|
| q | string | Search by name, symbol, or address. |
| open | boolean | Only funds currently raising and not sold out. |
| sort | string | newest, raise_progress, deadline, or shares. |
| asset | string | Asset symbol or address the fund may hold, such as POLYDASH. |
| limit | integer | 1 to 50. |
| status | string | raising, raise_closed, investing, or failed. |
| factory | string | phase6, phase3, phase2, or phase1a. |
| manager | string | Manager address. |
| templateId | integer | Template id. |
Active fixed-price NFT listings on the Polypad marketplace, lowest price at the top, optionally for one collection or under a price.
| Argument | Type | Description |
|---|---|---|
| limit | integer | 1 to 50. |
| collection | string | Collection address. |
| maxPriceEth | string | Only listings at or below this many ETH. |
| maxPriceWei | string | Same in wei. |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "1 to 50."
},
"collection": {
"type": "string",
"description": "Collection address."
},
"maxPriceEth": {
"type": "string",
"description": "Only listings at or below this many ETH."
},
"maxPriceWei": {
"type": "string",
"description": "Same in wei."
}
},
"additionalProperties": false
}Polypad NFT collections with status (commitment window, public mint, sold out), price, supply, and royalties.
| Argument | Type | Description |
|---|---|---|
| q | string | Search by name, symbol, or address. |
| sort | string | newest, minted, or price. |
| limit | integer | 1 to 50. |
| status | string | Filter by status. |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"description": "Search by name, symbol, or address."
},
"sort": {
"enum": [
"newest",
"minted",
"price"
],
"type": "string",
"description": "newest, minted, or price."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "1 to 50."
},
"status": {
"enum": [
"commit_window",
"public_mint",
"sold_out"
],
"type": "string",
"description": "Filter by status."
}
},
"additionalProperties": false
}Trending, new, graduating, or high-volume token launches on Polypad, with search. Counts activity from on-chain trades. No price predictions.
| Argument | Type | Description |
|---|---|---|
| q | string | Search by name, symbol, or address. |
| sort | string | trending, new, graduating, volume, or graduated. |
| limit | integer | How many to return, 1 to 50. Default 12. |
| phase | string | Filter by phase. |
| agentLaunched | boolean | Only tokens prepared through the agent API. |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"description": "Search by name, symbol, or address."
},
"sort": {
"enum": [
"trending",
"new",
"graduating",
"volume",
"graduated"
],
"type": "string",
"description": "trending, new, graduating, volume, or graduated."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many to return, 1 to 50. Default 12."
},
"phase": {
"enum": [
"commit_window",
"trading",
"graduated"
],
"type": "string",
"description": "Filter by phase."
},
"agentLaunched": {
"type": "boolean",
"description": "Only tokens prepared through the agent API."
}
},
"additionalProperties": false
}Read-only view of a wallet: ETH, launch tokens with current exit value, fund shares with net value, and NFTs. Results are in ETH units from on-chain data. No USD value, no forecasts.
| Argument | Type | Description |
|---|---|---|
| address* | string | Wallet address (0x...). |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Wallet address (0x...)."
}
},
"additionalProperties": false
}Prepares a buy of a launch token with ETH. Simulates it on-chain before returning. Returns the unsigned transaction (to, data, value, chainId 4663, gas estimate), a plain summary, and a one-tap signing link. Show the summary before the link. Never signs.
| Argument | Type | Description |
|---|---|---|
| ref | string | Attribution tag for traffic measurement. Default "grok". |
| from* | string | The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead. |
| token* | string | Symbol, name, token address, or launch address. |
| amountEth | string | ETH to spend, as a decimal such as 0.01. |
| amountWei | string | ETH to spend in wei. Use instead of amountEth. |
| returnUrl | string | Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored. |
| slippageBps | integer | Slippage limit in basis points. Default 100, maximum 1000. |
Prepares creating a fund from a published template (Phase 6 factory by default). Give templateId, or list the assets wanted and it matches a template, or tells you honestly that none can hold them. Returns the unsigned createFund transaction, what the manager must mint next, and a signing link.
| Argument | Type | Description |
|---|---|---|
| ref | string | Attribution tag for traffic measurement. Default "grok". |
| from* | string | The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead. |
| name* | string | Fund name, up to 64 bytes. |
| assets | array | Asset symbols the fund should hold, used to match a template. |
| symbol* | string | Fund ticker, up to 16 bytes. |
| factory | string | phase6 (default) or phase3. |
| imageUri | string | https:// or ipfs:// image for the fund. |
| returnUrl | string |
Prepares minting shares of an open fund. Checks the raise is open, that public minting is open (the manager has to mint the required shares before anyone else), supply, and balance. Simulates, then returns unsigned transactions, a summary, and a signing link.
| Argument | Type | Description |
|---|---|---|
| ref | string | Attribution tag for traffic measurement. Default "grok". |
| from* | string | The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead. |
| fund* | string | Fund address. |
| quantity | integer | Number of shares. Default 1. |
| returnUrl | string | Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored. |
| walletToken | string | A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet. |
Prepares exiting a fund after its raise closes (pro-rata share of the vault) or a refund if the raise failed. Finds the wallet's shares on-chain, or takes a quantity or specific ids.
| Argument | Type | Description |
|---|---|---|
| ids | array | Specific share ids. |
| ref | string | Attribution tag for traffic measurement. Default "grok". |
| from* | string | The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead. |
| fund* | string | Fund address. |
| quantity | integer | How many shares, starting from the lowest ids. Default all. |
| returnUrl | string | Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored. |
| walletToken | string | A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet. |
Prepares either a marketplace purchase (listingId) or a public mint from a fixed-price collection (collection + quantity). Checks supply, wallet limits, and price, then simulates. Returns unsigned transactions, a summary, and a signing link. Collections still in their commitment window are sent to the collection page instead.
| Argument | Type | Description |
|---|---|---|
| ref | string | Attribution tag for traffic measurement. Default "grok". |
| from* | string | The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead. |
| quantity | integer | How many to mint, 1 to 50. Default 1. |
| listingId | integer | Marketplace listing id. |
| returnUrl | string | Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored. |
| collection | string | Collection address for a public mint. |
| walletToken | string | A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet. |
Prepares a sale of a launch token for ETH, with the exact-amount approval step if needed. Simulates step 1 on-chain. Returns unsigned transactions, a summary, and a signing link. Accepts an amount or a percent of the wallet balance.
| Argument | Type | Description |
|---|---|---|
| ref | string | Attribution tag for traffic measurement. Default "grok". |
| from* | string | The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead. |
| token* | string | Symbol, name, token address, or launch address. |
| amount | string | Token base units (18 decimals) as a decimal string. |
| returnUrl | string | Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored. |
| slippageBps | integer | Slippage limit in basis points. Default 100, maximum 1000. |
| walletToken | string | A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet. |
Prepares launching a new token on the Polypad factory, with the Agent-launched label by default. Validates every field, simulates createLaunch, and returns the unsigned transaction, a summary, and a signing link.
| Argument | Type | Description |
|---|---|---|
| ref | string | Attribution tag for traffic measurement. Default "grok". |
| from* | string | The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead. |
| name* | string | Token name, up to 64 bytes. |
| symbol* | string | Ticker, up to 32 bytes. |
| imageUri | string | https:// or ipfs:// logo. |
| agentMark | boolean | Agent-launched label. Default true. |
| devBuyEth | string | Optional buy at launch, in wei. |
| returnUrl | string | Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored. |
Quote a buy (ETH in) or sell (token amount in) for a launch token, on the bonding curve or in the Uniswap V4 pool after graduation. Returns expected output, minimum after slippage, and fees. A reading, not a promise.
| Argument | Type | Description |
|---|---|---|
| side* | string | buy or sell. |
| token* | string | Symbol, name, token address, or launch address. |
| amount | string | Base units as a decimal string: wei of ETH for a buy, token base units (18 decimals) for a sell. |
| amountEth | string | Buy only: ETH as a decimal such as 0.01. Use instead of amount. |
| slippageBps | integer | Slippage limit in basis points. Default 100, maximum 1000. |
{
"type": "object",
"required": [
"token",
"side"
],
"properties": {
"side": {
"enum": [
"buy",
"sell"
],
"type": "string",
"description": "buy or sell."
},
"token": {
"type": "string",
"description": "Symbol, name, token address, or launch address."
},
"amount": {
"type": "string",
"description": "Base units as a decimal string: wei of ETH for a buy, token base units (18 decimals) for a sell."
},
"amountEth": {
"type": "string",
"description": "Buy only: ETH as a decimal such as 0.01. Use instead of amount."
},
"slippageBps": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "Slippage limit in basis points. Default 100, maximum 1000."
}
},
"additionalProperties": false
}Counts of actions prepared through the agent API by action and ref tag. Per server process; the on-chain attribution suffix is the durable record.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}A plain-language read of a token's on-chain protections: liquidity, fees, creator holdings, staking pool, vesting lock, bond. It says what is met, what is not, and what it cannot tell you. Not a promise about price.
| Argument | Type | Description |
|---|---|---|
| token* | string | Symbol, name, token address, or launch address. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "Symbol, name, token address, or launch address."
}
},
"additionalProperties": false
}Start here. Explains what Polypad on Robinhood Chain can do from chat, example requests, live counts, how signing works, and the guardrails.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"description": "Search by name, symbol, or address."
},
"open": {
"type": "boolean",
"description": "Only funds currently raising and not sold out."
},
"sort": {
"enum": [
"newest",
"raise_progress",
"deadline",
"shares"
],
"type": "string",
"description": "newest, raise_progress, deadline, or shares."
},
"asset": {
"type": "string",
"description": "Asset symbol or address the fund may hold, such as POLYDASH."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "1 to 50."
},
"status": {
"enum": [
"raising",
"raise_closed",
"investing",
"failed"
],
"type": "string",
"description": "raising, raise_closed, investing, or failed."
},
"factory": {
"enum": [
"phase6",
"phase3",
"phase2",
"phase1a"
],
"type": "string",
"description": "phase6, phase3, phase2, or phase1a."
},
"manager": {
"type": "string",
"description": "Manager address."
},
"templateId": {
"type": "integer",
"minimum": 1,
"description": "Template id."
}
},
"additionalProperties": false
}| walletToken | string | A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet. |
| confirmLarge | boolean | Set true only after the user confirmed an amount above 1 ETH. |
{
"type": "object",
"required": [
"token",
"from"
],
"properties": {
"ref": {
"type": "string",
"description": "Attribution tag for traffic measurement. Default \"grok\"."
},
"from": {
"type": "string",
"description": "The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead."
},
"token": {
"type": "string",
"description": "Symbol, name, token address, or launch address."
},
"amountEth": {
"type": "string",
"description": "ETH to spend, as a decimal such as 0.01."
},
"amountWei": {
"type": "string",
"description": "ETH to spend in wei. Use instead of amountEth."
},
"returnUrl": {
"type": "string",
"description": "Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored."
},
"slippageBps": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "Slippage limit in basis points. Default 100, maximum 1000."
},
"walletToken": {
"type": "string",
"description": "A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet."
},
"confirmLarge": {
"type": "boolean",
"description": "Set true only after the user confirmed an amount above 1 ETH."
}
},
"additionalProperties": false
}| Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored. |
| minSkinBps | integer | Manager skin requirement in basis points. 0 means the 5% default. |
| templateId | integer | Template id from polypad_list_fund_templates. |
| entryFeeBps | integer | Manager entry fee in basis points, 0 to 500. Default 0. |
| raiseCapEth | string | Raise cap in ETH. |
| raiseCapWei | string | Same in wei. |
| walletToken | string | A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet. |
| mintPriceEth | string | Price per share in ETH, a decimal such as 0.01. |
| mintPriceWei | string | Same in wei. |
| raiseDurationDays | integer | Raise length in days, 1 to 30. Default 7. |
{
"type": "object",
"required": [
"from",
"name",
"symbol"
],
"properties": {
"ref": {
"type": "string",
"description": "Attribution tag for traffic measurement. Default \"grok\"."
},
"from": {
"type": "string",
"description": "The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead."
},
"name": {
"type": "string",
"description": "Fund name, up to 64 bytes."
},
"assets": {
"type": "array",
"items": {
"type": "string"
},
"description": "Asset symbols the fund should hold, used to match a template."
},
"symbol": {
"type": "string",
"description": "Fund ticker, up to 16 bytes."
},
"factory": {
"enum": [
"phase6",
"phase3"
],
"type": "string",
"description": "phase6 (default) or phase3."
},
"imageUri": {
"type": "string",
"description": "https:// or ipfs:// image for the fund."
},
"returnUrl": {
"type": "string",
"description": "Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored."
},
"minSkinBps": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Manager skin requirement in basis points. 0 means the 5% default."
},
"templateId": {
"type": "integer",
"minimum": 1,
"description": "Template id from polypad_list_fund_templates."
},
"entryFeeBps": {
"type": "integer",
"maximum": 500,
"minimum": 0,
"description": "Manager entry fee in basis points, 0 to 500. Default 0."
},
"raiseCapEth": {
"type": "string",
"description": "Raise cap in ETH."
},
"raiseCapWei": {
"type": "string",
"description": "Same in wei."
},
"walletToken": {
"type": "string",
"description": "A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet."
},
"mintPriceEth": {
"type": "string",
"description": "Price per share in ETH, a decimal such as 0.01."
},
"mintPriceWei": {
"type": "string",
"description": "Same in wei."
},
"raiseDurationDays": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Raise length in days, 1 to 30. Default 7."
}
},
"additionalProperties": false
}| confirmLarge |
| boolean |
| Set true only after the user confirmed an amount above 1 ETH. |
{
"type": "object",
"required": [
"from",
"fund"
],
"properties": {
"ref": {
"type": "string",
"description": "Attribution tag for traffic measurement. Default \"grok\"."
},
"from": {
"type": "string",
"description": "The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead."
},
"fund": {
"type": "string",
"description": "Fund address."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of shares. Default 1."
},
"returnUrl": {
"type": "string",
"description": "Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored."
},
"walletToken": {
"type": "string",
"description": "A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet."
},
"confirmLarge": {
"type": "boolean",
"description": "Set true only after the user confirmed an amount above 1 ETH."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"from",
"fund"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific share ids."
},
"ref": {
"type": "string",
"description": "Attribution tag for traffic measurement. Default \"grok\"."
},
"from": {
"type": "string",
"description": "The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead."
},
"fund": {
"type": "string",
"description": "Fund address."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many shares, starting from the lowest ids. Default all."
},
"returnUrl": {
"type": "string",
"description": "Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored."
},
"walletToken": {
"type": "string",
"description": "A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet."
}
},
"additionalProperties": false
}| confirmLarge | boolean | Set true only after the user confirmed an amount above 1 ETH. |
| collectionName | string | Collection name, if no address is known. |
{
"type": "object",
"required": [
"from"
],
"properties": {
"ref": {
"type": "string",
"description": "Attribution tag for traffic measurement. Default \"grok\"."
},
"from": {
"type": "string",
"description": "The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead."
},
"quantity": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many to mint, 1 to 50. Default 1."
},
"listingId": {
"type": "integer",
"minimum": 1,
"description": "Marketplace listing id."
},
"returnUrl": {
"type": "string",
"description": "Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored."
},
"collection": {
"type": "string",
"description": "Collection address for a public mint."
},
"walletToken": {
"type": "string",
"description": "A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet."
},
"confirmLarge": {
"type": "boolean",
"description": "Set true only after the user confirmed an amount above 1 ETH."
},
"collectionName": {
"type": "string",
"description": "Collection name, if no address is known."
}
},
"additionalProperties": false
}| percentOfBalance | integer | Percent of the wallet balance, 1 to 100. Use instead of amount. |
{
"type": "object",
"required": [
"token",
"from"
],
"properties": {
"ref": {
"type": "string",
"description": "Attribution tag for traffic measurement. Default \"grok\"."
},
"from": {
"type": "string",
"description": "The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead."
},
"token": {
"type": "string",
"description": "Symbol, name, token address, or launch address."
},
"amount": {
"type": "string",
"description": "Token base units (18 decimals) as a decimal string."
},
"returnUrl": {
"type": "string",
"description": "Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored."
},
"slippageBps": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "Slippage limit in basis points. Default 100, maximum 1000."
},
"walletToken": {
"type": "string",
"description": "A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet."
},
"percentOfBalance": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Percent of the wallet balance, 1 to 100. Use instead of amount."
}
},
"additionalProperties": false
}| repository | string | https://github.com/owner/repo, optional. |
| description | string | Up to 2000 characters. |
| launchDelay | string | Seconds before trading opens, 0 to 2592000. |
| socialLinks | array | https:// links, up to 8. |
| walletToken | string | A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet. |
| creatorFeeBps* | integer | Creator fee in basis points, 0 to 500. Required. 0 means 0%. |
{
"type": "object",
"required": [
"from",
"name",
"symbol",
"creatorFeeBps"
],
"properties": {
"ref": {
"type": "string",
"description": "Attribution tag for traffic measurement. Default \"grok\"."
},
"from": {
"type": "string",
"description": "The wallet address that will sign (0x...). Never a private key. Omit it when a walletToken is passed — the wallet is resolved from the token instead."
},
"name": {
"type": "string",
"description": "Token name, up to 64 bytes."
},
"symbol": {
"type": "string",
"description": "Ticker, up to 32 bytes."
},
"imageUri": {
"type": "string",
"description": "https:// or ipfs:// logo."
},
"agentMark": {
"type": "boolean",
"description": "Agent-launched label. Default true."
},
"devBuyEth": {
"type": "string",
"description": "Optional buy at launch, in wei."
},
"returnUrl": {
"type": "string",
"description": "Optional https:// link back to your agent flow. The signing page shows it as a button after the transaction confirms, with ?tx=<hash>&status=confirmed added. Anything that is not an https:// URL is ignored."
},
"repository": {
"type": "string",
"description": "https://github.com/owner/repo, optional."
},
"description": {
"type": "string",
"description": "Up to 2000 characters."
},
"launchDelay": {
"type": "string",
"description": "Seconds before trading opens, 0 to 2592000."
},
"socialLinks": {
"type": "array",
"items": {
"type": "string"
},
"description": "https:// links, up to 8."
},
"walletToken": {
"type": "string",
"description": "A wallet token from /sign?connect=1: connect once, store the token, and pass it instead of from on every prepare call. The wallet is resolved from the token (signature-checked, 90-day expiry). When both are passed they must name the same wallet."
},
"creatorFeeBps": {
"type": "integer",
"maximum": 500,
"minimum": 0,
"description": "Creator fee in basis points, 0 to 500. Required. 0 means 0%."
}
},
"additionalProperties": false
}