菜单
Retrieve rich metadata for a specific Art Blocks token using artblocks-mcp. Use when a user wants to look up a minted token's details, traits, features, media URLs, owner, listing info, live view, or project context using get_token_metadata.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Design, write, test, deploy, and register custom Art Blocks PostParam hook contracts in Solidity. Use when an artist or developer wants to build a custom IPMPAugmentHook (inject live on-chain data into tokenData) or IPMPConfigureHook (validate/gate collector param changes), or both combined. Covers hook type selection, Solidity templates, lightweight testing in Foundry or Hardhat, deployment to Sepolia and mainnet, and registration via the Creator Dashboard.
Browse, search, and explore Art Blocks projects, collections, and collector portfolios using artblocks-mcp. Use when a user wants to find, filter, browse, or explore Art Blocks projects by name, artist, vertical, chain, tag, floor price, or mintability status, or when asking what is minting now, what is dropping soon, what tokens a wallet holds, or to get a portfolio summary. Uses discover_projects, get_project, discover_live_mints, discover_upcoming_releases, get_wallet_summary, get_wallet_tokens, get_artist, and list_tags.
Look up an Art Blocks artist and their body of work using artblocks-mcp. Use when a user wants to find an artist, see their projects, explore an artist's portfolio, or search by artist name, slug, or wallet address using get_artist.
Mint (purchase) an Art Blocks token using the artblocks-mcp tools. Use when a user wants to mint, purchase, or buy an Art Blocks NFT, or needs to understand minting mechanics, minter types, pricing, allowlists, Dutch auctions, or build_purchase_transaction.
Query Art Blocks on-chain data using the artblocks-mcp GraphQL tools. Use when fetching projects, tokens, artists, sales, traits, or any Art Blocks on-chain data via graphql_query, build_query, explore_table, graphql_introspection, validate_fields, or query_optimizer. These are advanced escape-hatch tools — prefer domain-specific tools (discover_projects, get_project, get_artist, get_wallet_tokens, get_token_metadata) when they cover the use case.
Build or convert Art Blocks generative art scripts using artblocks-mcp. Use when helping a user create, scaffold, port, or convert an art script for Art Blocks, or when working with tokenData, hash-based PRNG, FLEX dependencies, PostParams, window.$features traits, p5.js, Three.js, or the Art Blocks generator format.
| name | get-token-metadata |
| description | Retrieve rich metadata for a specific Art Blocks token using artblocks-mcp. Use when a user wants to look up a minted token's details, traits, features, media URLs, owner, listing info, live view, or project context using get_token_metadata. |
get_token_metadataRetrieves a single token's full metadata in one call — traits, media URLs, owner, hash, listing info, and project context. Prefer this over graphql_query when you need rich token details for a known token ID.
<contract_address>-<token_number>
Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78000000
| Param | Required | Notes |
|---|---|---|
tokenId | yes | Full token ID <contract_address>-<token_number> |
chainId | — | Default 1 (Ethereum). 1, 42161 (Arbitrum), 8453 (Base) |
The response has three top-level keys: token, media, and project.
token:
id, tokenId, chainId, contractAddress, projectId
hash — 32-byte hex, the source of all randomness
invocation — mint number within the project (0-indexed)
features — on-chain traits object
featuresStatus — "not_defined" | "defined_empty" | "defined"
mintedAt, mintTransactionHash
ownerAddress
listing — null if not listed, otherwise:
listing.price — listing price
listing.currency — currency symbol (ETH, WETH, etc.)
listing.platform — marketplace name
listing.url — listing URL
artBlocksUrl — direct link to the token page on artblocks.io
media:
imageUrl — primary rendered image
previewUrl — preview asset URL
liveViewUrl — live interactive generator URL
hasVideo — true if a video render exists
project:
id, name, artistName, slug
artBlocksUrl — direct link to the project page on artblocks.io
description, website, license
scriptTypeAndVersion
maxInvocations, invocations, remaining
active, paused, complete
aspectRatio, curationStatus, verticalName, verticalDisplay
renderComplete
Use get_token_metadata when... | Use graphql_query when... |
|---|---|
| You have a specific token ID and want everything about it | You need to query multiple tokens at once |
You need media URLs (liveViewUrl, imageUrl) | You need fields not in this response |
| You want features + project context in one call | You're building complex filters or aggregations |
liveViewUrl is the canonical way to share or preview a generative token — always include it when presenting a token to a userfeatures is the on-chain traits object — same data shown on Art Blocks websitefeaturesStatus distinguishes between "artist hasn't defined features" (not_defined), "features are defined but empty for this token" (defined_empty), and "features exist" (defined)hash uniquely identifies the token's visual output — same hash always produces the same artworklisting is null when the token has no active secondary-market listing; when present it contains price, currency, platform, and urltoken.artBlocksUrl and project.artBlocksUrl link to artblocks.io — use these when presenting tokens to users