chaingpt-official-claude-skill

name	chaingpt-official-claude-skill
description	**The only Claude Code skill that turns your AI assistant into a Web3 engineering co-pilot.**

chaingpt-official-claude-skill

Source: github.com/ChainGPT-org/chaingpt-claude-skill. The body below is the upstream README.md captured at the time of registration.

---

ChainGPT Developer Kit for Claude Code

The only Claude Code skill that turns your AI assistant into a Web3 engineering co-pilot.

Full API reference. 12 MCP tools. 45+ Solidity patterns. 10 project templates. Zero context-switching.

Get Started · Features · MCP Server · Templates · Docs

---

The Problem

Building with Web3 AI APIs means constantly switching between docs, SDKs, and Stack Overflow. You paste an endpoint, get the params wrong, burn credits debugging, and repeat.

This skill fixes that. Install it once and Claude already knows every ChainGPT endpoint, parameter, credit cost, and best practice — so you just describe what you want built.

Demo

You:  "Generate an NFT of a cyberpunk samurai and mint it on Polygon"

Claude: I'll use the ChainGPT NFT Generator to create your image and mint it on-chain.

       1. Generating image with VisionaryForge model... ✓
       2. Queuing for on-chain minting on Polygon (chainId: 137)... ✓
       3. Polling for completion... ✓

       ✅ NFT minted successfully!
       Collection ID: cgpt-a8f3...
       Token URI: ipfs://QmX7k...
       View on PolygonScan →

       Cost: 2 credits ($0.02)

No docs. No boilerplate. Just results.

⚡ Quickstart

One command. That's it.

Claude Code (plugin install):

/plugin install ChainGPT-org/chaingpt-claude-skill

Manual install (git clone):

git clone https://github.com/ChainGPT-org/chaingpt-claude-skill .claude/skills/chaingpt

[!TIP] For user-level install (all projects): clone to ~/.claude/skills/chaingpt instead.

Now open Claude Code and ask it anything about ChainGPT — it just works.

🧰 What You Get

📖 Complete API Reference Every endpoint, parameter, and response format for all 7 products — with real API response examples, credit costs, and SDK snippets in JS + Python. 🤖 12 MCP Tools Claude doesn't just write code — it calls the APIs directly. Generate images, mint NFTs, audit contracts, fetch news — all from the chat. 📋 10 Project Templates Production-ready scaffolds for Next.js, React Native, Express, Nuxt, and more. Multi-product compositions included.

🔐 45+ Solidity Patterns Audited, battle-tested smart contract patterns Claude composes from — ERC-20 variants, NFTs, DeFi, governance, security. 🧪 79 Passing Tests 53 MCP server unit tests + 26 mock server endpoint tests. CI-ready out of the box. 🛠️ Developer Tools Interactive playground, debug assistant, hackathon scaffolder, cost estimator, and migration guides from OpenAI/Alchemy.

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        Claude Code                              │
│                                                                 │
│  ┌──────────────┐  ┌──────────────┐  ┌────────────────────┐    │
│  │   SKILL.md   │  │  Reference   │  │    Templates &     │    │
│  │  Entry Point  │  │  16 docs     │  │    Patterns (56)   │    │
│  └──────┬───────┘  └──────┬───────┘  └────────┬───────────┘    │
│         │                 │                    │                │
│         └────────┬────────┴────────────────────┘                │
│                  ▼                                              │
│         ┌────────────────┐         ┌──────────────────┐        │
│         │   MCP Server   │────────▶│  ChainGPT APIs   │        │
│         │   12 tools     │         │  api.chaingpt.org │        │
│         └────────────────┘         └──────────────────┘        │
│                  │                                              │
│                  ▼                                              │
│         ┌────────────────┐                                     │
│         │  Mock Server   │  ← Zero-credit local testing        │
│         │  localhost:3001│                                      │
│         └────────────────┘                                     │
└─────────────────────────────────────────────────────────────────┘

📦 Products Covered

Product	What It Does	Cost
Web3 AI Chatbot & LLM	Crypto-native LLM with live on-chain data, Nansen Smart Money, 33+ chains	0.5 credits
AI NFT Generator	Text-to-image + on-chain minting across 22+ chains, 4 AI models	1–14.25 credits
Smart Contract Generator	Natural language → production Solidity contracts	1 credit
Smart Contract Auditor	AI vulnerability detection with scored audit reports	1 credit
AI Crypto News	Real-time AI-curated news, 24 categories, RSS feeds	0.1 credits
AgenticOS	Open-source autonomous X/Twitter AI agents	1 credit/tweet
Solidity LLM	Open-source 2B-param model for Solidity code generation	Free

Plus SaaS & Whitelabel references — Launchpad, Staking, Vesting, Telegram bots.

1 credit = $0.01 USD · 15% bonus when paying with $CGPT

🔌 MCP Server — 12 Tools

The MCP server gives Claude direct API access — not just code generation:

Tool	What It Does
chaingpt_chat_ask	Ask the Web3 AI chatbot anything
chaingpt_chat_history	Retrieve past conversations
chaingpt_nft_generate_image	Generate AI art from text prompts
chaingpt_nft_enhance_prompt	AI-improve prompts for better results
chaingpt_nft_generate_and_mint	Full pipeline: generate → queue → poll → mint
chaingpt_nft_get_chains	List supported blockchains for minting
chaingpt_audit_contract	Run an AI security audit on Solidity code
chaingpt_generate_contract	Generate smart contracts from descriptions
chaingpt_news_fetch	Fetch crypto news with category filtering
chaingpt_news_categories	List available news categories
chaingpt_get_credit_balance	Check remaining API credits
chaingpt_estimate_cost	Estimate costs before execution

Setup MCP Server (optional)

If installed via /plugin install, the MCP server is configured automatically via .mcp.json. Just set your API key:

export CHAINGPT_API_KEY="your-key-here"

For manual installs, build and configure:

cd .claude/skills/chaingpt/mcp-server
npm install && npm run build

Add to .claude/settings.json:

{
  "mcpServers": {
    "chaingpt": {
      "command": "node",
      "args": [".claude/skills/chaingpt/mcp-server/dist/index.js"],
      "env": { "CHAINGPT_API_KEY": "your-key-here" }
    }
  }
}

📋 10 Project Templates

Template	Stack	Products
Web3 AI Chatbot	Express + TypeScript	LLM
NFT Minting Service	Node.js	NFT Generator
Contract Audit CI/CD	GitHub Actions	Auditor
Crypto News Dashboard	Vanilla JS	News API
AI Twitter Agent	Node.js	AgenticOS
NFT Marketplace	Next.js + wagmi	NFT + LLM + Auditor + News
DeFi Dashboard	React + Recharts	LLM + News + Auditor
Next.js Chatbot	Next.js 14 App Router	LLM
React Native Wallet	Expo + React Native	LLM + NFT
Nuxt News App	Nuxt 3 SSR	News API

🔐 45+ Smart Contract Patterns

Audited, production-ready Solidity patterns Claude composes from instead of generating from scratch:

Category	Count	Examples
ERC-20 Tokens	10	Basic, burnable, taxable, reflection, governance, multi-chain
NFTs	10	ERC-721, 721A, lazy mint, soulbound, dynamic, ERC-1155, revenue-sharing
DeFi	10	Staking, vesting, bonding curve, AMM, flash loans, ERC-4626 vault
Governance	5	Governor, multi-sig, DAO treasury, delegation
Security	10	Access control, upgradeable (UUPS), timelock, escrow, EIP-712

💬 Usage Examples

Just talk to Claude naturally:

"Build me a Web3 AI chatbot with streaming responses"

"Generate and mint an NFT on BSC using ChainGPT"

"Set up smart contract auditing in my CI/CD pipeline"

"Scaffold an NFT marketplace that uses 4 ChainGPT products"

"What's the credit cost for generating 100 NFTs with NebulaForge XL?"

"Write a staking contract"  →  uses patterns library, not from scratch

"I'm migrating from OpenAI — help me switch to ChainGPT"

"I'm at a hackathon — scaffold me a DeFi project fast"

🧪 Testing

Use the mock server to develop and test without spending a single credit.

The mock server is a full drop-in replacement for the ChainGPT API — realistic responses, simulated latency, credit tracking — so you can build, iterate, and run CI/CD pipelines without touching your API quota.

Start the mock server

cd .claude/skills/chaingpt/mock-server
npm install && npm run dev
# → http://localhost:3001

Point your CHAINGPT_BASE_URL at http://localhost:3001 and everything works exactly as it would in production. No API key required.

Run the full test suite

79 tests passing across two suites:

# MCP Server tests (53 tests)
cd mcp-server && npm install && npm test

# Mock Server tests (26 tests)
cd mock-server && npm install && npm test

# Skill validation (118 structural checks)
bash scripts/validate.sh

The CI workflow (.github/workflows/ci.yml) runs all three automatically on every push and pull request.

🗂️ Project Structure

Click to expand (76 files)

chaingpt-claude-skill/
├── .claude-plugin/
│   └── plugin.json                   # Plugin manifest (name, version, author)
├── .mcp.json                         # MCP server configuration
├── VERSION                           # Semantic version
├── README.md
├── CONTRIBUTING.md
├── CHANGELOG.md
├── LICENSE
│
├── skills/                           # All skills (auto-discovered)
│   ├── chaingpt/SKILL.md             #   Main skill — API reference (341 lines)
│   ├── playground/SKILL.md           #   Interactive API testing
│   ├── debug/SKILL.md                #   Troubleshoot API errors
│   ├── hackathon/SKILL.md            #   60-second project scaffolder
│   └── update/SKILL.md               #   Check for skill updates
│
├── reference/                        # API & SDK documentation (16 files)
│   ├── llm-chatbot.md                #   Web3 AI Chatbot & LLM
│   ├── nft-generator.md              #   AI NFT Generator
│   ├── smart-contract-generator.md   #   Smart Contract Generator
│   ├── smart-contract-auditor.md     #   Smart Contract Auditor
│   ├── crypto-news.md                #   AI Crypto News
│   ├── agenticos.md                  #   AgenticOS (Twitter AI)
│   ├── solidity-llm.md               #   Solidity LLM (HuggingFace)
│   ├── saas-whitelabel.md            #   Whitelabel SaaS products
│   ├── pricing.md                    #   Credit costs & billing
│   ├── error-codes.md                #   Error handling reference
│   ├── product-selection.md          #   Decision matrix
│   ├── wallet-integration.md         #   MetaMask, WalletConnect
│   ├── advanced-patterns.md          #   Streaming, caching, circuit breaker
│   ├── deployment.md                 #   Vercel, Railway, Docker, Lambda
│   ├── cost-optimization.md          #   Save ~84% on credits
│   └── typescript-types.md           #   Complete TS interfaces
│
├── templates/                        # Project scaffolding (11 files)
├── patterns/                         # Solidity patterns (5 files, 45+ patterns)
├── migration/                        # Platform migration guides (3 files)
├── mcp-server/                       # MCP server — 12 tools, 53 tests
├── mock-server/                      # Testing mock server — 26 tests
├── scripts/                          # Validation tooling
└── examples/                         # Working code — JS + Python (8 files)

🗺️ Roadmap

• Complete API reference for all 7 products
• MCP server with 12 direct-access tools
• 10 project templates including multi-product compositions
• 45+ audited Solidity patterns
• Mock server for zero-credit testing
• 79 passing tests (MCP + mock server)
• Migration guides (OpenAI, Alchemy, custom)
• Cost optimization & wallet integration docs
• Claude Code plugin marketplace listing
• Video tutorials & walkthroughs
• SSE streaming demo server
• Community template submissions
• Multi-language SDK examples (Go, Rust)

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

# Validate your changes before submitting
bash scripts/validate.sh

📄 Prerequisites

Requirement	Link
ChainGPT API Key	app.chaingpt.org — connect a wallet to sign up
API Credits	Buy credits — 1,000 credits = $10
Claude Code	code.claude.com

🔗 Links

Developer Docs · API Dashboard · Pricing · Web3 AI Grant ($1M) · Pad Innovation Grant ($25K)

Solidity LLM on HuggingFace · AgenticOS on GitHub · Book a SaaS Demo

📜 License

MIT — see LICENSE for details.

---

Built by ChainGPT — AI Infrastructure for Web3

If this skill saved you time, consider giving it a ⭐