artblocks/get-token-metadata
skills/get-token-metadata/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add artblocks/skills get-token-metadataInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 5, 2026, 3:09 AM79.6s1 file scanned
SKILL.md
- 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
<contract_address>-<token_number>
Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78000000
Parameters
| Param | Required | Notes |
|-----------|----------|--------------------------------------------|
| tokenId | yes | Full token ID <contract_address>-<token_number> |
| 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.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
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
liveViewUrlis the canonical way to share or preview a generative token — always include it when presenting a token to a userfeaturesis the on-chain traits object — same data shown on Art Blocks websitefeaturesStatusdistinguishes between "artist hasn't defined features" (not_defined), "features are defined but empty for this token" (defined_empty), and "features exist" (defined)hashuniquely identifies the token's visual output — same hash always produces the same artworklistingisnullwhen the token has no active secondary-market listing; when present it containsprice,currency,platform, andurl- Both
token.artBlocksUrlandproject.artBlocksUrllink to artblocks.io — use these when presenting tokens to users
Related Skills
artblocks/scaffold-art-script
tools
VerifiedTrustedCommunity
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.
5SKILL.mdUpdated Jun 5, 2026
artblocks/query-artblocks-data
tools
VerifiedTrustedCommunity
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.
5SKILL.mdUpdated Jun 5, 2026
artblocks/mint-artblocks-token
tools
VerifiedTrustedCommunity
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.
5SKILL.mdUpdated Jun 5, 2026
artblocks/get-artist
tools
VerifiedTrustedCommunity
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.
5SKILL.mdUpdated Jun 5, 2026