Mesh Agent

v1.0.0Finance & Fintechstable

🎖️ ⛅️ 🏠 🐍 - Access specialized web3 AI agents for blockchain analysis, smart contract security auditing, token metrics evaluation, and on-chain interactions through the Heurist Mesh network. Provides comprehensive tools for DeFi analysis, NFT valuati

mesh-agent-mcp-servermcpai-integration
Share:
64
Stars
0
Downloads
0
Weekly
0/5

What is Mesh Agent?

Mesh Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 🎖️ ⛅️ 🏠 🐍 - access specialized web3 ai agents for blockchain analysis, smart contract security auditing, token metrics evaluation, and on-chain interactions through the heurist mesh network. provid...

🎖️ ⛅️ 🏠 🐍 - Access specialized web3 AI agents for blockchain analysis, smart contract security auditing, token metrics evaluation, and on-chain interactions through the Heurist Mesh network. Provides comprehensive tools for DeFi analysis, NFT valuati

This server falls under the Finance & Fintech and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 🎖️ ⛅️ 🏠 🐍 - Access specialized web3 AI agents for blockchain

Use Cases

Access web3 AI agents for blockchain analysis.
Audit smart contracts and evaluate tokens.
Analyze DeFi protocols and on-chain interactions.
heurist-network

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedApr 8, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mesh-agent-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Mesh Agent

Heurist Mesh MCP Server connects AI assistants to a network of specialized web3 AI agents, providing on-demand access to blockchain analysis, token intelligence, DeFi metrics, social data, and on-chain wallet information. Built on the Heurist Mesh network, it exposes tools for token search, trending analysis, Twitter/X intelligence, Binance perpetual funding rates, wallet NFT and token holdings, and more — all without requiring the user to integrate individual blockchain APIs. Developers and analysts use it to conduct comprehensive crypto research from a single conversational interface.

Prerequisites

  • Python 3.10 or newer with uv package manager installed, OR Docker
  • A Heurist API key (obtain from https://heurist.ai)
  • Git to clone the repository
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository

Clone the Heurist Mesh MCP server repository to your local machine.

git clone https://github.com/heurist-network/heurist-mesh-mcp-server.git
cd heurist-mesh-mcp-server
2

Install dependencies with uv

Use uv to install the Python package in editable mode. This is the recommended approach for local development.

uv pip install -e .
3

Create your environment file

Create a .env file in the project root and add your Heurist API key. This key authenticates all requests to the Mesh agent network.

echo 'HEURIST_API_KEY=your_heurist_api_key_here' > .env
4

Test the server locally

Run the server in SSE mode to verify it starts and connects to the Heurist network. The default port is 8000.

uv run mesh-tool-server --transport sse --port 8000
5

Configure your MCP client

Add the server to your Claude Desktop configuration file. Use the stdio transport for local use, providing your API key in the env block.

Mesh Agent Examples

Client configuration

Claude Desktop configuration for the Heurist Mesh MCP server using uv and stdio transport.

{
  "mcpServers": {
    "heurist-mesh": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/heurist-mesh-mcp-server", "mesh-tool-server"],
      "env": {
        "HEURIST_API_KEY": "your_heurist_api_key_here",
        "TRANSPORT": "stdio"
      }
    }
  }
}

Prompts to try

Use these prompts to explore blockchain data, token markets, and DeFi analytics through the Mesh agents.

- "What are the trending tokens on-chain right now?"
- "Search for the token profile of HEURIST and show its market summary"
- "What are the current funding rates for BTC and ETH on Binance perpetuals?"
- "Show me the token holdings for wallet 0xabc...123"
- "Find spot-futures arbitrage opportunities in the current market"
- "Search Twitter for the latest sentiment on Solana DeFi projects"

Troubleshooting Mesh Agent

Authentication error: HEURIST_API_KEY not recognized

Ensure the HEURIST_API_KEY is set in your .env file or passed directly in the MCP client env block. You can also pass it as the X-HEURIST-API-KEY header or as an api_key query parameter for HTTP/SSE transport.

Certain agents are not available or returning errors

Edit the DEFAULT_AGENTS list in server.py to include or exclude specific agents from the 30+ available. Not all agents may be enabled by default — check the repository for the full agent list.

Docker container cannot reach the Heurist network

Ensure the HEURIST_API_KEY environment variable is passed to the container with -e HEURIST_API_KEY=your_key. For SSE mode, also set PORT and expose that port with -p 8000:8000.

Frequently Asked Questions about Mesh Agent

What is Mesh Agent?

Mesh Agent is a Model Context Protocol (MCP) server that 🎖️ ⛅️ 🏠 🐍 - access specialized web3 ai agents for blockchain analysis, smart contract security auditing, token metrics evaluation, and on-chain interactions through the heurist mesh network. provides comprehensive tools for defi analysis, nft valuati It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Mesh Agent?

Follow the installation instructions on the Mesh Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Mesh Agent?

Mesh Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Mesh Agent free to use?

Yes, Mesh Agent is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mesh-agent-mcp-server": { "command": "npx", "args": ["-y", "mesh-agent-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Mesh Agent?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides