# Art Blocks MCP Server

The Art Blocks MCP Server supercharges your AI agents to become instant power users in the Art Blocks ecosystem — discovering projects, exploring portfolios, checking mint eligibility, building trans…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add artblocks/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list artblocks/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get artblocks/mcp-server graphql_query

# Call a tool
npx -y @smithery/cli@latest tool call artblocks/mcp-server graphql_query '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--artblocks.run.tools`

## Tools (21)

- `graphql_query` — Execute a raw GraphQL query against the Art Blocks Hasura endpoint. This is an advanced escape hatch for custom queries…
- `graphql_introspection` — Get the GraphQL schema introspection for the Art Blocks Hasura endpoint. Advanced tool — most queries can be answered w…
- `query_optimizer` — Analyze and optimize a GraphQL query to use preferred Art Blocks tables (e.g., projects_metadata instead of projects, t…
- `validate_fields` — Validate if specific fields exist on a table before querying. Helps prevent field validation errors.
- `explore_table` — Get detailed information about a specific table. For well-known tables (projects_metadata, tokens_metadata) returns a c…
- `build_query` — Build a valid GraphQL query with field validation, WHERE filters, and suggestions. Advanced tool — most queries can be …
- `build_purchase_transaction` — Build an unsigned Ethereum transaction to purchase (mint) a token from an Art Blocks set-price configured project. Retu…
- `get_token_metadata` — Retrieve rich metadata for a specific Art Blocks token (minted piece). Returns token details (hash, features/traits, in…
- `scaffold_artblocks_project` — Generate a complete Art Blocks project scaffold ready for local development. Returns an index.html (matching the Art Bl…
- `get_project` — Look up a single Art Blocks project by its ID or slug. At least one of projectId or slug is required. Returns the full …
- `discover_projects` — Browse and search Art Blocks projects (collections). Filter by text search (name/artist), chain, vertical, floor price …
- `get_wallet_summary` — Get a high-level summary of an Art Blocks collector portfolio. Accepts a wallet address, ENS name, or Art Blocks userna…
- `get_wallet_tokens` — Retrieve Art Blocks tokens owned by a collector. Accepts a wallet address, ENS name, or Art Blocks username (at least o…
- `get_project_minter_config` — Get the minter configuration for an Art Blocks project — everything an agent needs to decide whether and how to mint. R…
- `check_allowlist_eligibility` — Check whether a wallet address, ENS name, or Art Blocks username is eligible to mint from a gated Art Blocks project. W…
- `discover_postparams` — Get available PostParam (Post-Mint Parameter) configurations for an Art Blocks token. Returns param keys, types, constr…
- `build_configure_postparams_transaction` — Build an unsigned transaction to configure PostParam values on an Art Blocks token. PostParams (Post-Mint Parameters) a…
- `discover_upcoming_releases` — Find Art Blocks projects scheduled to launch in the future (not yet mintable). Returns projects whose release date (sta…
- `discover_live_mints` — Find Art Blocks projects that are currently open for minting RIGHT NOW. Only returns projects that are active, unpaused…
- `get_artist` — Look up an Art Blocks artist and their projects. Search by artist name (partial match), artist profile slug (exact), or…
- `list_tags` — List available project tags in the Art Blocks ecosystem. Returns all distinct tag names that can be used with the disco…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get artblocks/mcp-server <tool-name>
```

## Resources

- `artblocks://about` — Platform overview, key concepts, vocabulary, verticals, chains, and tags. Read this first if you are new to Art Blocks.
- `artblocks://generator-spec` — Complete reference for building Art Blocks generative art projects. Covers tokenData injection, hash-based randomness, …