Vestige

Vestige MCP provides a TypeScript MCP server that connects to the Vestige API to expose DeFi analytics and data for the Algorand ecosystem. It acts as an intermediary, letting MCP-enabled applications query network stats, protocol analytics, asset data, pool metrics, vault information, balances, and transactions through a consistent interface.

How to use

You run the Vestige MCP server locally and connect an MCP client to it. Once running, you can query network status, protocol analytics, asset data, pool statistics, vault metrics, balances, and transaction monitoring via the MCP client. Use the client to fetch current analytics, monitor activity, and paginate through results such as assets, pools, and transactions. The server exposes Vestige data in a structured, MCP-friendly format so your applications can display dashboards, run analytics, or trigger alerts based on real-time Vestige data.

How to install

# Prerequisites
node -v
# Ensure you have Node 23.6.1 or newer

# Create MCP servers directory structure for Claude or Cursor
mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

# Clone the Vestige MCP repository into the mcp-servers folder
cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

git clone https://github.com/GoPlausible/vestige-mcp.git
cd vestige-mcp

# Install dependencies and build
npm install
npm run build

# Configure environment variables in a .env file or inline in the MCP config

Next, add the server to your MCP config. Copy this exact snippet and adjust paths to your system. This snippet starts the server via Node and points to the built entry, with Vestige and Algorand configuration provided as environment variables.

{
  "mcpServers": {
    "vestige_mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js"
      ],
      "env": {
        "ALGORAND_NETWORK": "mainnet",
        "ALGORAND_ALGOD_API": "https://mainnet-api.algonode.cloud/v2",
        "ALGORAND_ALGOD": "https://mainnet-api.algonode.cloud",
        "ALGORAND_ALGOD_PORT": "",
        "ALGORAND_TOKEN": "",
        "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
        "VESTIGE_API_URL": "https://api.vestigelabs.org",
        "VESTIGE_API_KEY": "",
        "ITEMS_PER_PAGE": "10"
      }
    }
  }
}

Notes on macOS and path examples

{
  "mcpServers": {
    "vestige_mcp": {
      "command": "node",
      "args": [
        " /Users/YOUR_USERNAME/Library/Application Support/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js"
     ]
    }
  }
}

Development start

To run the server in development mode during iterations, navigate to the server package and start the dev flow. This spins up the TypeScript build in a running state so you can test endpoints and data exposure as you iterate on features.

Available tools

NetworkAnalytics

View network status, synchronization progress, and performance metrics to understand the health of the Vestige-enabled Algorand network.

ProtocolTracking

Access data for major DeFi protocols and track TVL, activity, and usage across Vestige-supported protocols.

AssetAnalytics

Retrieve asset data, price history, volume, liquidity, and market capitalization for assets in Vestige.

TradingData

Monitor real-time swaps, historical trades, price charts, and order book depth.

PoolAnalytics

Analyze liquidity pools, pool composition, and historical pool data.

VaultStatistics

Access vault metrics and related DeFi vault activity.

BalanceTracking

Track balances and balance changes across accounts and assets.

TransactionMonitoring

Monitor and query Vestige-related transactions and annotations.