Web3 Research MCP

Deep research for crypto tokens — free and fully local, across CoinGecko, DeFiLlama, and more.

Unverified

stdio (local)

No auth

TypeScript

View repo 159 npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

npx -y @smithery/cli install web3-research-mcp --client claude

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "web3-research-mcp@latest"
      ]
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Node.js (v16 or higher)

About Web3 Research MCP

An MCP server that performs deep, multi-source research on cryptocurrency tokens. It creates a structured research plan, searches across CoinGecko, CoinMarketCap, DeFiLlama and the web, stores search results and fetched content as resources, tracks research status by section, and generates a comprehensive report. Live market data is fetched directly from public APIs to avoid HTML-scraping 403 errors. Free, fully local, and requires no API key.

Tools & capabilities (12)

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.

coingecko-search

Searches CoinGecko's coin index and returns candidate matches with their CoinGecko IDs. Useful when the ticker is ambiguous. Parameters: query (name, ticker, or contract address).

coingecko-tickers

Fetches active exchange listings for a token from CoinGecko — which CEXs/DEXs trade the pair, per-venue 24h USD volume, last price, bid-ask spread, trust score, and trade URL. Sorted by 24h USD volume desc. Parameters: tokenName, tokenTicker, limit (default 15, max 50).

defillama-data

Fetches protocol data directly from the DeFiLlama public API — total TVL, ATH TVL with date, 30/90/365-day TVL change, market cap (when available), per-chain TVL breakdown, fees, token addresses, fundraising rounds, and links. No API key required. Parameters: tokenName, tokenTicker.

defillama-search

Searches DeFiLlama's protocol index and returns candidate matches with their slugs, TVL, and category. Useful when the ticker is ambiguous. Parameters: query (protocol name, ticker, or slug).

When to use it

Run comprehensive due-diligence research on a cryptocurrency token across multiple sources
Pull live market data (price, market cap, ATH/ATL, supply, contract addresses) directly from CoinGecko
Look up where a token actually trades, with per-venue 24h volume and trust scores
Fetch DeFi protocol TVL, fees, per-chain breakdown, and fundraising data from DeFiLlama
Generate a structured report covering technical fundamentals, market data, and social sentiment

Security notes

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 FAQ

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.

#web3 #crypto #cryptocurrency #research #coingecko #defillama #market-data #defi

Alternatives to Web3 Research MCP

Compare all alternatives →

Stripe MCP Server (Agent Toolkit)

Finance & Payments

1.9k

Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language.

Featured

Verified

stdio (local)

API key

TypeScript

12 tools

Updated 1 month agoRepo

Coinbase AgentKit MCP Extension

Finance & Payments

900

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls.

Verified

stdio (local)

API key

TypeScript

9 tools

Updated 1 month agoRepo

Alpaca MCP Server

Finance & Payments

820

Alpaca's official trading server for stocks, ETFs, options, and crypto in plain English.

Verified

stdio (local)

API key

Python

12 tools

Updated 1 month agoRepo

Compare Web3 Research MCP with:

vs Stripe MCP Server (Agent Toolkit)vs Coinbase AgentKit MCP Extension vs Alpaca MCP Server vs MetaTrader MCP Server