How to add Web3 Research MCP to Claude Desktop

Deep research for crypto tokens — free and fully local, across CoinGecko, DeFiLlama, and more. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 159★ · stdio · no auth

Claude Desktop 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 Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Web3 Research MCP config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Web3 Research MCP's tools appear under the 🔌 tools menu.

Before you start

Node.js (v16 or higher)

What Web3 Research MCP can do in Claude Desktop

create-research-plan

Creates a structured research plan for a token. Parameters: tokenName (full name of the token), tokenTicker (ticker symbol).

search

Performs a web search and returns the results. Parameters: query (search query), searchType (web, news, images, videos).

research-with-keywords

Searches for a token with specific keywords and saves the results. Parameters: tokenName, tokenTicker, keywords (array of keywords to search for).

update-status

Updates the status of a research section. Parameters: section (e.g. 'projectInfo', 'technicalFundamentals'), status (planned, in_progress, completed).

fetch-content

Fetches content from a URL and saves it as a resource. Parameters: url (URL to fetch), 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, tokenTicker, source (e.g. 'CoinGecko', 'DeFiLlama', 'News').

coingecko-data

Fetches 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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Web3 Research MCP config there under the "mcpServers" key and restart the client.

Is Web3 Research MCP safe to use with Claude Desktop?

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.

View repo Full Web3 Research MCP page