skills/get-artist/SKILL.md
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.
npx skillsauth add artblocks/skills get-artistInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
get_artistFinds an artist and returns all their Art Blocks projects with full metadata, floor prices, tags, and direct artblocks.io links. Results are ordered by most recently launched.
Provide at least one — they can be combined:
| Param | Type | Notes |
| -------------- | ------ | -------------------------------------------------------------- |
| artistName | string | Case-insensitive partial match (e.g. "hobbs" finds Tyler Hobbs) |
| artistSlug | string | Exact artist profile slug (e.g. "tyler-hobbs") |
| artistAddress| string | Artist's wallet address (exact match) |
| chainId | number | Optional — filter projects to a specific chain |
| limit | number | Max projects to return (1–100, default 50) |
artistNames — deduplicated list of artist display names matched
artistProfiles — unique artist profile objects: { slug, displayName }
totalProjects — total project count matching the query
projects[] — array of project objects, each containing:
id — full project ID (contract_address-project_index)
name, artistName, description, slug
artBlocksUrl — direct link to project on artblocks.io
chainId, contractAddress, projectIndex
verticalName, verticalDisplay, curationStatus
active, paused, complete, invocations, maxInvocations, remaining
startDatetime, completedAt
aspectRatio, scriptTypeAndVersion, renderComplete
website, license
lowestListing — floor price in ETH (null if no listings)
featuredTokenImageUrl — hero image URL (null if none)
tags[] — tag name strings (e.g. "ab500", "animated")
artistProfiles[] — { slug, displayName }
| Use get_artist when... | Use something else when... |
| ----------------------------------------------------- | ------------------------------------------------- |
| You want all projects by a specific artist | You want to browse projects broadly → discover_projects |
| You know the artist's name, slug, or wallet address | You have a specific project ID → get_project |
| You want to compare an artist's body of work | You need token-level data → get_token_metadata |
artBlocksUrl for each project — use these when presenting projects to usersartistSlug field in results (under artistProfiles) can be used for subsequent lookupsartistNames array will show all matched namesprojectIndex is the project number on the contract (e.g. 78); id is the full project ID (e.g. 0xa7d8...d270-78)tools
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.
tools
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.
tools
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.
tools
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.