Art Blocks Skills

Agent skills for the Art Blocks MCP server. Each skill teaches the AI agent domain-specific workflows and best practices for working with Art Blocks on-chain data, minting, and generative art development.

Compatible with Cursor, Claude Code, Codex, and 37+ other agents via the open agent skills ecosystem.

Setup

1. Connect the Art Blocks MCP server

The MCP server is hosted at https://mcp.artblocks.io/mcp and uses OAuth for authentication.

Cursor — add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "artblocks-mcp": {
      "url": "https://mcp.artblocks.io/mcp"
    }
  }
}

Cursor will prompt you to authenticate via OAuth the first time a tool is called.

Claude Code — run once in your terminal:

claude mcp add --transport http artblocks-mcp https://mcp.artblocks.io/mcp

Claude Desktop — open Settings → Connectors, click Add connector, and paste https://mcp.artblocks.io/mcp.

ChatGPT — requires Pro or Plus with Developer Mode. Go to Settings → Advanced → Connectors, create a custom connector with URL https://mcp.artblocks.io/mcp.

Windsurf — open Command Palette → "Windsurf: Configure MCP Servers" and add the same mcp.json config as Cursor above.

Codex — run once in your terminal:

codex mcp add --transport http artblocks-mcp https://mcp.artblocks.io/mcp

For full setup details, troubleshooting, and OAuth reference, see the Art Blocks MCP docs.

2. Install the skills

npx skills add ArtBlocks/skills

Install globally (available across all your projects):

npx skills add ArtBlocks/skills -g

Install to a specific agent only:

npx skills add ArtBlocks/skills -a cursor
npx skills add ArtBlocks/skills -a claude-code

After installing, reload Cursor (Cmd+Shift+P → "Reload Window") for skills to take effect.

3. Start prompting

Skills activate automatically — just ask naturally in chat:

"Find all fully on-chain Art Blocks projects mintable on Base" "Help me convert my p5.js sketch to Art Blocks format" "Build a mint transaction for project 0xa7d8...d270-12 on Arbitrum" "Show me all projects by Tyler Hobbs" "What does snowfro's Art Blocks portfolio look like?"

---

Available Skills

Skill	Use when...
discover-artblocks-projects	Browsing, searching, or filtering Art Blocks projects — what's live, dropping soon, in a wallet, or matching a tag/price range
get-artist	Looking up an artist and exploring their body of work across Art Blocks
query-artblocks-data	Custom GraphQL queries for data not covered by domain-specific tools (sales history, aggregations, complex joins)
get-token-metadata	Looking up a specific token's traits, media URLs, listing info, owner, hash, and project context
mint-artblocks-token	Minting a token — pricing, minter types, allowlists, multi-wallet eligibility, building transactions
scaffold-art-script	Creating or converting a generative art script for Art Blocks
configure-postparams	Setting on-chain PostParam values on a minted token

---

Supported Agents

Skills work with any agent that supports the open agent skills spec. The Art Blocks MCP server can be connected to any agent that supports MCP over HTTP.

Agent	MCP	Skills
Cursor	✅	✅
Claude Code	✅	✅
Claude Desktop	✅	—
ChatGPT	✅	—
Windsurf	✅	✅
Codex	✅	✅

---

Manual Installation

Copy any skill directory into .cursor/skills/ in your project, or ~/.cursor/skills/ for personal use:

cp -r skills/query-artblocks-data /your-project/.cursor/skills/

---

Feedback

Found a bug, missing a tool, or have a suggestion? We'd love to hear from you:

• GitHub Issues — open an issue in this repo
• Discord — reach out in the Art Blocks Discord

License

MIT — see LICENSE