MCP Tools Reference

MCP Tools Reference

The ChainGPT Claude Code plugin includes an MCP (Model Context Protocol) server that gives Claude direct API access to ChainGPT services. This is not code generation -- Claude actually calls the APIs in real time, returning live results within your conversation.

Available Tools

The MCP server exposes 12 tools across 5 product categories:

AI Chatbot

Tool	Description
chaingpt_chat_ask	Ask the Web3 AI chatbot anything -- blockchain concepts, token analysis, protocol mechanics, market data
chaingpt_chat_history	Retrieve past conversations for context continuity

NFT Generator

Tool	Description
chaingpt_nft_generate_image	Generate AI art from text prompts
chaingpt_nft_enhance_prompt	AI-improve your prompts for higher quality results
chaingpt_nft_generate_and_mint	Full pipeline: generate image, queue transaction, poll status, mint on-chain
chaingpt_nft_get_chains	List supported blockchains for NFT minting

Smart Contract Tools

Tool	Description
chaingpt_audit_contract	Run an AI security audit on Solidity code -- detects vulnerabilities, gas issues, and best-practice violations
chaingpt_generate_contract	Generate smart contracts from natural language descriptions

Crypto News

Tool	Description
chaingpt_news_fetch	Fetch the latest crypto news with optional category filtering
chaingpt_news_categories	List all available news categories for filtering

Account Management

Tool	Description
chaingpt_get_credit_balance	Check your remaining API credits
chaingpt_estimate_cost	Estimate the credit cost of an operation before executing it

Setup

Plugin Install (Automatic)

If you installed the ChainGPT plugin through Claude Code's plugin system, the MCP server is configured automatically. No additional setup is needed -- the .mcp.json file at the plugin root handles everything.

The .mcp.json file uses the ${CLAUDE_PLUGIN_ROOT} variable to resolve paths portably, so the configuration works regardless of where the plugin is installed on disk.

Manual Install

If you need to set up the MCP server manually:

cd mcp-server
npm install
npm run build

Then add the server configuration to your .claude/settings.json:

{
  "mcpServers": {
    "chaingpt": {
      "command": "node",
      "args": ["<path-to-plugin>/mcp-server/dist/index.js"],
      "env": {
        "CHAINGPT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage Examples

Once the MCP server is running, you interact with ChainGPT services by simply asking Claude in natural language. Claude selects the appropriate tool automatically.

AI Chatbot

"Ask ChainGPT what the top DeFi protocols by TVL are right now."

"What does ChainGPT know about the latest Ethereum upgrade?"

NFT Generation

"Generate an NFT image of a cyberpunk samurai in a neon city."

"Enhance my prompt 'cool dragon' and then generate the image."

"Mint an NFT of a galaxy whale on Polygon."

Smart Contracts

"Audit this Solidity contract for vulnerabilities." (paste your code)

"Generate an ERC-20 token contract with a 2% burn tax and 100M supply."

Crypto News

"Fetch the latest DeFi news."

"What news categories are available? Then get me the top Bitcoin stories."

Account Management

"How many credits do I have left?"

"How much would it cost to generate and mint an NFT?"

How It Works

When you make a request, Claude:

1. Identifies the relevant MCP tool based on your intent

2. Calls the ChainGPT API directly through the MCP server

3. Processes the response and presents the results in your conversation

4. Can chain multiple tools together for complex workflows (e.g., estimate cost, check balance, then execute)

All API calls consume credits from your ChainGPT account. Use chaingpt_estimate_cost to check pricing before expensive operations, and chaingpt_get_credit_balance to monitor your remaining balance.