Web3 Research MCP
Deep Research for crypto - free & fully local 🧠
🚀 Preview
🧠 Features
Comprehensive Research : Gather detailed information about any cryptocurrency token
Multi-Source Analysis : Research across multiple sources including CoinGecko, CoinMarketCap, DeFiLlama, and more
Structured Reporting : Generate detailed reports covering technical fundamentals, market data, social sentiment, and more
Resource Management : Automatically stores search results and content for reference
Status Tracking : Track research progress through different stages and sections
📋 Requirements
🔧 Installation & Setup
Installing via Smithery
To install web3-research-mcp for Claude Desktop automatically via Smithery :
npx -y @smithery/cli install web3-research-mcp --client claude
Clone this repository
git clone https://github.com/aaronjmars/web3-research-mcp.git
cd web3-research-mcp
Install dependencies
npm install
Build the project
npm run build
Optional : Run the server (handled by Claude)
npm start
🔌 Using with Claude Desktop
Edit your Claude Desktop config file
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Add this to your Claude Desktop configuration file:
{
"mcpServers" : {
"web3-research-mcp" : {
"command" : "node" ,
"args" : [
"path/to/your/web3-research-mcp/dist/server.js"
]
}
}
}
Make sure to replace the path with the absolute path to your server.js file.
Then restart Claude Desktop
🔌 Using with Cursor
Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server
Paste this into your Cursor ~/.cursor/mcp.json file. See Cursor MCP docs for more info.
{
"mcpServers" : {
"web3-research-mcp" : {
"command" : "node" ,
"args" : [
"path/to/your/web3-research-mcp/dist/server.js"
]
}
}
}
Make sure to replace the path with the absolute path to your server.js file.
Then restart Cursor
create-research-plan
Creates a structured research plan for a token.
Parameters:
tokenName: Full name of the token
tokenTicker: Ticker symbol of the token
search
Performs a web search and returns the results.
Parameters:
query: Search query
searchType: Type of search (web, news, images, videos)
research-with-keywords
Searches for a token with specific keywords and saves the results.
Parameters:
tokenName: Name of the token
tokenTicker: Ticker symbol
keywords: Array of keywords to search for
update-status
Updates the status of a research section.
Parameters:
section: Section name to update (e.g., 'projectInfo', 'technicalFundamentals')
status: New status for the section (planned, in_progress, completed)
fetch-content
Fetches content from a URL and saves it as a resource.
Parameters:
url: URL to fetch content from
format: Output format (text, html, markdown, json)
list-resources
Lists all available resources that have been saved.
search-source
Searches for information about a token from a specific source.
Parameters:
tokenName: Name of the token
tokenTicker: Ticker symbol
source: Source to search (e.g., 'CoinGecko', 'DeFiLlama', 'News')
📝 Prompts
token-research
Initiates comprehensive research on a cryptocurrency token.
Parameters:
tokenName: Full name of the cryptocurrency token
tokenTicker: Ticker symbol of the token (e.g., BTC, ETH)
🧠 How It Works
When research begins, a structured plan is created covering all aspects of the token
The server performs searches across multiple sources for information
Search results are stored as resources that can be referenced
The research progresses through different sections, with status tracking
A comprehensive report is generated covering all aspects of the token
⚠️ Limitations
Some websites block web scraping, so direct content fetching may fail with 403 errors
Relies on search results which may not always be comprehensive
Rate limits may apply to search operations
📄 License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.