ClawHub

Get Token Metadata

v1.0.0

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...

⭐ 0· 143·1 current·1 all-time
by@ryley-o

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for ryley-o/get-token-metadata.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Get Token Metadata" (ryley-o/get-token-metadata) from ClawHub.
Skill page: https://clawhub.ai/ryley-o/get-token-metadata
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install get-token-metadata

ClawHub CLI

Package manager switcher

npx clawhub@latest install get-token-metadata
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name/description match the SKILL.md: the skill documents a single-purpose helper (get_token_metadata) for Art Blocks tokens and does not request unrelated binaries, env vars, or config paths.
✓
Instruction Scope
SKILL.md contains only usage documentation and the expected response shape for a single-token metadata call; it does not instruct reading files, exporting credentials, or contacting unexpected endpoints beyond linking to artblocks.io for display.
✓
Install Mechanism
No install spec and no code files — lowest-risk instruction-only artifact. Nothing is downloaded or written to disk.
✓
Credentials
No environment variables, secrets, or external credentials required or declared; this is proportional for a read-only metadata lookup helper.
✓
Persistence & Privilege
always is false and the skill is user-invocable; it does not request persistent presence or modify other skills/configuration.
Assessment
This skill is a documentation-only helper describing an internal get_token_metadata tool and appears low-risk: it needs no credentials or installs. Before enabling, confirm that your agent runtime actually provides the referenced get_token_metadata capability (the SKILL.md assumes that tool exists) and that any network calls it makes follow your environment's privacy and rate-limit policies. If future versions add install steps or environment variables, re-evaluate for scope creep or unnecessary credential requests.

Like a lobster shell, security has layers — review code before you run it.

latestvk9784k6ay63p2ynd3fbta9xq05836ya3
143downloads
0stars
1versions
Updated 1mo ago
v1.0.0
MIT-0
@ryley-o
latest
Download

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

ParamRequiredNotes
tokenIdyesFull 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 itYou 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 callYou'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 user
  • features is the on-chain traits object — same data shown on Art Blocks website
  • featuresStatus 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 artwork
  • listing is null when the token has no active secondary-market listing; when present it contains price, currency, platform, and url
  • Both token.artBlocksUrl and project.artBlocksUrl link to artblocks.io — use these when presenting tokens to users

Comments

Loading comments...