ChainFETCH

You can run a ChainFETCH MCP Server to access AI-powered Ethereum blockchain intelligence via a local or remote MCP endpoint. This server connects to ChainFETCH APIs for semantic search, LLM-assisted queries, and multi‑modal data across addresses, transactions, blocks, tokens, and smart contracts, enabling fast exploratory analysis and detailed insights through your MCP client.

How to use

Connect to the MCP server from your client and choose your preferred access mode. Use the HTTP endpoint for a remote, streamable feed or run the server locally as a stdio process and interact via standard input/output.

How to install

Prerequisites: ensure you have Node.js 18.0.0 or higher installed on your system, and obtain a ChainFETCH API token from chainfetch.app.

# Option 1: Install the MCP server globally (recommended)
npm install -g chainfetch-mcp-server

Option 2: Install from source (for development or customization) shows how to clone, install, build, and link the package.

git clone https://github.com/chainfetch/chainfetch-mcp-server.git
cd chainfetch-mcp-server
npm install
npm run build
npm link

Additional configuration and usage notes

Set your ChainFETCH API token in the environment where the MCP server runs. You can export it in your shell before starting the server.

export CHAINFETCH_API_TOKEN="your_api_token_here"

Configured server connections

You can run the server either as a remote HTTP endpoint or as a local stdio process. The following configurations show explicit, usable examples.

{
  "mcpServers": {
    "chainfetch_http": {
      "type": "http",
      "name": "chainfetch_http",
      "url": "https://your-ngrok-url.ngrok.app/streamable-http",
      "args": []
    },
    "chainfetch_stdio": {
      "type": "stdio",
      "name": "chainfetch",
      "command": "npx",
      "args": ["chainfetch-mcp-server"],
      "env": [
        {"name": "CHAINFETCH_API_TOKEN", "value": "CHAINFETCH_API_TOKEN"}
      ]
    }
  }
}

Starting in HTTP mode and using ngrok

Run the MCP server in HTTP mode and expose it via ngrok to enable remote clients like Claude to connect.

MCP_HTTP_MODE=true chainfetch-mcp-server

ngrok http 8000

Usage examples with an MCP client

Semantic search examples and structured queries let you explore addresses, transactions, blocks, tokens, and contracts using AI-powered or JSON-filtered approaches.

Available tools

search_addresses_semantic

AI-powered vector similarity search for addresses based on semantic similarity to a query.

search_addresses_json

JSON parameter-based address search with 150+ filters.

search_addresses_llm

Natural language to smart parameter selection for address queries.

get_address_summary

AI-generated summary for an address.

get_address_info

Detailed address information.

search_transactions_semantic

Semantic search over transactions using AI understanding.

search_transactions_json

JSON parameter-based transaction search with 254+ filters.

search_transactions_llm

LLM-powered transaction queries.

get_transaction_summary

AI-generated summary for a transaction.

get_transaction_info

Detailed transaction data.

search_blocks_semantic

AI-powered search over blocks.

search_blocks_json

JSON parameter-based block search with 120+ filters.

search_blocks_llm

LLM-powered block queries.

get_block_summary

AI-generated block summaries.

get_block_info

Detailed block information.

search_tokens_semantic

Semantic search for tokens.

search_tokens_json

JSON-based token filtering with extensive parameters.

search_tokens_llm

LLM-powered token queries.

get_token_summary

AI-generated token summaries.

get_token_info

Detailed token information.

get_nft_instance_info

NFT instance details.

search_smart_contracts_semantic

AI-driven smart contract search.

search_smart_contracts_json

JSON-based contract search with 50+ parameters.

search_smart_contracts_llm

LLM-powered smart contract queries.

get_smart_contract_summary

AI-generated smart contract summaries.

get_smart_contract_info

Detailed contract information.