| name | configure-postparams |
| description | Configure PostParam (Post-Mint Parameter / PMP) values on Art Blocks tokens using artblocks-mcp. Use when a user wants to customize, update, or set on-chain parameters on a minted token, or when working with build_configure_postparams_transaction, discover_postparams, or post-mint configuration. |
Configuring PostParams on Art Blocks Tokens
What Are PostParams?
PostParams (Post-Mint Parameters / PMP) are on-chain configurable parameters embedded in certain Art Blocks art scripts. After minting, authorized wallets can set values that directly affect the token's on-chain visual output — no re-mint required.
Each parameter has an authOption controlling who can configure it:
authOption | Who can configure |
|---|
Artist | Project artist only |
TokenOwner | Current token owner only |
Address | A specific configured contract address only |
ArtistAndTokenOwner | Artist or token owner |
ArtistAndAddress | Artist or specific contract address |
TokenOwnerAndAddress | Token owner or specific contract address |
ArtistAndTokenOwnerAndAddress | Artist, token owner, or specific contract address |
Token ID Format
<contract_address>-<token_number>
Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78000000
Workflow
Step 1 — Discover available params
discover_postparams(tokenId, chainId?)
Returns: param keys, types, value constraints, current values, and authOption for each param. Always show this to the user before asking for values — they need to know what's configurable and within what constraints.
Step 2 — Build the configuration transaction
build_configure_postparams_transaction(tokenId, values, chainId?, signerAddress?)
values is a key-value object — keys must match param keys from discover_postparams- Always pass
signerAddress when known — needed to determine artist status and validate authorization
- One transaction configures all passed params at once
Returns an unsigned transaction object ready to sign and submit.
Value Formats by Type
| Type | Format | Example |
|---|
Bool | "true" or "false" | "true" |
Select | One of the allowed option strings | "red" |
Uint256Range | Non-negative integer string | "42" |
Int256Range | Integer string (can be negative) | "-5" |
DecimalRange | Decimal string | "3.14" |
HexColor | Hex color with # | "#FF0000" |
Timestamp | Unix timestamp in seconds | "1700000000" |
String | Any text string | "hello world" |
Notes
- Always call
discover_postparams first — param keys and types are project-specific and not guessable
String params: the configuringArtistString flag on the built transaction depends on whether signerAddress matches the project artist — always pass signerAddress for String type params- Authorization: if the user's address doesn't match the
authOption for a param, the transaction will revert on-chain. Check authOption against the user's role before proceeding
- One transaction per call, but you can configure multiple params in a single call by passing multiple keys in
values
