Get Token Metadata
by @ryley-o
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, medi...
clawhub install get-token-metadataπ About This Skill
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.
Getting Art Blocks Token Metadata
Tool: get_token_metadata
Retrieves 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.
Token ID Format
Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78000000
Parameters
| Param | Required | Notes |
|-----------|----------|--------------------------------------------|
| tokenId | yes | Full token ID chainId | β | Default 1 (Ethereum). 1, 42161 (Arbitrum), 8453 (Base) |
Response Shape
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.iomedia:
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
When to Use vs GraphQL
| 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 |
Notes
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π Tips & Best Practices
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