How to Connect ElizaOS with Heurist Mesh MCP

5 min readMay 7, 2025

Introduction

As a developer creating agents with ElizaOS, you’ve likely faced the headache of integrating external data sources, especially dynamic crypto market data or social media insights. Connecting diverse APIs, handling authentication, data formatting, and availability issues can quickly become complex.

The Heurist Mesh Model Context Protocol (MCP) server integration changes this equation. With MCP, your Eliza agents can seamlessly access a rich agents-as-a-service ecosystem — from token analytics to web search, as simple as a few lines of code. Heurist Mesh MCP dramatically reduces integration overhead, letting your agents tap into powerful capabilities with minimal setup.

In this article, you’ll learn (1) how Heurist Mesh MCP works (2) how to integrate it with Eliza within minutes (3) new possibilities this unlocks for your agents.

What Are MCP & Heurist Mesh?

Model Context Protocol (MCP) is an open protocol that standardizes how AI agents interact with external tools and data sources. Instead of building custom integrations for each external resource, developers can use MCP to connect AI agents to various services through a unified interface, facilitating seamless and scalable interactions.

Heurist MCP is a high-performance implementation of the Model Context Protocol server designed for agent–tool integration. It powers communication between large language model agents (like those built with Eliza) and external services like CoinGecko, Bitquery, Firecrawl, Exa Search, Twitter, Truth Social to standardize how agents exchange data in both web2 and web3 domains.

Heurist Mesh, the agents-as-a-service cloud platform behind Heurist MCP lets you use MCP service easily. No need to wrap APIs or set up a local server manually. We provide fully-managed, on-demand servers for a growing swarm of 25+ specialized agents and 50+ tools are ready to use.

You can read this article if you want to know more about using Heurist Mesh MCP with Google ADK: https://heuristai.medium.com/how-to-connect-google-adk-to-heurist-mcp-in-minutes-32d2ea39abaf

Why It’s Better Than Going API‑by‑API

Because Heurist Mesh proxies to dozens of external SaaS/APIs, you effectively bundle multiple subscriptions into one pay‑as‑you‑go stream.

For instance:

X (Twitter) API Basic ~$600 / quarter (developer.twitter.com)
CoinGecko Analyst API ~$400 / quarter(coingecko.com)
Exa Web Search Starter ~$150 / quarter (exa.ai)
Cookie.fun API ~ $1200 / quarter
Bitquery: minimum $300 / quarter (https://bitquery.io/)

Even with just X and basic crypto market data, you’re already nearing ~$1000 a quarter — and that’s before adding specialized tooling like onchain analytics or DEX data feeds that often cost additional hundreds for a basic plan.

With Heurist Mesh, you pay only for the calls you make while unlocking every external service under the same API key. Every Mesh agent call costs a certain amount of credits, so you keep your budget lean and never get locked in monthly or annual subscriptions.

How the Integration Works

On a high level, the integration involves the following steps:

Set up a Heurist Mesh MCP server
Install and configure the ElizaOS MCP plugin
Use MCP tools directly in your Eliza agent code

Quick-Start (10 Minutes)

Prerequisites

You’ll need:

Node.js 23+
Create a Heurist Mesh MCP server endpoint from Heurist MCP Portal
Install mcp-proxy
Get an OpenAI API KEY

Create Eliza Project

First, install the Eliza CLI (Version: 1.0.0-beta.41 used in this demo):

# Install globally, 
npm install -g @elizaos/cli@beta

Then initialize your project:

elizaos create

# Name the project
? What would you like to name your project? › heurist-mcp-heurist# Choose "pglite" for database
? Select your database: › - Use arrow-keys. Return to submit.
❯   pglite

Set up Eliza MCP plugin

npm install @fleek-platform/eliza-plugin-mcp

Create a character.json:

{
  "name": "Eliza-heurist-mcp-agent",
  "plugins": ["@elizaos/plugin-openai","@fleek-platform/eliza-plugin-mcp"],
  "settings": {
    "mcp": {
      "servers": {
        "mcp-proxy-agent-1": {
          "type": "stdio",
          "name": "Eliza-heurist-mcp-agent",
          "command": "mcp-proxy",
          "args": ["<YOUR_HEURIST_MCP_SERVER_URL>"],
          "timeout": 100000
        }
      },
      "maxRetries": 3
    }
  },
  "providers": {
    "openai": {
      "apiKey": "${OPENAI_API_KEY}",
      "model": "gpt-4.1-mini",
      "temperature": 0.3
    }
  },
  "system": "You are a helpful assistant that uses MCP to use external services. When using MCP, the serverName must be mcp-proxy-agent-1",
  "bio": [
    "Provides clear and concise responses",
    "Always use mcp-proxy-agent-1 as the serverName for MCP"
  ],
  "messageExamples": [
    [
      {
        "name": "User",
        "content": {
          "text": "Can you help me analyze this repository?"
        }
      },
      {
        "name": "Eliza-heurist-mcp-agent",
        "content": {
          "text": "I'll use mcp-proxy-agent-1 MCP server to access external services."
        }
      }
    ]
  ],
  "style": {
    "all": [
      "Keep responses clear and technical. Format responses in plain text, no markdown like #, *, etc.",
      "Use MCP tools effectively",
      "Always use mcp-proxy-agent-1 as the serverName for MCP"
    ]
  }
}

create .env file

OPENAI_API_KEY=<YOUR_OPEN_API_KEY> 
CHARACTER_CONFIG_PATH=./character.json
PGLITE_DATA_DIR=./my-data

Then run your agent:

elizaos start --character ./character.json

Now your Eliza agent can effortlessly access external tools powered by Heurist MCP Sever. It’s the time to open your browser to visit http://localhost:3000/ to chat with your agent!

Example 1: Analyze Crypto AI Twitter Engagement

Let’s track @elizaos account twitter engagement. Type this query:

Use cookie.fun data to find the @elizaos smart followers count, engagement & impressions

Example 2: Find Tokens with Most Negative Funding Rates

To find tokens with most negative funding rates, type the query:

Which tokens have the most negative funding rates across exchanges?

Conclusion / Next Steps

The Heurist Mesh MCP and ElizaOS integration simplifies connecting your AI agents to powerful external data sources. With minimal setup, your Eliza agents can integrate real-time crypto market data and valuable Twitter insights in minutes, significantly enhancing their capabilities.

Ready to get started?

Create a dedicated MCP server at mcp.heurist.ai
Quick-start your Eliza agent project with the guide at docs.eliza.how

Experience how easy it is to build smarter, data-driven Eliza agents with the power of MCP.