Web3 Research MCP
A local MCP server for token research: CoinGecko price and venues, DeFiLlama TVL and web search, no API key
- 171 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Search queries and data requests go to external services, and `fetch-content` fetches any public address the agent names
- Saved results accumulate on disk, and collected pages may carry unreliable claims
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/web3-research-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Search queries and data requests go to external services, and `fetch-content` fetches any public address the agent names
- Saved results accumulate on disk, and collected pages may carry unreliable claims
This is third-party code. Review the repository files before installing.
What it does
Web3 Research MCP runs locally with `npx -y web3-research-mcp@latest` and gives an agent a toolset for analysing a crypto project. The agent builds a research plan from the token name and ticker, searches the web, collects pages and saves what it finds as resources on your machine. The `update-status` tool tracks each section, such as `projectInfo` or `technicalFundamentals`. Two tools call public APIs directly. `coingecko-data` returns price, market cap, 24-hour, 7-day and 30-day changes, all-time high and low, supply and contract addresses across chains. `coingecko-tickers` lists the venues that trade the pair with 24-hour volume, spread and trust score. `defillama-data` returns a protocol total value locked, its 30, 90 and 365-day changes and other metrics. `coingecko-search` resolves ambiguous tickers. `fetch-content` downloads pages only from public http and https addresses: hosts that resolve to loopback, private or reserved addresses are refused, and the check repeats on each of up to five redirects.
Who it is for. Analysts and investors who study tokens and protocols through Claude Desktop, Claude Code or Cursor and want a summary from open sources.
Good fit when
- Before reviewing a new token the agent builds a research plan and fills in the sections one by one
- You need to know which exchanges list a coin and what its volume and spread are
- A protocol TVL trend over 30, 90 and 365 days is needed to compare it with peers
- A ticker matches several coins and you need the right CoinGecko ID through `coingecko-search`
Not a fit when
- You want trades, orders or wallet control: the server only reads and collects data
- You need high-frequency real-time data: the free CoinGecko tier is limited to about 30 requests a minute
- You want investment advice: conclusions stay with you, the server only gathers sources
Example request
Build a research plan for the Uniswap token, pull CoinGecko and DeFiLlama data and show the venues with the highest daily volumeMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
COINGECKO_API_KEYsecret- Paid CoinGecko Pro key. Without it the server uses the free public API.
Limitations
The free CoinGecko public tier allows about 30 requests a minute, and a request times out after 15 seconds by default. A paid `COINGECKO_API_KEY` switches the server to the Pro API address. You supply the addresses for `fetch-content` yourself. Node.js 18 or newer is required. Saved results and research state stay on your computer. The server does not verify the accuracy of collected pages and figures, so that is up to the user.
How to disable. Remove the `web3-research-mcp` entry from the client config. In Claude Code that is `claude mcp remove web3-research-mcp`. Saved resources live in the server local storage and can be deleted by hand.
FAQ
How do I connect Web3 Research MCP to Claude Code?
Run `claude mcp add web3-research-mcp -- npx -y web3-research-mcp@latest`. For Claude Desktop and Cursor add an `mcpServers` block with the command `npx` and the arguments `-y`, `web3-research-mcp@latest`, then restart the client.
Is an API key required?
No. Public sources work without a key. The optional `COINGECKO_API_KEY` variable switches on the CoinGecko Pro API if you have a paid plan.
Which tools does the server expose?
`create-research-plan`, `search`, `research-with-keywords`, `update-status`, `fetch-content`, `list-resources`, `search-source`, `research-source`, `coingecko-data`, `coingecko-search`, `coingecko-tickers` and `defillama-data`.
Where does the server store what it finds?
Search results, pages and research state are stored locally as resources, and `list-resources` lists them. Only search queries and data requests go to external services.
Can the server buy or sell a token?
No. The tool list has no wallet, exchange account or order operations, the server reads data and collects pages.
Discussion
No questions or reviews yet.
Related
MCP serversA free MCP server with crypto news from hundreds of sources and an article archive that an agent searches with no key
Financial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
CoinPaprika MCP server: prices, tickers, exchanges and OHLCV candles for 12,000+ cryptocurrencies, free tier with no key
Financial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
An MCP server for market data and technical analysis: quotes, indicators, screeners and backtesting for stocks, crypto, forex and futures
The official Pyth Pro MCP server: an agent gets real-time and historical prices for crypto, equities, FX and commodities.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Web3 Research MCP (this card) | no | not required | 171 | |
| Free Crypto News API | yes | not required | 333 | crypto news from hundreds of sources, while this builds a token research plan from CoinGecko and DeFiLlama data |
| Web3 bug bounty hunting skills | no | 185 | smart contract audit skills, while this does market and protocol research without code analysis |
README in short
The README presents the project as deep crypto token research run locally and without keys, lists the features and gives configs for Claude Desktop, Claude Code and Cursor. Building from source and the single optional variable are covered separately. Most of the page is a tool reference with the parameters of each tool.