ChainGPT MCP
The ChainGPT MCP server integrates ChainGPT's crypto-aware AI capabilities into AI agents for crypto-related tasks. With this server, you can:
Interact with ChainGPT AI: Chat with ChainGPT for blockchain-related queries, trading assistance, and analytics
Access Crypto News: Get the latest AI-generated news from trusted sources like CoinDesk, CoinTelegraph, and Twitter, with filtering options by category, token, or search query
Track Crypto Market: Retrieve real-time information on 5,000+ cryptocurrencies
Analyze Blockchain Data: Aggregate web3 market statistics and interact with blockchains
Retrieve Chat History: Access previous interactions with the AI
Supports configuration on macOS systems, allowing for integration with the Claude Desktop application through specific file paths and system settings.
Requires Node.js environment (v18 or higher) for running the ChainGPT MCP server.
Facilitates installation and execution of the ChainGPT MCP server using npm/npx commands.
Enables installation of the ChainGPT MCP server using the pnpm package manager.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ChainGPT MCP what's the latest crypto news about Bitcoin?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ChainGPT MCP
A Model Context Protocol (MCP) server that allows you to bring ChainGPT capabilities into your AI Agent.
Features
Get the latest crypto news
Get the latest crypto prices
Get the latest crypto market trends
Get the latest crypto market news
Related MCP server: agentpulse-mcp
Setup
Get your ChainGPT Secret Key
You need to have a Nodejs environment(v18 or higher) to run this server
A Compatible MCP Client. I recommend Claude Desktop
Installation
via Smithery
To install ChainGPT MCP Server for any MCP client automatically via Smithery:
npx -y @smithery/cli install @kohasummon/chaingpt-mcp --client claudeThis adds the server to claude desktop config. Replace claude with the name of the client you are using. See the list of clients here.
Manual Installation
pnpm install -g @kohasummon/chaingpt-mcpConfigure Claude Desktop to recognize the ChainGPT MCP server
You can find claude_desktop_config.json inside the settings of Claude Desktop app:
Open the Claude Desktop app and enable Developer Mode from the top-left menu bar.
Once enabled, open Settings (also from the top-left menu bar) and navigate to the Developer Option, where you'll find the Edit Config button. Clicking it will open the claude_desktop_config.json file, allowing you to make the necessary edits.
OR (if you want to open claude_desktop_config.json from terminal)
For macOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonFor Windows:
code %APPDATA%\Claude\claude_desktop_config.json2. Add the ChainGPT MCP server configuration:
{
"mcpServers": {
"chaingpt": {
"command": "npx",
"args": ["/path/to/chaingpt-mcp/build/index.js"],
"env": {
"CHAINGPT_SECRET_KEY": "your-secret-key-here"
},
"toolCallTimeoutMillis": 120000
}
}
}Replace your-secret-key-here with your actual ChainGPT secret key from app.chaingpt.org/apidashboard.
3. Restart Claude Desktop
For the changes to take effect:
Completely quit Claude Desktop (not just close the window)
Start Claude Desktop again
Look for the 🔌 icon to verify the ChainGPT MCP server is connected
Troubleshooting
Common Issues
Server Not Found
Verify the npm link is correctly set up
Check Claude Desktop configuration syntax
Ensure Node.js is properly installed
API Key Issues
Confirm your CHAINGPT_SECRET_KEY is valid
Check the CHAINGPT_SECRET_KEY is correctly set in the Claude Desktop config
Verify no spaces or quotes around the API key
Connection Issues
Restart Claude Desktop completely
Check Claude Desktop logs:
Node.js should be minimum v18 (or higher)
# macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type "%APPDATA%\Claude\logs\mcp*.log"Tool Call Timeout
Set the tool call timeout to 120 seconds or higher
This can be changed in the claude_desktop_config.json file
Tools
Tool Name | Description | Prompt |
chaingpt_invoke_chat | Invoke a chat with ChainGPT AI and get a response based on the provided question. | Yesterday, I bought 0.001 ETH. How much is it worth now? |
chaingpt_get_news | Get the latest crypto news | What's the latest news in the crypto world? |
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
License
Built with ❤️ by Joshua Omobola
Available Tools
3 toolschaingpt_get_ai_crypto_newsA
Get the latest AI-related crypto and web3 articles.
Web3-native AI assistant built specifically for the crypto world.
it source, filter, deduplicate, and summarize up-to-date crypto news from many outlets in real time
it continuously scans trusted crypto news sites (e.g. CoinDesk, CoinTelegraph, Decrypt) and even social platforms like Twitter for breaking updates.
You can call this tool without any parameters to get the latest news. It returns 10 news articles by default.
Capabilities:
- Source, filter, deduplicate, and summarize up-to-date crypto news from many outlets in real time
- Continuously scans trusted crypto news sites (e.g. CoinDesk, CoinTelegraph, Decrypt) and even social platforms like Twitter for breaking updates.
- Summarize news in a concise manner, providing the most important details and context.
- Provides a link to the original article for more detailed information.
⚠️ COST WARNING: This tool makes an API call to ChainGPT which may incur costs. The key is charged 1 credit per 10 records returned
This tool allows you to interact with ChainGPT's AI News Generator.
Args:
categoryId(number[], optional): The category ID of the news to fetch. Blockchain Gaming = [2], DAO = [3], DApps = [4], DeFi = [5], Lending = [6], Metaverse = [7], NFT = [8], Stablecoins = [9], Cryptocurrency = [64], Decentralized = [65], Smart Contracts = [66], Distributed Ledger = [67], Cryptography = [68], Digital Assets = [69], Tokenization = [70], Consensus Mechanisms = [71], ICO (Initial Coin Offering) = [72], Crypto Wallets = [73], Web3.0 = [74], Interoperability = [75], Mining = [76], Cross-Chain Transactions = [77], Exchange = [78].
subCategoryId(number[], optional): The sub-category ID of the news to fetch. Bitcoin = [11], BNB Chain = [12], Celo = [13], Cosmos = [14], Ethereum = [15], Filecoin = [16], Flow = [17], Harmony = [41], Polygon = [20], XRP Ledger = [21], Solana = [22], TRON = [23], Cardano = [34], Monero = [19], Cronos = [36], Ontology = [44], WAX = [26], Optimism = [45], Other (Miscellaneous) = [46], PlatON = [47], Steem = [56], Rangers = [49], SX Network = [57], Ronin = [50], Telos = [58], Shiden = [51], Telos EVM = [59], SKALE = [52], Theta = [61], Stacks = [54], ThunderCore = [62], Stargaze = [55].
tokenId(number[], optional): The token ID of the news to fetch. BTC = [79], MATIC = [91], ETH = [80], DOT = [92], USDT = [81], LTC = [93], BNB = [82], WBTC = [94], XRP = [83], BCH = [95], USDC = [84], LINK = [96], SOL = [85], SHIB = [97], ADA = [86], LEO = [98], DOGE = [87], TUSD = [99], TRX = [88], AVAX = [100], TON = [89], XLM = [101], DAI = [90], XMR = [102], UNI = [105], OKB = [103], ETC = [106], ATOM = [104], BUSD = [107], HBAR = [108].
searchQuery(string, optional): The search query to fetch the news.
limit(number, optional): The number of news to fetch. Default is 10. You can increase this to retrieve more articles in one call (e.g. limit: 20 for 20 articles). Note that higher limits will consume additional credits (see Rate Limits & Credits). If you only want a small number of the latest articles, you can set a smaller limit as well.
offset(number, optional): The offset of the news to fetch. Default is 0. This is used for pagination. For example, to get the second page of results when using a limit of 10, you would set offset: 10 (skip the first 10 articles, return the next set). Similarly, offset: 20 would fetch the third page (items 21–30), and so on.
fetchAfter(Datetime, optional): The date after which to fetch the news. Provide a JavaScript Date object or a date string (which will be interpreted in UTC by the API). For example, fetchAfter: new Date('2024-01-01') will fetch news items published from January 1, 2024 onward. This is useful for getting news within a certain time range (e.g., only recent news).
sortBy(string, optional): The field by which to sort the news. Currently, the only supported sort key is 'createdAt', which corresponds to the article's publication time. By default, results are sorted by newest (most recent) first. If not provided, the SDK will sort by createdAt descending. (At this time, no other sort fields are supported.)
Returns:
The response from ChainGPT AI to the provided question or message.
Inputs: categoryId, subCategoryId, tokenId, searchQuery, +4 more.
chaingpt_get_chat_historyB
Get the chat history for a given chat blob id until the limit is reached retrieve saved chat history. By default, this will retrieve history entries associated with your API key. If you provide a specific sdkUniqueId, it will retrieve history entries associated with that chat blob id.
Args:
sdkUniqueId (str): The unique identifier for the chat.
limit (int, optional): The maximum number of chat history items to return. Default is 10.
offset (int, optional): The offset to start the chat history from. Default is 0.
sortBy (str, optional): The field to sort the chat history by. Default is 'createdAt'.
sortOrder (str, optional): The order to sort the chat history by. Default is 'ASC'.
Returns:
The chat history for the given chat blob id until the limit is reached.
Inputs: sdkUniqueId (required), limit (required), offset (required), sortBy (required), +1 more.
chaingpt_invoke_chatB
Invoke a chat with ChainGPT AI and get a response based on the provided question.
Web3-native AI assistant built specifically for the crypto world.
It has deep blockchain expertise, enabling seamless integration of crypto-aware AI into your applications.
The model is trained on blockchain data (smart contracts, DeFi protocols, NFTs, DAOs) and real-time market information,
making it ideal for use cases like customer support, on-chain analytics, trading assistance, and community engagement
Capabilities:
- Aggregate any amount of web3 market statistics
- Interact with Blockchains
- Live information tracking of 5,000+ cryptos.
- AI Generated News
⚠️ COST WARNING: This tool makes an API call to ChainGPT which may incur costs.
This tool allows you to interact with ChainGPT's conversational AI capabilities.
Args:
question (str): The question or message to send to ChainGPT.
chatHistory (str, optional): Whether to include chat history in the request.
Defaults to "off" if not provided. Can be set to "on" to maintain conversation context.
sdkUniqueId (str, optional): The unique identifier for the chat.
Defaults to a random UUID if not provided
Returns:
The response from ChainGPT AI to the provided question or message.
Inputs: question (required), chatHistory (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool serves a distinct purpose: news retrieval, chat history, and chat invocation. There is no overlap or ambiguity in their functionality.
All tools follow a consistent 'chaingpt_verb_noun' pattern (e.g., chaingpt_get_ai_crypto_news, chaingpt_invoke_chat), making it easy to predict tool names.
With 3 tools, the set is minimal but covers the core features of the server (news, chat, chat history). While more tools could be added, the count is reasonable for the focused scope.
The tool surface includes the primary operations: reading news, sending chat messages, and retrieving history. Minor gaps exist (e.g., no tool for managing sessions or filtering news by source), but the essentials are covered.
Maintenance
Related MCP Connectors
Real-time curated crypto news for AI agents with sentiment, recaps, and search.
Crypto news, perps, market pulse, price history and token checks for AI agents. USDC per call.
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Web search, point-in-time crypto market data, verified strategy track records and 160+ agent tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI agents to real-time cryptocurrency market data from CoinGecko API, enabling price lookups, coin details, market rankings, search, and trending crypto queries through natural language.25 npmApache 2.0
- AlicenseNot gradedqualityCmaintenanceProvides AI agents with real-time, structured data feeds including news, trends, market sentiment, and crypto prices via MCP tools.MIT

Stelar Signals MCPofficial
AlicenseAqualityCmaintenanceEnables AI agents to access crypto market signals including regime, sentiment, price, risk, and text tools like summarization and fact-checking, backed by a live production-grade classifier.652 npmMIT- AlicenseBqualityDmaintenanceProvides AI agents with research tools for AI agent ecosystem analysis, DeFi protocol analysis, and general market research.329 npmMIT