| name | research |
| description | Research any token, wallet, or contract with the ChainGPT Web3 toolkit. Composes live market data (DexScreener), security flags (GoPlus + Honeypot.is), on-chain history (Etherscan v2), portfolio holdings (Moralis), AND ChainGPT-native context (crypto news + AI signals + Solidity LLM audits) into a single workflow. Use when a user asks 'what is this token', 'is this rug', 'is this address safe', 'should I buy X', 'is this wallet a whale', or wants to research anything on-chain. Triggers: token research, rug check, honeypot check, wallet research, whale tracking, address risk, contract verification, ChainGPT intel. |
ChainGPT Research Skill
When a user wants to research a token, wallet, or contract — your job is to orchestrate the right sequence of MCP tools from this plugin into a coherent answer. Do not call the SDKs raw; the MCP tools are pre-tuned for credit efficiency and AI enrichment.
Core principle: one-shot if you can
If the user asks "research X" without further qualifiers, prefer the single AI-enriched call:
chaingpt_intel_token query="X"
It composes market + risk + ChainGPT news + AI signals in one response and costs ~1 ChainGPT credit (the news fetch). This is what 80% of "research this token" prompts should do.
For a wallet:
chaingpt_intel_wallet address="0x…"
Composes portfolio (Moralis) + per-holding risk-rating (GoPlus). Requires MORALIS_API_KEY for the portfolio scan — without it, the tool returns a setup hint pointing to https://moralis.io (free 25k req/month tier). The GoPlus risk-rating layer is always free.
When to fan out to specific tools
Use the granular tools when the user wants depth on one axis the intel call summarized.
| User intent | Tool | Notes |
|---|
| Live price + volume + liquidity | chaingpt_research_token | DexScreener; no key |
| Which pools / pairs exist | chaingpt_research_pairs | sort by liquidity |
| Trending right now | chaingpt_research_trending | boosted tokens on DexScreener |
| Wallet portfolio (multi-chain) | chaingpt_wallet_balances | needs MORALIS_API_KEY for ERC-20 scan |
| Wallet DeFi positions | chaingpt_wallet_positions | Aave / Uniswap / Lido / etc. |
| Wallet realized P&L | chaingpt_wallet_pnl | tax-season report style |
| Token safety flags | chaingpt_risk_token | GoPlus — honeypot/mintable/proxy/tax |
| Buy+sell simulation | chaingpt_risk_honeypot | Honeypot.is — real simulation |
| Is this address a scammer | chaingpt_risk_address | sanctions / phishing / mixer |
| Source code & ABI of a contract | chaingpt_risk_contract_source | Etherscan v2 verified source |
| Decode a specific transaction | chaingpt_onchain_tx | status / gas / method |
| Address recent activity | chaingpt_onchain_address | last 25 txs |
| Current gas prices | chaingpt_onchain_gas | safe / standard / fast |
| ChainGPT-curated news | chaingpt_news_fetch | filter by token/category |
Recommended chains and graceful fallback
The plugin supports 11 chains out of the box: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, blast, linea, scroll, solana.
Some tools degrade gracefully when optional API keys are absent:
- Without
MORALIS_API_KEY: chaingpt_wallet_balances returns native-coin balances only via public RPC; positions and PnL return a setup hint. Recommend the user get a free 25k-req/month key at https://moralis.io.
- Without
ETHERSCAN_API_KEY: on-chain + contract-source tools work but hit a low rate limit. Recommend a free key at https://etherscan.io/myapikey.
- All risk tools work key-free.
The "research → audit" funnel
When the research surfaces a contract that looks interesting or suspicious, the next step is the existing ChainGPT audit tool:
chaingpt_risk_contract_source address="…" chain="…" # get source
chaingpt_audit_contract sourceCode="…" # AI audit
Always recommend this pair when:
- The user is about to interact with an unknown contract.
- GoPlus flagged a risk that needs a human-readable explanation.
- The contract is a proxy and the user needs to know what the implementation does.
What this skill does NOT do
- It does not execute transactions, sign anything, or move funds. All tools are read-only.
- It does not generate strategies or trading signals beyond surfacing ChainGPT's own AI signal output.
- For execution / contract deployment, see the (upcoming)
chaingpt-deploy and chaingpt-trade skills.
Output style
Always lead with the most important fact: "It's a honeypot," "It's verified and looks safe," "Price is $X with $Y liquidity," etc. Then surface the supporting evidence with tool names so the user can dig deeper. End with one concrete recommended next action.
