| 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.
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
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:
cd mcp-server && npm install && npm test
cd mock-server && npm install && npm test
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
🤝 Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
bash scripts/validate.sh
📄 Prerequisites
🔗 Links
📜 License
MIT — see LICENSE for details.
Built by ChainGPT — AI Infrastructure for Web3
If this skill saved you time, consider giving it a ⭐
