Heurist Agent Framework
A flexible multi-interface AI agent framework for building agents with reasoning, tool use, memory, deep research, blockchain interaction, MCP, and agents-as-a-service.
What is Heurist Agent Framework?
Heurist Agent Framework is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to flexible multi-interface ai agent framework for building agents with reasoning, tool use, memory, deep research, blockchain interaction, mcp, and agents-as-a-service.
A flexible multi-interface AI agent framework for building agents with reasoning, tool use, memory, deep research, blockchain interaction, MCP, and agents-as-a-service.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A flexible multi-interface AI agent framework for building a
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx heurist-agent-frameworkConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Heurist Agent Framework
The Heurist Agent Framework is a modular, multi-interface AI agent platform that lets you build and deploy agents capable of reasoning, tool use, image and video generation, voice processing, and deep research workflows. It connects to 30+ specialized Web3 Mesh agents covering blockchain data, DeFi analytics, and social media intelligence, and exposes all of them through MCP so that Claude, ChatGPT, Cursor, and LangChain-based clients can call them directly. Developers use it to compose private MCP servers by mixing and matching only the Heurist Mesh agents they need.
Prerequisites
- Python 3.10 or later with uv package manager installed
- A Heurist API key obtained from https://heurist.ai/dev-access using invite code 'agent'
- An MCP client such as Claude Desktop or Cursor IDE
- Git for cloning the repository
Clone the repository
Download the Heurist Agent Framework source code.
git clone https://github.com/heurist-network/heurist-agent-framework.git
cd heurist-agent-frameworkInstall Python dependencies with uv
Use uv sync to create a virtual environment and install all required packages.
uv sync
source .venv/bin/activate # On Windows: .venv\Scripts\activateSet your Heurist API key
Export your Heurist API key as an environment variable so agents can authenticate with the Mesh network.
export HEURIST_API_KEY=your_api_key_hereLaunch an agent
Run any of the available agent implementations. For MCP use, run the Heurist Mesh MCP server entry point.
uv run python mcp_server.pyConfigure your MCP client
Add the server to Claude Desktop or Cursor by pointing to the Python executable and the mcp_server.py script.
{
"mcpServers": {
"heurist": {
"command": "python",
"args": ["/path/to/heurist-agent-framework/mcp_server.py"],
"env": {
"HEURIST_API_KEY": "your_api_key_here"
}
}
}
}Heurist Agent Framework Examples
Client configuration
Claude Desktop configuration for the Heurist Agent Framework MCP server.
{
"mcpServers": {
"heurist": {
"command": "python",
"args": ["/path/to/heurist-agent-framework/mcp_server.py"],
"env": {
"HEURIST_API_KEY": "your_api_key_here"
}
}
}
}Prompts to try
Example prompts once the Heurist MCP server is connected.
- "Analyze the token metrics for ETH over the last 7 days"
- "Generate an image of a futuristic city using Heurist's image model"
- "Search for the latest DeFi yield opportunities on supported protocols"
- "Run a deep research workflow on recent developments in zero-knowledge proofs"Troubleshooting Heurist Agent Framework
uv sync fails with dependency conflicts
Make sure you are using Python 3.10+ and that uv is up to date (pip install -U uv). Try deleting .venv and re-running uv sync.
API calls return authentication errors
Verify HEURIST_API_KEY is correctly exported in your shell or set in the MCP client env block. The invite code 'agent' is required to register at heurist.ai/dev-access.
Mesh agents are unavailable or timeout
Check network connectivity to the Heurist API endpoint and confirm your API key has active quota at the Heurist developer dashboard.
Frequently Asked Questions about Heurist Agent Framework
What is Heurist Agent Framework?
Heurist Agent Framework is a Model Context Protocol (MCP) server that flexible multi-interface ai agent framework for building agents with reasoning, tool use, memory, deep research, blockchain interaction, mcp, and agents-as-a-service. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Heurist Agent Framework?
Follow the installation instructions on the Heurist Agent Framework GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Heurist Agent Framework?
Heurist Agent Framework works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Heurist Agent Framework free to use?
Yes, Heurist Agent Framework is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Heurist Agent Framework Alternatives — Similar Coding Agents Servers
Looking for alternatives to Heurist Agent Framework? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Heurist Agent Framework in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Heurist Agent Framework?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.