
How to add Web3 Research MCP to Cursor
Deep research for crypto tokens — free and fully local, across CoinGecko, DeFiLlama, and more. Paste the config into ~/.cursor/mcp.json and restart Cursor.
Last updated June 14, 2026 · 159★ · stdio · no auth
Cursor config for Web3 Research MCP
npx -y @smithery/cli install web3-research-mcp --client claude{
"mcpServers": {
"web3-research-mcp": {
"command": "npx",
"args": [
"-y",
"web3-research-mcp@latest"
]
}
}
}Setup steps
- 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
- 2Paste the Web3 Research MCP config below into the "mcpServers" object.
- 3Fill in placeholder secrets, then save.
- 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
- 5Ask Cursor to use one of Web3 Research MCP's tools to confirm it's connected.
Before you start
- Node.js (v16 or higher)
What Web3 Research MCP can do in Cursor
create-research-planCreates a structured research plan for a token. Parameters: tokenName (full name of the token), tokenTicker (ticker symbol).
searchPerforms a web search and returns the results. Parameters: query (search query), searchType (web, news, images, videos).
research-with-keywordsSearches for a token with specific keywords and saves the results. Parameters: tokenName, tokenTicker, keywords (array of keywords to search for).
update-statusUpdates the status of a research section. Parameters: section (e.g. 'projectInfo', 'technicalFundamentals'), status (planned, in_progress, completed).
fetch-contentFetches content from a URL and saves it as a resource. Parameters: url (URL to fetch), format (text, html, markdown, json).
list-resourcesLists all available resources that have been saved.
search-sourceSearches for information about a token from a specific source. Parameters: tokenName, tokenTicker, source (e.g. 'CoinGecko', 'DeFiLlama', 'News').
coingecko-dataFetches live market data directly from the CoinGecko public API — price, market cap, 24h/7d/30d changes, ATH/ATL, circulating supply, contract addresses across chains, and social/dev links. No API key required (free public tier, ~30 req/min); optionally set COINGECKO_API_KEY for the Pro API. Parameters: tokenName, tokenTicker.
Security
No API key required; runs fully local. An optional COINGECKO_API_KEY environment variable can be set to use a CoinGecko Pro API key, in which case requests are sent to the CoinGecko Pro API with the x-cg-pro-api-key header. Some websites block scraping, so direct content fetching may fail with 403 errors, and rate limits may apply to search operations.
Web3 Research MCP + Cursor FAQ
Where is the Cursor config file?
Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Web3 Research MCP config there under the "mcpServers" key and restart the client.
Is Web3 Research MCP safe to use with Cursor?
No API key required; runs fully local. An optional COINGECKO_API_KEY environment variable can be set to use a CoinGecko Pro API key, in which case requests are sent to the CoinGecko Pro API with the x-cg-pro-api-key header. Some websites block scraping, so direct content fetching may fail with 403 errors, and rate limits may apply to search operations.
Does it require an API key?
No. It runs fully locally and uses free public API tiers. You can optionally set COINGECKO_API_KEY to use a CoinGecko Pro API key.
How do I install it?
Install automatically via Smithery with 'npx -y @smithery/cli install web3-research-mcp --client claude', or add the mcpServers config block manually to Claude Desktop or Cursor (command 'npx', args ['-y', 'web3-research-mcp@latest']).
What are the limitations?
Some websites block scraping, so direct content fetching may fail with 403 errors; it relies on search results that may not always be comprehensive; and rate limits may apply to search operations.